Primeros pasos
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-device-integrity`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/device-integrity/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Instalación
Sección titulada “Instalación”Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsLuego usa el siguiente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-device-integrity` plugin in my project.Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:
-
Instala el paquete
Ventana de terminal bun add @capgo/capacitor-device-integrity -
Sincronizar proyectos nativos
Ventana de terminal bunx cap sync -
Configura los requisitos de la plataforma
- Android: establecer
plugins.DeviceIntegrity.cloudProjectNumberpara Play Integrity cuando uses las APIs de atestación. - iOS: habilita la capacidad App Attest en Xcode para las APIs de atestación.
- Android: establecer
Inicio rápido
Sección titulada “Inicio rápido”import { DeviceIntegrity } from '@capgo/capacitor-device-integrity';
const result = await DeviceIntegrity.getCapabilities();console.log(result);Ejemplo: getWidevineFingerprint
Sección titulada “Ejemplo: getWidevineFingerprint”import { DeviceIntegrity } from '@capgo/capacitor-device-integrity';
const capabilities = await DeviceIntegrity.getCapabilities();if (capabilities.widevine.fingerprintAvailable) { const result = await DeviceIntegrity.getWidevineFingerprint(); console.log(result);}Ejemplo: prepareAttestation
Sección titulada “Ejemplo: prepareAttestation”import { DeviceIntegrity } from '@capgo/capacitor-device-integrity';
const capabilities = await DeviceIntegrity.getCapabilities();const attestationSupported = capabilities.appAttest.supported || capabilities.playIntegrity.supported;
if (attestationSupported) { const result = await DeviceIntegrity.prepareAttestation(); console.log(result);}Errores comunes
Sección titulada “Errores comunes”- Sync nativo: ejecuta
npx cap synctras actualizar los plugins. - Fuente de verdad: confianza
src/definitions.tsen el repo de GitHub.
Por qué usar este plugin
Sección titulada “Por qué usar este plugin”Usa una API para recopilar señales de integridad durante el registro, el inicio de sesión o acciones de alto riesgo:
- Comprueba el soporte antes de llamar a las APIs nativas (
getCapabilities) - Genera huellas de dispositivos Android con Widevine (
getWidevineFingerprint) - Registra y verifica con App Attest o Play Integrity (
prepareAttestation,createAttestation,createAssertion) - Solicita tokens de DeviceCheck para iOS (
getDeviceCheckToken)
Los valores del cliente no son fiables hasta que tu backend verifica los tokens y aplica protección contra reutilización.
import { DeviceIntegrity } from '@capgo/capacitor-device-integrity';
const capabilities = await DeviceIntegrity.getCapabilities();console.log(capabilities.platform, capabilities.playIntegrity.supported);
if (capabilities.widevine.fingerprintAvailable) { const widevine = await DeviceIntegrity.getWidevineFingerprint(); console.log(widevine.fingerprint, widevine.securityLevel);}
const attestationSupported = capabilities.appAttest.supported || capabilities.playIntegrity.supported;
if (attestationSupported) { try { const prepared = await DeviceIntegrity.prepareAttestation();
const challengeResponse = await fetch( 'https://api.example.com/integrity/registration-challenge', ); if (!challengeResponse.ok) { throw new Error(`Challenge request failed with ${challengeResponse.status}`); } const challengeBody = await challengeResponse.json(); if (typeof challengeBody.challenge !== 'string' || challengeBody.challenge.length === 0) { throw new Error('Backend response missing challenge'); } const challenge = challengeBody.challenge;
const registration = await DeviceIntegrity.createAttestation({ keyId: prepared.keyId, challenge, });
const payloadResponse = await fetch( 'https://api.example.com/integrity/assertion-payload', ); if (!payloadResponse.ok) { throw new Error(`Payload request failed with ${payloadResponse.status}`); } const payloadBody = await payloadResponse.json(); if (typeof payloadBody.payload !== 'string' || payloadBody.payload.length === 0) { throw new Error('Backend response missing payload'); } const payload = payloadBody.payload;
const assertion = await DeviceIntegrity.createAssertion({ keyId: prepared.keyId, payload, });
console.log(registration.format, registration.token); console.log(assertion.format, assertion.token); } catch (error) { console.error('Attestation flow failed', error); }}
if (capabilities.deviceCheck.supported) { const deviceCheck = await DeviceIntegrity.getDeviceCheckToken(); console.log(deviceCheck.token);}Opciones de Widevine
Sección titulada “Opciones de Widevine”getWidevineFingerprint() acepta campos opcionales:
| Campo | Tipo | Descripción |
|---|---|---|
includeRawId | boolean | Si es true, incluye el ID de dispositivo Widevine en base64 (datos sensibles). |
hashSalt | string | Salt para fingerprint. Android usa el nombre del paquete de la app cuando se omite. |
Requisito del backend
Sección titulada “Requisito del backend”- Verifica los tokens de App Attest y Play Integrity en tu servidor.
- Trata los identificadores de Widevine como sensibles y declara su uso en tu política de privacidad.
- No uses valores de Widevine para publicidad o rastreo entre apps.
Continúa desde Getting Started
Sección titulada “Continúa desde Primeros pasos”Si estás usando Primeros pasos para planificar la seguridad y el cumplimiento, conéctalo con Uso de @capgo/capacitor-device-integrity para la capacidad nativa en Usando @capgo/capacitor-device-integrity, @capgo/capacitor-app-attest para flujos específicos de App Attest y Play Integrity, Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Compliance, y Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security.