Configuración de iOS y verificación de backend

Se utiliza el sistema nativo de iOS.

En iOS, este plugin utiliza App Attest de Apple desde el DeviceCheck framework.

Requisitos

• iOS 14+
• Se recomienda un dispositivo físico para flujos de validación reales
• Objetivo de Xcode con la capacidad de App Attest habilitada

Xcode setup

1. Abra su objetivo de aplicación iOS en Xcode.
2. Vaya a Identificación y capacidades.
3. Haga clic y agregar y agregar App Attest.

No se requieren permisos iOS personalizados en Info.plist flujo del cliente

flujo del cliente

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

y attestation.token and assertion.token Envíelos a su servidor. No los validen en la aplicación.

Sección titulada “flujo de servidor (iOS)”

Registration (createAttestation)

1. Backend crea uno de uso único challenge.
2. App llamadas createAttestation({ keyId, challenge }).
3. El servidor verifica la atestación de App Attest:
   • La cadena de certificados es válida y está anclada a Apple App Attest
   • identidad de la aplicación coincide con tu aplicación ("bundleId, equipo)
   • clientDataHash coincide SHA256(challenge)
4. Almacenar estado de la clave del dispositivo (keyId, clave pública y metadatos del verificador).

Solicitar protección (createAssertion)

1. Backend crea una solicitud única payload o ingresa el hash de solicitud canónico.
2. App llamadas createAssertion({ keyId, payload }).
3. El backend verifica la firma de la afirmación con el material de clave almacenado previamente.
4. Enforce replay protection and nonce TTL checks.

Esquema de 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

Contrato de pago mínimo de backend

Registration:

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

Declaración:

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

Continúa desde la configuración de iOS y la verificación del backend.

Si está utilizando Configuración de iOS y verificación de backend para planificar la seguridad y la conformidad, conecte con Usando @capgo/capacitor-app-attest para la capacidad nativa en Usando @capgo/capacitor-app-attest, Encriptación para el detalle de implementación en Encriptación, Conformidad para los detalles de implementación en Compliance Capgo Escáner de Seguridad para el flujo de trabajo del producto en Capgo Escáner de Seguridad, y Capgo Seguridad para el flujo de trabajo del producto en Capgo Seguridad.