KappS 지식 베이스 · FAQ

Google Play에서의 코드 난독화 및 역공학 방지

FAQ 보안

1. Google가 실제로 요구하는 것. Google의 가이드는 '비밀을 숨기려고 난독화하라'가 아니라 '리버스 엔지니어링 비용을 높이도록 축소·난독화하고, 실질적인 보안 검사는 서버에 두라'입니다. Android 빌드 문서(https://developer.android.com/build/shrink-code)는 R8을 Android Gradle 플러그인의 기본 코드 축소 도구로 설명합니다. R8은 트리 셰이킹, 리소스 축소, 최적화, 식별자 이름 변경(난독화)을 한 번에 수행하며, Google는 "난독화 자체는 보안 기능이 아니다"라고 분명히 밝힙니다. 즉, 우발적인 리버스 엔지니어링의 비용을 높일 뿐 클라이언트를 신뢰할 수 있게 만들지는 않습니다. 개발자 보안 가이드(https://developer.android.com/privacy-and-security/security-best-practices)도 같은 취지를 반대편에서 말합니다. 기기에서 읽을 수 있는 모든 것은 읽힐 수 있으므로 비밀, API 키, 서버 측 로직을 APK에 절대 넣지 말라는 것입니다.

2. 릴리스 빌드에서 R8을 켜세요. 앱 모듈의 build.gradle(.kts)에서 릴리스 빌드 유형에 minifyEnabled true(ProGuard와 호환되는 R8)와 shrinkResources true를 설정하고 proguard-rules.pro를 참조해야 합니다. 리소스 축소는 사용하지 않는 리소스를 제거하며 minifyEnabled가 함께 켜져 있을 때만 작동합니다. R8은 최적화된 기본 규칙 파일(proguard-android-optimize.txt)을 사용하므로 축소뿐 아니라 메서드 인라이닝, 클래스 병합, 미사용 인자 제거 같은 최적화도 적용합니다. 디버그와 릴리스 아티팩트 크기를 비교하고 build/outputs/mapping/release/mapping.txt를 확인해 효과를 검증하세요.

3. 릴리스 크래시 대부분은 keep 규칙에서 비롯됩니다. R8은 도달할 수 없다고 판단하는 모든 것을 이름 변경하거나 삭제합니다. 리플렉션으로 사용되는 것을 인식하지 못하는 타입도 마찬가지입니다. 흔한 원인은 JSON 파서(Gson/Moshi/Jackson 데이터 클래스), Retrofit 인터페이스와 그 @SerializedName 모델, Room 엔티티, kotlinx.serialization, ViewBinding/DataBinding, Parcelable, XML로 인플레이트되는 커스텀 뷰, 그리고 클래스 이름으로 로드되는 모든 것(Class.forName, JNI, 서비스 로더)입니다. 프로덕션에서 나타나는 증상은 NoSuchMethodException, ClassNotFoundException, 비어 있거나 이름이 바뀐 JSON 필드, 또는 디버그에서는 절대 발생하지 않고 릴리스에서만 발생하는 크래시입니다. 전부를 유지하는 -keep 대신 좁은 -keep 규칙(예: DTO용 -keep class com.example.model.** { *; }, @SerializedName 필드용 -keepclassmembers)을 추가하고, 디버그가 아닌 릴리스 빌드로 항상 테스트하세요. Kotlin은 흔히 -keepclassmembers class **$WhenMappings와 메타데이터 규칙이 필요하며, AndroidX는 R8이 자동으로 병합하는 자체 consumer 규칙을 제공합니다.

4. mapping.txt를 업로드해야 크래시 보고서를 읽을 수 있습니다. R8은 build/app/outputs/mapping/release/mapping.txt(및 configuration.txt, seeds.txt)를 생성합니다. 이 파일을 릴리스와 함께 Play Console에 업로드하거나 릴리스 파이프라인에서 업로드하도록 설정하면 Play Console이 스택 트레이스와 ANR을 자동으로 복원합니다. 이 파일이 없으면 모든 프로덕션 크래시가 a.a.a.b(Unknown Source)처럼 보여 트리아지를 할 수 없게 됩니다. 출시하는 모든 버전의 매핑을 보관하세요. 재빌드한 릴리스에는 새 매핑 파일이 필요합니다.

5. 보안 판단을 절대 클라이언트에 맡기지 마세요. 가장 흔한 설계 실수는 isPremium / LicenseValid / IsTampered 플래그를 앱이 로컬에서 판정하게 만드는 것입니다. 클라이언트가 결정하는 것은 무엇이든 패치할 수 있습니다. apktool로 1바이트만 바꾸거나 Frida 훅을 걸면 플래그가 뒤집힙니다. 판단은 백엔드로 옮기세요. 앱은 증거(토큰, 구매 토큰, 무결성 판정 결과)를 보내고 서버가 결정해야 합니다. 구체적으로는 기기 내 승인을 신뢰하지 말고 Play Developer API(purchases.subscriptionsv2 / purchases.products)로 Google Play Billing 구매를 서버 측에서 검증하며, 기기를 벗어나지 않는 '라이선스 검사'는 보호가 아닌 장식으로 취급하세요.

6. Play Integrity API는 서버 측 판정을 받는 공식 지원 방식입니다. Play Integrity API(https://developer.android.com/google/play/integrity)는 지원 종료된 SafetyNet Attestation API를 대체합니다. 앱이 이 API를 호출하면 암호화되고 서명된 단기 유효 무결성 판정을 받게 되며, 이 판정은 기기에서가 아니라 Google 서버(또는 Play Integrity API를 호출하는 자체 백엔드)에서 복호화하고 검증해야 합니다. 판정에는 기기 무결성 신호(MEETS_BASIC_INTEGRITY / MEETS_DEVICE_INTEGRITY / MEETS_STRONG_INTEGRITY), 앱 무결성 신호(바이너리가 업로드한 것과 일치하는지 확인하여 리패키징되거나 변조된 APK를 잡아냄), 계정·라이선스 신호(PLAY_RECOGNITION / LICENSED)가 담깁니다. 레거시 흐름인 Classic 요청 대신 Standard 요청(권장)을 사용하세요. Play Console의 앱 무결성 메뉴에서 앱에 맞게 API를 설정하고 판정 실패율을 확인할 수 있습니다. 판정 실패는 증거가 아니라 신호일 뿐입니다. Google는 기기 한 대의 실패만으로 판단하지 말라고 경고하므로 패턴과 비율 이상 징후를 살피고 정상 사용자를 차단해서는 안 됩니다. 일일 요청 한도는 설치 기반에 따라 늘어나며(기본 10,000건/일), 상향은 https://support.google.com/googleplay/android-developer/answer/11395166.에서 연결된 양식으로 요청합니다.

7. 서명, 변조 탐지, Play의 원클릭 보호. 두 가지 계층이 있습니다. (a) 앱 서명: 최신 앱은 APK 서명 방식 v2/v3(v4는 빠른 설치용)을 사용합니다. Play 앱 서명을 사용하면 Google이 앱 서명 키를 보관하고 귀하는 업로드 키를 유지하므로, 키스토어가 도난당해도 앱 탈취로 이어지지 않으며 업로드 키를 교체할 수 있습니다. 런타임에 앱 인증서를 예상 인증서와 비교할 수 있지만, 그 검사 자체도 패치될 수 있음을 기억하고 서버 측 신호로 활용하세요. (b) Google Play의 자동 보호('Protected with Play', https://support.google.com/googleplay/android-developer/answer/13857328)는 Play Console의 원클릭 스위치로, 런타임 변조 방지 및 불법 복제 탐지를 앱에 적용하고 설치된 바이너리가 스토어 버전과 일치하지 않을 때 보고합니다. 백엔드 연동이 필요 없습니다. 어느 하나에만 의존하지 말고 Play Integrity의 앱 무결성 판정과 함께 사용하세요.

8. 클라이언트를 강화하되, 결국 분석될 것이라 가정하십시오. 난독화를 넘어서: debuggable을 false로 유지하고 android:debuggable을 제거하십시오. 릴리스에서 로그를 제거하십시오(R8은 -assumenosideeffects로 Log.d를 제거하거나 로그 레벨을 높일 수 있습니다). API 키, 토큰, 엔드포인트를 하드코딩하지 말고 런타임에 가져와 교체하십시오. 기기 측 키는 임베딩하는 대신 Android Keystore(https://developer.android.com/privacy-and-security/keystore)에 저장하십시오. 인증서/공개 키 피닝을 추가해 가짜 서버나 MITM 프록시가 앱을 조종할 수 없게 하십시오. 루트/에뮬레이터/디버거 탐지는 소프트 신호로만 취급하십시오(간단히 우회되지만 비용을 높이고 평범한 스크립트는 막습니다). 고가치 문자열 상수(엔드포인트, 기능 플래그)는 자산 가치가 정당화될 때 R8 문자열 난독화나 상용 하드닝 도구로 난독화하거나 암호화하십시오. 그리고 민감한 로직은 빌드 복잡성을 감수할 때만 NDK/네이티브 코드로 옮기십시오. 네이티브는 리버싱이 더 어려울 뿐 불가능하지는 않습니다.

9. 정책 관점: 클론, 리패키징, 난독화의 한계. 자사 앱을 난독화하는 것은 정당하며 권장되는 일이지만, 난독화로 정책 위반 행위를 Google 심사에서 숨기는 것은 아닙니다. Google 개발자 프로그램 정책(https://support.google.com/googleplay/android-developer/answer/17190352)과 악성코드(https://support.google.com/googleplay/android-developer/answer/9888380), 모바일 원치 않는 소프트웨어(https://support.google.com/googleplay/android-developer/answer/9970222), 기만적 행위(https://support.google.com/googleplay/android-developer/answer/16680223) 정책은 기만적이거나 데이터 수집·기능을 은폐하거나 기기·네트워크·개인 데이터를 오용하는 앱을 금지합니다. 동작이 숨겨져야만 작동하는 앱은 심사를 통과하지 못하며, 출시 후 적발되면 삭제됩니다. 반대로 취약한 클라이언트 보호는 다른 이가 앱을 리패키징하거나 결제를 걷어내거나 클론하는 통로가 됩니다. 짝퉁 앱을 상대로 지식재산권 또는 악성코드 신고를 할 때 근거로 삼는 것도 바로 이 정책 문서들이며, Play의 사칭·모방 규정은 자사 정체성을 베낀 유사 앱에도 적용됩니다. 침해 또는 악성 클론은 Play Console 지식재산권 신고 양식과 정책 신고 경로로 신고하세요.

10. 출시 전 디컴파일 자체 감사(릴리스마다 한 번씩 수행). (1) 릴리스 AAB/APK를 빌드합니다. (2) 디버그가 아닌 릴리스 산출물에 apktool/JADX를 적용하고 디컴파일 결과를 읽습니다. 비즈니스 로직을 드러내는 읽을 수 있는 클래스/메서드 이름이 없고 평문 시크릿이 남아 있지 않은지 확인합니다. (3) APK에서 API 키, 엔드포인트, 'Bearer ', 'password', 'secret', 'http://', 디버그 플래그를 grep합니다(예: strings assets/* | grep -i key). (4) 루팅된 테스트 기기에서 Frida를 실행해 2분짜리 공격을 시도합니다. 라이선스/프리미엄 플래그 변조, 무결성 호출 후킹, 로컬 저장소 읽기이며, 성공하는 공격은 모두 서버 측으로 옮겨야 합니다. (5) 이 버전에 대해 mapping.txt가 생성되어 업로드되었는지 확인합니다. (6) Play Integrity 및/또는 Protected with Play가 활성화되어 있고 백엔드가 실제로 실패 판정을 거부하는지 확인합니다. 난독화가 유일한 통제 수단이라면 앱의 데이터와 프리미엄 로직은 공개된 것으로 간주해야 합니다.