Impostazione di iOS
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Sui dispositivi iOS, le chiavi passkey funzionano solo quando l'app è associata allo stesso dominio di dipendenza del sito web.
Cosa gestisce il plugin
Sezione intitolata “Cosa gestisce il plugin”Dopo aver aggiunto la configurazione del plugin e aver eseguito bunx cap syncil plugin aggiusta il progetto host iOS generato in modo che non debba essere modificato manualmente:
- aggiunge le voci di dominio associati per i domini configurati
webcredentials:collega - quando il target dell'app generata non punta già a un file di entità
CODE_SIGN_ENTITLEMENTSQuello che ancora deve essere ospitato
Sezione intitolata “Quello che ancora deve essere ospitato”
Deve pubblicaresu il dominio di terza parte: apple-app-site-association Copia nel portapenna
https://signin.example.com/.well-known/apple-app-site-associationCopia nel portapenna
{ "webcredentials": { "apps": ["ABCDE12345.app.capgo.passkey.example"] }}Elenco di controllo
Sezione intitolata “Elenco di controllo”- Impostazione
originedomainsinplugins.CapacitorPasskeyincapacitor.config.*. - Esegui
bunx cap sync. - Conferma il tuo ID di team Apple e l'ID del bundle dell'app, quindi costruisci il
TEAMID.bundleIdvalore per il file di associazione. - Host
apple-app-site-associationcon HTTP200e senza.jsonestensione. - Assicurati che l'ID del partner di fiducia utilizzato dal tuo backend corrisponda al dominio associato.
- Il file del sito web deve essere servito dal dominio passkey esatto che utilizzate come ID del partner di fiducia.
- Dal iOS 17.4 in poi, il plugin utilizza il client-data del browser di tipo API quindi l'origine HTTPS configurata viene riflessa in
clientDataJSON. - Il plugin può patch i file di progetto nativi durante la sincronizzazione, ma non può creare o ospitare il file di associazione del sito web sul tuo dominio.
Continua da iOS Setup
Sezione intitolata “Continua da iOS Setup”Se stai utilizzando iOS Setup per pianificare l'autenticazione e le flussi di account, connettilo con Utilizzo di @capgo/capacitor-passkey per la capacità nativa in Utilizzo di @capgo/capacitor-passkey @capgo/capacitor-social-login per il dettaglio di implementazione in @capgo/capacitor-social-login @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey @capgo/capacitor-native-biometric per il dettaglio di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per il dettaglio di implementazione in Autenticazione a due fattori.