인증 앱은 로그인 코드를
어떻게 만들까요?

에이전트에게 질문하기

앱에 표시되는 로그인 코드는 계속 바뀝니다. 무엇 때문에 바뀌는지 찾아 그 동작을 재현하려고 합니다.

다운로드한 APK를 분석하는 예시 프롬프트입니다. 먼저 REA의 Android 분석 환경을 설정하세요. APK와 분석 설정 받기 ↓

코드 생성기 사용해보기

앱은 시간을 30초 단위로 나눕니다. 시간 구간 번호와 계정 키를 결합해 코드를 생성합니다. 같은 키와 같은 시간 구간이면 같은 코드가 나옵니다.

REA로 코드 찾기

1. APK에서 클래스 3개로 좁히기

   에이전트 → REA

   inspect_android_package
   {"path": "aegis-v3.4.3.apk"}
   
   search_android_classes
   {"path": "aegis-v3.4.3.apk",
    "query": "Totp"}

   REA → 에이전트 · 결과 발췌

   Package: com.beemdevelopment.aegis
   Version: 3.4.3
   Classes: 3,077
   
   Three matches:
     otp.TotpInfo
     ui.views.TotpProgressBar
     importers.TotpAuthenticatorImporter

   TotpInfo은 계산 코드의 후보이며, 나머지 둘은 진행률 표시줄과 가져온 계정에 관련됩니다. TOTP는 시간 기반 일회용 비밀번호입니다.

2. 코드 생성기와 앱 화면 연결

   에이전트 → REA

   inspect_android_class
   {"path": "aegis-v3.4.3.apk",
    "class_name":
     "com.beemdevelopment.aegis.otp.TotpInfo"}
   
   trace_android_references
   {"path": "aegis-v3.4.3.apk",
    "class_name":
     "com.beemdevelopment.aegis.otp.OtpInfo",
    "method_name": "getOtp"}

   REA → 에이전트 · 메서드와 호출 함수

   TotpInfo methods:
     getOtp()      · overload 0
     getOtp(long)  · overload 1
   
   OtpInfo.getOtp callers:
     ui.views.EntryHolder.getOtp
     ui.MainActivity.copyEntryCode

   REA가 타임스탬프 오버로드를 식별하고 기본 메서드의 호출자를 찾습니다. 이어서 EntryHolder.getOtp을 살펴보면 화면에서 TotpInfo.getOtp(timestamp)을 호출하는 것을 확인할 수 있습니다.

요청의 입력 경로는 줄여 표시했습니다. 결과의 클래스 이름에서는 공통 접두사 com.beemdevelopment.aegis을 생략했습니다.

계산 읽기

REA는 시간 변환, 기본 설정, 생성 메서드를 반환합니다. 생성자는 간격을 30초, 자릿수를 6으로 정합니다. 타임스탬프 메서드는 초를 시간 구간 번호로 바꿉니다.

// TotpInfo defaults and clock
setPeriod(30);
getOtp(System.currentTimeMillis() / 1000);

// OtpInfo default algorithm and digits
this(bArr, "SHA1", 6);

// Block passed to the generator
(long) Math.floor(j / ((double) this._period))

// generateOTP → getHash
byte[] hash = getHash(bArr, str, j);

// getHash: account key + encoded block
Mac mac = Mac.getInstance(str);
mac.init(secretKeySpec);
return mac.doFinal(bArrArray);

// OTP.toString, case 0
this._code % ((int) Math.pow(10.0d, i))

// Keep leading zeroes
while (sb.length() < i) {
    sb.insert(0, "0");
}

// Group time into 30-second blocks
seconds = current_time_ms / 1000
block = floor(seconds / 30)

// Generate a number from the key and block
hash = HMAC_SHA1(account_key,
                 big_endian_8_bytes(block))
number = select_31_bits(hash)

// Format the default six-digit code
code = number % 1_000_000
code = pad_with_zeroes(code, 6)

분석한 여러 메서드에서 발췌했으며, 표시를 위해 줄바꿈을 적용했습니다. 오른쪽 패널은 설명을 위한 요약입니다. Aegis 코드의 라이선스는 GPL-3.0입니다.

public static OTP generateOTP(byte[] bArr, String str,
        int i, long j)
        throws NoSuchAlgorithmException, InvalidKeyException {
    byte[] hash = getHash(bArr, str, j);
    int i2 = hash[hash.length - 1] & 15;
    return new OTP(
        (hash[i2 + 3] & 255)
        | ((hash[i2] & 127) << 24)
        | ((hash[i2 + 1] & 255) << 16)
        | ((hash[i2 + 2] & 255) << 8), i, 0);
}

재구성 결과 검증

REA가 반환한 Java 메서드 일부를 작은 테스트 프로그램으로 묶었습니다. 시간 구간 경계와 0으로 시작하는 코드를 포함한 133개 테스트 사례에서 독립적으로 재구현한 결과와 출력이 일치했습니다.

생성기는 RFC 6238에 공개된 SHA-1 기준 사례 6개와도 일치합니다. 브라우저 구현을 이 사례들과 비교해 보세요:

기준 사례는 8자리를 사용합니다. 검사에서는 이에 대응하는 6자리 결과도 검증합니다.

검증에서는 추출한 Java 메서드와 새 데모를 실행합니다. Android APK 자체는 정적 분석으로 검사했습니다.

직접 APK 분석하기

macOS나 Linux에서 REA를 설정한 뒤, 이 두 파일을 같은 폴더에 다운로드하세요. Windows에서는 WSL 같은 Linux 환경을 사용하세요.

Android 분석에는 전체 JDK 17 이상이 필요합니다. JAVA_HOME 또는 PATH로 사용할 JDK를 선택하세요. 이 사례에서는 JDK 21을 사용했습니다.

REA에 분석 도구 파일을 지정하고 APK를 분석하세요:

REA_JADX_MCP_JAR="$PWD/jadx-headless-mcp-0.7.1-all.jar" \
npx rea-agents@latest inspect-android-package \
  ./aegis-v3.4.3.apk --format json --full-output

에이전트는 위 프롬프트로 REA CLI를 통해 분석을 이어갈 수 있습니다. MCP를 사용하려면 REA 서버 환경에 REA_JADX_MCP_JAR을 추가하고 다시 연결하세요.

다음 질문: 계정이 8자리 코드나 다른 시간 간격을 사용하면 어떻게 될까요?

출처

• Aegis 3.4.3 공식 릴리스 · 해당 소스 커밋 · GPL-3.0 라이선스
• RFC 6238 기준 사례 · 데모 테스트 데이터

2026년 10월 9일 REA 6.1.0으로 분석했습니다. 디컴파일 발췌문의 출처는 Aegis이며, 그림과 요약, 브라우저 재구현은 새로 만든 교육 자료입니다.