Getting Started

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-app-attest`
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/app-attest/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.

Installazione

Puoi utilizzare la nostra configurazione assistita da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

Installa il pacchetto
Fermata di sistema
```
bun add @capgo/capacitor-app-attest
```
Sincronizza progetti nativi
Finestra del terminale
```
bunx cap sync
```
Configura le richieste della piattaforma
- Completa Impostazione iOS per l'abilitazione della capacità App Attest e flusso di verifica backend.
- Completa Configurazione Android per lo standard di integrità Play e flusso di verifica backend.

Perché utilizzare questo plugin

Questo plugin fornisce un API cross-platform unico mentre mantiene la sicurezza della piattaforma nativa:

iOS: Apple App Attesto (DeviceCheck)
Android: Google Play Integrity Standard API
No custom client-side crypto scheme
Output normalizzato per controlli backend

Utilizzo

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

const support = await AppAttest.isSupported();
if (!support.isSupported) {
  throw new Error(`Attestation not supported on ${support.platform}`);
}

const prepared = await AppAttest.prepare();

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

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

console.log(registration.platform, registration.format, registration.token);
console.log(assertion.platform, assertion.format, assertion.token);

Forma di risposta unificata

createAttestation() e createAssertion() ritornare gli stessi campi chiave su iOS e Android:

Campo	Tipo	Description
`platform`	`'ios' \| 'android' \| 'web'`	Piattaforma nativa che ha prodotto il token
`format`	`AttestationFormat`	`apple-app-attest` or `google-play-integrity-standard`
`keyId`	`string`	Maniglia/chiamata utilizzata per l'attestazione
`token`	`string`	Token per verificare sul tuo backend

Requisito del backend

L'attestazione è utile solo quando viene verificata in server-side.

Non fidarsi mai del successo client-only.
Richiedi valori di sfida/payload una volta per tutte dal tuo backend.
Verifica token, protezione dell'identità dell'app e protezioni di replay nella logica del backend.

Usa le guide backend specifiche per la piattaforma:

Continua da qui: Inizia

Se stai utilizzando Getting Started per pianificare la sicurezza e la conformità, connettilo con Usa @capgo/capacitor-app-attest per la capacità nativa in Utilizzo di @capgo/capacitor-app-attest, Crittografia per il dettaglio di implementazione in Crittografia, Conformità per il dettaglio di implementazione in Conformità, Capgo Scanner di Sicurezza per il workflow del prodotto in Capgo Scanner di Sicurezza, e Capgo Sicurezza per il workflow del prodotto in Capgo Sicurezza.