모바일 앱의 비밀 관리 및 API 키 보호: APK 내부의 API 키가 위험한 이유
1. 핵심 질문은 어떤 키를 바이너리에 포함할 수 있는가입니다. Google의 Android 보안 지침은 이것이 난독화의 문제가 아니라고 분명히 밝힙니다. "앱이 컴파일될 때 앱의 소스 코드에 API 키가 포함되어 있으면, 공격자가 앱을 디컴파일하여 이러한 리소스를 찾아낼 수 있습니다." APK 내 모든 문자열과 APK에 포함된 모든 리소스 및 애셋은 공개된 것으로 간주해야 합니다. 따라서 클라이언트 측 키는 낮은 권한, 할당량 제한, 범위 제한이 적용된 것만 허용됩니다. 지도, 날씨, 읽기 전용 콘텐츠 피드, 공개 검색이 그 예입니다. 금전을 이동하거나, 다른 사용자의 기록을 조회하거나, 환불을 처리하거나, 메일을 발송하거나, 서버 상태를 변경할 수 있는 것은 절대 클라이언트에 포함하지 않으며, 사용자를 인증하는 자체 엔드포인트 뒤에 두어야 합니다. (§https://developer.android.com/privacy-and-security/security-tips)
2. Play의 사용자 데이터 정책에는 "API 키"라는 표현이 전혀 나오지 않습니다. 이 정책은 결과를 규율하기 때문에, 유출된 키는 단순한 엔지니어링 문제가 아니라 정책 문제입니다. 이 정책은 개발자에게 "현대적 암호화(예: HTTPS)를 사용한 전송을 포함해 모든 개인 및 민감한 사용자 데이터를 안전하게 처리"하고 "전송 중인 데이터에 현대적 암호화를 적용하는 등 적절한 보안 조치로 모든 사용자 데이터를 보호"할 것을 요구합니다. 키를 하드코딩하는 것 자체는 위반이 아닙니다. 하지만 하드코딩된 키로 공격자가 사용자 데이터를 읽거나 쓰거나 유출할 수 있다면 이는 사용자 데이터 정책 위반이며, 청구서와 유출 통지 위에 앱 삭제 위험까지 더해집니다. §https://support.google.com/googleplay/android-developer/answer/10144311
3. 키 제한은 인증이 아니며, Google Cloud 문서에도 분명히 나와 있습니다. "표준 API 키는 주체를 인증하지 않습니다" — 키는 요청을 결제 및 할당량 목적의 프로젝트와 연결할 뿐입니다. 애플리케이션 제한(웹사이트, IP 주소, Android 앱, iOS 앱 — 한 번에 한 유형)과 API 제한은 피해를 줄이기 위한 것이지 비밀 유지 수단이 아니며, Android 앱 제한에는 문서화된 주의 사항이 따릅니다. "이 제한은 우회하기가 간단합니다. 이 제한을 사용하는 경우 API 제한도 추가하고 사용량을 모니터링해야 합니다." 같은 문서의 권장 사항은 API 제한과 애플리케이션 제한을 모두 설정한 뒤 키가 실제로 호출하는 대상을 지켜보라는 것입니다. §https://cloud.google.com/docs/authentication/api-keys
4. 실질적인 무게를 지니는 위생 점검 목록입니다. 키를 저장소에 절대 커밋하지 마세요. Android의 가이드라인은 체크인된 파일 대신 secrets-gradle-plugin 같은 Gradle 플러그인을 사용하라고 권고합니다. 개발, 테스트, 프로덕션용 키를 각각 분리하고 앱별로도 키를 분리하면, 키가 유출되더라도 프로덕션을 중단시키지 않고 해당 키만 비활성화할 수 있습니다. 호출 주체가 서버라면 IP로 제한하세요. 기기에 시크릿(토큰, 갱신 자료)을 보관해야 한다면 문자열 상수나 애셋 파일, 일반 SharedPreferences 대신 Android 키스토어에 저장하고 Tink처럼 검증된 라이브러리로 암호화하세요. 항상 HTTPS를 사용하고, 인증서 피닝은 대체 수단이 아닌 추가 보호 계층으로 고려하세요. §https://developer.android.com/privacy-and-security/security-tips
5. 키 교체는 사고 발생 시에만 하는 반사적 대응이 아니라 일정에 포함해야 하는 항목입니다. Android의 가이드라인은 ISO 27001을 인용하며 "대부분의 경우 90일에서 6개월 사이의 키 교체 주기가 적절합니다"라고 명시하고 있습니다. Google Cloud의 교체 작업은 동일한 제한을 가진 새 키를 생성하며, 기존 키는 삭제할 때까지 계속 작동합니다. 이 중복 기간이 핵심입니다. 현장에 설치된 앱은 몇 주에 걸쳐 업데이트되므로, 두 키가 모두 유효한 마이그레이션 기간을 거친 뒤 비활성화하고 삭제해야 합니다. 키 ID, 소유자, 패키지, 범위, 교체 날짜의 목록을 관리하세요. 프로젝트당 최대 300개의 키를 보유할 수 있어 관리 소홀로 이어지기 충분합니다. §https://cloud.google.com/docs/authentication/api-keys
6. 탐지는 유출이 하루짜리 사건인지 분기짜리 사건인지를 결정합니다. 키별 사용량 로깅과 할당량/결제 알림을 켜고, 중요한 세 가지 패턴을 주시하세요. 예상치 못한 리퍼러나 IP에서의 트래픽 급증, 사용자가 잠든 시간대의 할당량 소진, 앱이 호출한 적 없는 엔드포인트에 대한 호출입니다. 유출이 확인되면 정해진 순서로 사고로 처리하세요. 동일한 제한을 적용한 대체 키를 생성하고, 클라이언트 업데이트를 배포하고, 이전 키 트래픽이 줄어드는지 확인한 뒤 이전 키를 폐기하고, 전체 유출 기간의 액세스 로그와 결제 명세서를 검토합니다. 또한 Play Console의 데이터 보안 신고가 여전히 실제와 일치하는지 확인하세요. "전송 중 암호화"는 실제 런타임 동작에 대한 신고이며, 유출된 키로 인해 일부 경로가 평문으로 다운그레이드되었다면 그 신고는 거짓이 됩니다. §https://cloud.google.com/docs/authentication/api-keys