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

에이전트에게 질문하기

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

다운로드한 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이며, 그림과 요약, 브라우저 재구현은 새로 만든 교육 자료입니다.