Saltar al contenido

@capgo/capacitor-app-attest

Atestación de dispositivos con Apple App Attest, Google Play Integrity y señales opcionales de Android Widevine.

Demuestra que las peticiones provienen de tu app auténtica antes de confiar en llamadas sensibles a API. prepare() y createAttestation() cubren los flujos de Apple App Attest, mientras que Play Integrity Standard y los métodos opcionales de Widevine fingerprint cubren Android. Guarda los key IDs de forma segura con los helpers integrados.

Casos de uso típicos: prevención de fraude, transacciones de alto valor y controles anti-tamper en endpoints de login o pagos.

PlataformaSoporteNotas
iOSSíClaves de App Attest, assertions y helper para DeviceCheck token
AndroidSíPlay Integrity Standard, huella digital Widevine opcional
WebFallbackFormato de attestation web cuando las APIs nativas no están disponibles
  • isSupported - Comprueba si la atestación nativa está disponible en este dispositivo.
  • prepare - Prepara el estado de atestación y devuelve el key handle para llamadas posteriores.
  • createAttestation - Crea un token de atestación de registro vinculado a un challenge emitido por el backend.
  • createAssertion - Crea un token de aserción de solicitud vinculado a un payload de solicitud.
MétodoDescripción
isSupportedComprueba si la atestación nativa está disponible en este dispositivo.
preparePrepara el estado de atestación y devuelve el identificador de clave utilizado en llamadas posteriores.
createAttestationCrea un token de atestación de registro vinculado a un desafío emitido por el backend.
createAssertionCrea un token de aserción de solicitud vinculado a un payload de solicitud.
storeKeyIdAlmacena/prepara un identificador de clave para reutilización.
getStoredKeyIdDevuelve el identificador de clave actualmente almacenado/preparado.
clearStoredKeyIdBorra los identificadores de clave almacenados/preparados.
generateKeyAlias legado de prepare().
attestKeyAlias legado de createAttestation().
generateAssertionAlias legado de createAssertion().

Esta referencia se sincroniza desde src/definitions.ts en capacitor-app-attest.

Si estás usando @capgo/capacitor-app-attest para planificar la seguridad y el cumplimiento, conéctalo con Uso de @capgo/capacitor-app-attest para la capacidad nativa en Uso de @capgo/capacitor-app-attest, Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, y Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security.