Saltar al contenido

Primeros pasos

GitHub

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:

Ventana de terminal
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego 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:

  1. Instala el paquete

    Ventana de terminal
    bun add @capgo/capacitor-device-integrity
  2. Sincronizar proyectos nativos

    Ventana de terminal
    bunx cap sync
  3. Configura los requisitos de la plataforma

    • Android: establecer plugins.DeviceIntegrity.cloudProjectNumber para Play Integrity cuando uses las APIs de atestación.
    • iOS: habilita la capacidad App Attest en Xcode para las APIs de atestación.
import { DeviceIntegrity } from '@capgo/capacitor-device-integrity';
const result = await DeviceIntegrity.getCapabilities();
console.log(result);
import { DeviceIntegrity } from '@capgo/capacitor-device-integrity';
const capabilities = await DeviceIntegrity.getCapabilities();
if (capabilities.widevine.fingerprintAvailable) {
const result = await DeviceIntegrity.getWidevineFingerprint();
console.log(result);
}
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);
}
  • Sync nativo: ejecuta npx cap sync tras actualizar los plugins.
  • Fuente de verdad: confianza src/definitions.ts en el repo de GitHub.

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);
}

getWidevineFingerprint() acepta campos opcionales:

CampoTipoDescripción
includeRawIdbooleanSi es true, incluye el ID de dispositivo Widevine en base64 (datos sensibles).
hashSaltstringSalt para fingerprint. Android usa el nombre del paquete de la app cuando se omite.
  • 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.

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.