Gestión de secretos y protección de claves de API en apps móviles: por qué una clave de API dentro de un APK es
1. La única pregunta que importa es qué claves pueden estar en el binario. La propia guía de seguridad de Google (Android) es clara en que esto no es cuestión de ofuscación: "Cuando se compila tu app y su código fuente incluye claves de API, un atacante puede descompilarla y encontrar estos recursos". Trata cada cadena del APK, y cada recurso o asset empaquetado en él, como publicado. Por tanto, las claves del lado del cliente solo pueden tener privilegios bajos, cuota limitada y alcance restringido: mapas, clima, fuentes de contenido de solo lectura, búsqueda pública. Todo lo que pueda mover dinero, leer registros de otro usuario, emitir reembolsos, enviar correo o cambiar el estado del servidor nunca se incluye en el cliente: vive detrás de tu propio endpoint que autentica al usuario. (§https://developer.android.com/privacy-and-security/security-tips)
2. La política de datos de usuario de Play nunca menciona las palabras «clave de API»: regula resultados, y por eso una clave filtrada es un problema de políticas y no solo de ingeniería. La política exige a los desarrolladores «tratar todos los datos personales y sensibles del usuario de forma segura, incluida su transmisión mediante criptografía moderna (por ejemplo, a través de HTTPS)» y «proteger todos los datos del usuario con medidas de seguridad adecuadas, incluida criptografía moderna para los datos en tránsito». Una clave codificada de forma fija no es en sí misma una infracción; una clave codificada de forma fija que permite a un atacante leer, escribir o exfiltrar datos del usuario sí es una infracción de la política de datos de usuario, con riesgo de retirada que se suma a la factura y a la notificación de brecha. §https://support.google.com/googleplay/android-developer/answer/10144311
3. Una restricción de clave no es autenticación, y la documentación de Google Cloud lo dice sin rodeos: "Una clave de API estándar no autentica a un principal"; asocia una solicitud a un proyecto para facturación y cuota. Las restricciones de aplicación (sitios web, direcciones IP, apps de Android, apps de iOS, un tipo a la vez) y las restricciones de API limitan el daño, no garantizan el secreto, y la restricción de apps de Android incluye una advertencia documentada: "Saltarse esta restricción es sencillo. Si usas esta restricción, también deberías añadir restricciones de API y supervisar el uso". La recomendación del mismo documento es configurar tanto restricciones de API como de aplicación y luego vigilar qué llama realmente la clave. §https://cloud.google.com/docs/authentication/api-keys
4. La lista de higiene que de verdad importa. Nunca subas claves al repositorio: la guía de Android apunta a plugins de Gradle como secrets-gradle-plugin en lugar de archivos versionados. Usa claves distintas para desarrollo, pruebas y producción, y una clave distinta por app, para poder desactivar una clave comprometida sin tumbar producción. Cuando quien llama es un servidor, restringe por IP. Cuando debas guardar un secreto en el dispositivo (tokens, material de refresco), guárdalo en el Keystore de Android y cífralo con una biblioteca auditada como Tink, no con una constante de cadena, un archivo de recursos ni SharedPreferences sin cifrar. Siempre HTTPS, y considera el certificate pinning como una capa extra, no como un sustituto. §https://developer.android.com/privacy-and-security/security-tips
5. La rotación es una tarea de calendario, no un reflejo que solo se activa ante un incidente. La guía de Android cita la ISO 27001 y afirma que "en la mayoría de los casos, un periodo de rotación de claves de entre 90 días y 6 meses debería ser adecuado"; la operación de rotación de Google Cloud crea una clave nueva con las mismas restricciones, y la clave antigua sigue funcionando hasta que la eliminas. Esa ventana de solapamiento es precisamente el punto: las instalaciones en campo se actualizan a lo largo de semanas, así que necesitas una ventana de migración con ambas claves válidas, luego deshabilitar y después eliminar. Mantén un inventario con el ID de la clave, el responsable, el paquete, los ámbitos y la fecha de rotación: un proyecto admite hasta 300 claves, margen más que suficiente para perder la cuenta. §https://cloud.google.com/docs/authentication/api-keys
6. La detección decide si una filtración es un martes cualquiera o un trimestre entero. Activa el registro de uso por clave y las alertas de cuota y facturación, y vigila las tres señales que importan: un pico de volumen desde un referente o una IP inesperados, una cuota agotada en horas en las que tus usuarios duermen y llamadas a endpoints que la app nunca invoca. Ante una exposición confirmada, trátala como un incidente con un orden fijo: crea la clave de reemplazo con restricciones idénticas, publica la actualización del cliente, observa cómo cae el tráfico de la clave antigua, revoca la clave antigua y después revisa los registros de acceso y la facturación de toda la ventana de exposición. Comprueba también que la declaración de Seguridad de los datos en Play Console siga coincidiendo con la realidad: «cifrado en tránsito» es una declaración sobre el comportamiento real en tiempo de ejecución, y una clave filtrada que degradó una ruta a texto plano hace que esa declaración sea falsa. §https://cloud.google.com/docs/authentication/api-keys