Installation iOS & Vérification de l'arrière-plan

Utilise le système natif iOS

Sur iOS, ce plugin utilise L'App Attest d'Apple à partir de DeviceCheck le framework.

Exigences

• iOS 14+
• Un appareil physique est recommandé pour les flux de validation réels
• Cible Xcode avec la capacité App Attest activée

Configuration Xcode

1. Ouvrez votre cible d'application iOS dans Xcode.
2. Allez à Signature et capacités.
3. Cliquez sur + Capacité et ajoutez App Attest.

contexte : Produit/Politique commerciale d'entreprise. Rôle : Étiquette de l'IU courte ou élément de navigation. Voir : page enterprise.astro. Clé de message `enterprise_plugins_capgo_app_attest` (Enterprise Plugins Capgo App Attest). Info.plist Aucune permission iOS personnalisée n'est requise dans

pour App Attest elle-même.

import { AppAttest } from '@capgo/capacitor-app-attest';

const { keyId } = await AppAttest.prepare();

const attestation = await AppAttest.createAttestation({
  keyId,
  challenge: 'backend-registration-challenge',
});

const assertion = await AppAttest.createAssertion({
  keyId,
  payload: 'backend-request-payload',
});

Copier dans le presse-papiers attestation.token Envoyer assertion.token et

contexte : Site Web de marketing Capgo. Rôle : Étiquette de l'IU courte ou élément de navigation. Voir : page trust.astro. Clé de message `and` (Et).

Enregistrement (createAttestation)

1. Le serveur crée une attestation temporaire challenge.
2. L'application appelle createAttestation({ keyId, challenge }).
3. Le serveur vérifie l'attestation App Attest de l'application :
   • La chaîne de certificats est valide et ancrée à Apple App Attest
   • L'identité de l'application correspond à votre application (bundleIdéquipe)
   • clientDataHash correspond SHA256(challenge)
4. État de la clé de magasin du dispositif (keyIdclé publique, et métadonnées de vérificateur).

Demander une protection (createAssertion)

1. Le serveur backend crée une demande temporaire payload (ou une entrée de hachage de requête canonique).
2. L'application appelle createAssertion({ keyId, payload }).
3. Le serveur backend vérifie la signature de l'assertion avec le matériel de clé stocké précédemment.
4. Appliquer une protection contre la reprise et des vérifications de TTL pour le nonce.

Schéma iOS

sequenceDiagram
  participant App as iOS App
  participant Plugin as AppAttest plugin
  participant Apple as Apple App Attest
  participant BE as Backend

  BE->>App: one-time challenge
  App->>Plugin: prepare()
  Plugin->>Apple: generateKey()
  Apple-->>Plugin: keyId

  App->>Plugin: createAttestation(keyId, challenge)
  Plugin->>Apple: attestKey(keyId, SHA256(challenge))
  Apple-->>Plugin: attestation token
  Plugin-->>App: token + platform + format + keyId
  App->>BE: token + challenge + keyId
  BE->>BE: verify Apple attestation rules

  BE->>App: one-time payload
  App->>Plugin: createAssertion(keyId, payload)
  Plugin->>Apple: generateAssertion(keyId, SHA256(payload))
  Apple-->>Plugin: assertion token
  Plugin-->>App: token + platform + format + keyId
  App->>BE: token + payload + keyId
  BE->>BE: verify signature + replay policy

Contrat de paiement de backend minimal

Enregistrement :

{
  "platform": "ios",
  "format": "apple-app-attest",
  "keyId": "string",
  "challenge": "string",
  "token": "string"
}

Affirmation :

{
  "platform": "ios",
  "format": "apple-app-attest",
  "keyId": "string",
  "payload": "string",
  "token": "string"
}

Continuer de la configuration iOS & de la vérification du backend

Si vous utilisez la configuration iOS & la vérification du backend pour planifier la sécurité et la conformité, connectez-l’avec En utilisant @capgo/capacitor-app-attest pour la capacité native dans En utilisant @capgo/capacitor-app-attest la cryptage pour le détail d'implémentation dans la cryptage Conformité pour le détail d'implémentation dans Conformité, Capgo Scanner de sécurité pour le flux de travail du produit dans Capgo Scanner de sécurité, et Capgo Sécurité pour le flux de travail du produit dans Capgo Sécurité.