Impostazione iOS

Sui dispositivi iOS, le chiavi passkey funzionano solo quando l'app è associata al medesimo dominio di fiducia del sito web.

Cosa gestisce il plugin

Dopo aver aggiunto la configurazione del plugin e aver eseguito bunx cap sync, il plugin modifica il progetto host iOS generato in modo che non sia necessario continuare a modificarlo manualmente:

• aggiunge le webcredentials: entrata di dominio associato per i domini configurati
• filamenti CODE_SIGN_ENTITLEMENTS quando l'app generata non punta già su un file di entità

Cosa ancora devi ospitare

Devi pubblicare apple-app-site-association sulla domain del relying-party:

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

Esempio:

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

Elenco di controllo

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

Note

• Il file del sito web deve essere servito dal dominio passkey esatto che utilizzate come ID di terza parte.
• Sul iOS 17.4 e versioni successive, il plugin utilizza il client-data di tipo browser-style 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 vostro dominio.

Continua da iOS Setup

Se state utilizzando IOS Setup per pianificare l'autenticazione e le flussi di account, connettetelo con Utilizzando @capgo/capacitor-passkey per la capacità nativa in Utilizzando @capgo/capacitor-passkey, @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-login-social, @capgo/capacitor-chiave-pass, per i dettagli di implementazione in @capgo/capacitor-chiave-pass, @capgo/capacitor-biometria-nativa, per i dettagli di implementazione in @capgo/capacitor-biometria-nativa, e Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori.