Proteger Firebase AI Logic con App Check en Android
Configura App Check y comprueba que tu integración de IA no quede abierta al abuso.
Reducir el uso no autorizado de recursos de IA desde clientes que no pertenecen a tu aplicación.
Por qué es importante
Las llamadas de IA pueden consumir cuotas y generar costos. Firebase App Check ayuda a verificar que las solicitudes provienen de instancias legítimas de tu app, pero no reemplaza autenticación, reglas de autorización, límites ni monitoreo de consumo. El despliegue debe hacerse con un proceso controlado para no bloquear usuarios reales.
Requisitos
- Proyecto Firebase conectado con la app Android y Firebase AI Logic configurado.
- Acceso a Firebase Console y una firma de la aplicación para el proveedor de integridad correspondiente.
Trabaja en un proyecto de pruebas. Revisa las versiones y condiciones específicas de la documentación oficial, ya que las APIs y las políticas evolucionan.
Implementación
Identifica los servicios usados por la aplicación y…
Identifica los servicios usados por la aplicación y consulta el estado de App Check en Firebase Console. Revisa los requisitos y fechas aplicables a Firebase AI Logic.
Registra la aplicación Android en App Check. Configura…
Registra la aplicación Android en App Check. Configura Play Integrity u otro proveedor recomendado para tu entorno; nunca publiques secretos de servicio en la app.
Instala y configura el SDK de App Check…
Instala y configura el SDK de App Check antes de comenzar a enviar solicitudes de IA. En desarrollo utiliza un proveedor de depuración solo para pruebas.
Abre los paneles de métricas y compara solicitudes…
Abre los paneles de métricas y compara solicitudes verificadas y no verificadas. Comprueba una versión publicada en Play antes de activar la exigencia global.
Activa enforcement siguiendo el plan de lanzamiento y…
Activa enforcement siguiendo el plan de lanzamiento y confirma que las funciones de IA continúan respondiendo. Mantén un procedimiento de reversión.
Agrega límites de presupuesto, control de acceso y…
Agrega límites de presupuesto, control de acceso y registro de errores sin datos sensibles; App Check por sí solo no previene un uso excesivo legítimo.
Fragmento de referencia
// Esquema del flujo (no sustituye configuración Firebase)
// App inicia -> App Check obtiene token -> Firebase AI Logic
// -> proveedor de IA valida la solicitud -> respuesta
sealed interface EstadoIA {
data object Preparando : EstadoIA
data class Error(val mensaje: String) : EstadoIA
data class Exito(val texto: String) : EstadoIA
}Ejemplo educativo: cuando se indique, añade las importaciones, dependencias, claves de prueba o clases de tu proyecto. No se presenta como proyecto Android completo y compilado.
Ponlo a prueba
En una build de prueba, verifica tres escenarios: dispositivo permitido, entorno de depuración y un cliente no reconocido. Anota el resultado y revisa los paneles de App Check.
Lista de comprobación
- La implementación cumple el objetivo: reducir el uso no autorizado de recursos de ia desde clientes que no pertenecen a tu aplicación.
- El comportamiento se verificó con datos de prueba y se documentaron los casos de fallo.
- Los recursos, dependencias y políticas se comprobaron contra las referencias oficiales.
- No se registran datos sensibles ni se da por probada una mejora sin evidencia.
Errores habituales
- No activar enforcement sin revisar primero las métricas y los entornos antiguos.
- No compartir tokens de depuración ni agregarlos al repositorio.
- No confundir App Check con autenticación de usuarios o prevención total del abuso.
¿App Check protege completamente mi API de IA?
No; añade protección contra clientes no verificados, pero necesitas controles de consumo, seguridad y monitoreo.
Referencias para ampliar
Consulta las versiones, limitaciones y requisitos vigentes antes de integrar los ejemplos en producción.