Setup iOS

Su iOS, le passkey funzionano solo se l'app è associata allo stesso dominio relying-party del sito web.

Cosa gestisce il plugin

Dopo aver aggiunto la config del plugin ed eseguito bunx cap sync, il plugin applica le patch al progetto host iOS generato, così non dovrai più modificarlo manualmente:

• aggiunge il webcredentials: voci associated domains per i domini configurati
• fili CODE_SIGN_ENTITLEMENTS quando il target dell'app generato non punta già a un file entitlements

Cosa devi ancora ospitare

Devi pubblicare apple-app-site-association sul dominio relying-party:

https://signin.example.com/.well-known/apple-app-site-association

Esempio:

{
  "webcredentials": {
    "apps": ["ABCDE12345.app.capgo.passkey.example"]
  }
}

Checklist

1. Imposta origin e domains nella plugins.CapacitorPasskey nella capacitor.config.*.
2. Esegui bunx cap sync.
3. Conferma il tuo Apple Team ID e l'app bundle ID, quindi builda il TEAMID.bundleId valore per il file di associazione.
4. Ospita apple-app-site-association con HTTP 200 e senza .json estensione.
5. Assicurati che il relying-party ID usato dal tuo backend corrisponda al dominio associato.

Note

• Il file del sito web deve essere servito esattamente dal dominio passkey utilizzato come relying-party ID.
• Su iOS 17.4 e versioni successive, il plugin usa il client-data API in stile browser, così l'origin HTTPS configurato viene riflesso in clientDataJSON.
• Il plugin può patchare i file del progetto nativo durante la sync, ma non può creare o ospitare il file di associazione sul tuo dominio.

Continua da iOS Setup

Se stai usando Setup iOS per pianificare i flussi di autenticazione e account, collegandolo a Utilizzo di @capgo/capacitor-passkey per la funzionalità nativa in Utilizzo di @capgo/capacitor-passkey, @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per i dettagli sull'implementazione dell'autenticazione a due fattori.