Aller au contenu

Prise en main

GitHub

Vous pouvez utiliser notre configuration assistée par IA pour installer le plugin. Ajoutez les skills Capgo à votre outil d'IA avec la commande suivante :

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

Utilisez ensuite le prompt suivant :

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-device-integrity` plugin in my project.

Si vous préférez une installation manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à chaque plateforme ci-dessous :

  1. Installer le package

    Fenêtre de terminal
    bun add @capgo/capacitor-device-integrity
  2. Synchroniser les projets natifs

    Fenêtre de terminal
    bunx cap sync
  3. Configurer les prérequis de la plateforme

    • Android : définir plugins.DeviceIntegrity.cloudProjectNumber pour Play Integrity lorsque vous utilisez les API d’attestation.
    • iOS : activer la capacité App Attest dans Xcode pour les API d’attestation.
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 native : exécuter npx cap sync après les mises à jour du plugin.
  • Source de vérité : fiez-vous src/definitions.ts au repo GitHub.

Utilisez un API pour collecter des signaux d'intégrité lors de l'inscription, de la connexion ou d'actions à haut risque :

  • Vérifiez la compatibilité avant d'appeler les API natives (getCapabilities)
  • Identifiez les appareils Android avec Widevine (getWidevineFingerprint)
  • Enregistrez et effectuez des assertions avec App Attest ou Play Integrity (prepareAttestation, createAttestation, createAssertion)
  • Demandez des tokens iOS DeviceCheck (getDeviceCheckToken)

Les valeurs client ne sont pas fiables tant que votre backend n'a pas vérifié les tokens et appliqué une protection contre le replay.

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() accepte des champs facultatifs :

ChampTypeDescription
includeRawIdbooleanSi true, inclut l’ID d’appareil Widevine brut en base64 (sensible).
hashSaltstringSel pour fingerprint. Sur Android, le nom du package de l’app est utilisé s’il est omis.
  • Vérifiez les tokens App Attest et Play Integrity sur votre serveur.
  • Traitez les identifiants Widevine comme sensibles et déclarez leur utilisation dans votre politique de confidentialité.
  • N'utilisez pas les valeurs Widevine pour la publicité ou le suivi inter-applications.

Si vous utilisez Prise en main pour planifier la sécurité et la conformité, connectez-l’à Utiliser @capgo/capacitor-device-integrity pour la capacité native dans la section « Utiliser @capgo/capacitor-device-integrity », @capgo/capacitor-app-attest pour des flux App Attest et Play Integrity ciblés, Chiffrement pour les détails d'implémentation du chiffrement, Conformité pour les détails d'implémentation dans Compliance, et Capgo et la sécurité pour le workflow produit dans Capgo Security.