Puoi trasmettere lo stato tramite un URL di continuazione quando invii azioni email per il ripristino della password o la verifica dell'email di un utente. In questo modo, l'utente può tornare all'app dopo aver completato l'azione. Inoltre, puoi specificare se gestire il link di azione email direttamente da un'applicazione mobile quando è installata anziché da una pagina web.
Questa opzione può essere estremamente utile nei seguenti scenari comuni:
Un utente che non ha eseguito l'accesso potrebbe tentare di accedere a contenuti che richiedono l'accesso. Tuttavia, l'utente potrebbe aver dimenticato la password e quindi attivare il flusso di reimpostazione della password. Al termine del flusso, l'utente si aspetta di tornare alla sezione dell'app a cui stava cercando di accedere.
Un'applicazione può offrire l'accesso solo agli account verificati. Ad esempio, una newsletter potrebbe richiedere all'utente di verificare la propria email prima di iscriversi. L'utente seguirà il flusso di verifica dell'email e si aspetta di tornare all'app per completare l'abbonamento.
In altri casi, l'utente potrebbe aver avviato il flusso dal proprio dispositivo mobile e si aspetta che dopo la verifica venga reindirizzato alla sua app mobile anziché al browser.
La possibilità di passare lo stato tramite un URL di continuazione è una funzionalità potente fornita da Firebase Auth che può migliorare significativamente l'esperienza utente.
Trasferimento dello stato di un URL di continuazione nelle azioni email
Per trasmettere in modo sicuro un URL di continuazione, il dominio dell'URL deve essere aggiunto come dominio autorizzato nella console Firebase. Aggiungi questo dominio alla sezione Autenticazione, all'elenco dei domini autorizzati nella scheda Metodo di accesso, se non è già presente.
È necessario fornire un'istanza di firebase.auth.ActionCodeSettings quando si invia
un'email di reimpostazione della password o un'email di verifica. Questa interfaccia accetta i
seguenti parametri:
| Parametro | Tipo | Descrizione |
|---|---|---|
url |
stringa | Imposta il link (URL di stato/continua) che ha significati diversi in contesti diversi:
|
iOS |
({bundleId: string}|undefined) | Imposta l'ID bundle iOS per aiutare Firebase Authentication a determinare se deve creare un link solo web o mobile che viene aperto su un dispositivo Apple |
android |
({packageName: string, installApp:boolean|undefined, minimumVersion: string|undefined}|undefined) | Imposta il nome del pacchetto Android per aiutare Firebase Authentication a determinare se deve creare un link solo web o mobile che viene aperto su un dispositivo Android |
handleCodeInApp |
(booleano|non definito) | Se il link dell'azione email verrà aperto prima in un'app mobile o in un link web. Il valore predefinito è false. Se impostato su true, il link del codice azione verrà inviato come link universale o app link per Android e verrà aperto dall'app, se installata. Nel caso di esito negativo, il codice verrà inviato prima al widget web e poi, se l'app è installata, verrà reindirizzato all'app. |
linkDomain |
(string|undefined) | Quando vengono definiti domini di link Hosting personalizzati per un progetto,
specifica quale utilizzare quando il link deve essere aperto da un'app mobile
specifica. In caso contrario, viene selezionato automaticamente il dominio predefinito (ad esempio,
PROJECT_ID.firebaseapp.com |
dynamicLinkDomain |
(string|undefined) | Deprecato. Non specificare questo parametro. |
Il seguente esempio illustra come inviare un link di verifica email che
si aprirà prima in un'app mobile utilizzando il dominio Hosting personalizzato
custom-domain.com. Il link diretto conterrà il payload dell'URL di continuazione
https://www.example.com/?email=user@example.com.
const actionCodeSettings = {
url: 'https://www.example.com/?email=' + firebase.auth().currentUser.email,
iOS: {
bundleId: 'com.example.ios'
},
android: {
packageName: 'com.example.android',
},
handleCodeInApp: true,
// Specify a custom Hosting link domain to use. The domain must be
// configured in Firebase Hosting and owned by the project.
linkDomain: "custom-domain.com"
};
firebase.auth().currentUser.sendEmailVerification(actionCodeSettings)
.then(function() {
// Verification email sent.
})
.catch(function(error) {
// Error occurred. Inspect error.code.
});
Configurazione dei link Firebase Hosting
Firebase Authentication utilizza Firebase Hosting quando invia un link che deve essere aperto in un'applicazione mobile. Per poter utilizzare questa funzionalità, i link di hosting devono essere configurati nella console Firebase.
Configurazione delle applicazioni Android:
- Se prevedi di gestire questi link dalla tua applicazione Android, il nome del pacchetto dell'app deve essere specificato nelle impostazioni del progetto della console Firebase. Inoltre, devono essere forniti SHA-1 e SHA-256 del certificato dell'applicazione.
- Devi anche configurare il filtro per intent per il link diretto nel
file
AndroidManifest.xml. - Per saperne di più, consulta le istruzioni per la ricezione dei link di hosting Android.
Configurazione delle applicazioni iOS:
- Se prevedi di gestire questi link dalla tua applicazione iOS, dovrai configurare il dominio del link Hosting come dominio associato nelle funzionalità dell'applicazione.
- Per saperne di più, consulta le istruzioni per la ricezione dei link di hosting iOS.
Gestione delle azioni email in un'applicazione web
Puoi specificare se vuoi gestire prima il link del codice azione da un'applicazione web e poi reindirizzare a un'altra pagina web o applicazione mobile dopo il completamento, a condizione che l'applicazione mobile sia disponibile.
A questo scopo, imposta handleCodeInApp su false nell'oggetto
firebase.auth.ActionCodeSettings. Sebbene non siano necessari un ID pacchetto iOS
o un nome del pacchetto Android, fornirli consentirà all'utente
di reindirizzare all'app specificata al completamento del codice di azione email.
L'URL web utilizzato qui è quello configurato nella sezione Modelli di azioni email. Ne viene eseguito il provisioning di uno predefinito per tutti i progetti. Per saperne di più su come personalizzare il gestore di azioni email, consulta Personalizzazione dei gestori email.
In questo caso, il link all'interno del parametro di query continueUrl sarà
un link di hosting il cui payload è URL specificato nell'oggetto ActionCodeSettings.
Quando gestisci azioni email come la verifica email, il codice azione del parametro di query oobCode deve essere analizzato dal link diretto e poi applicato tramite applyActionCode affinché la modifica abbia effetto, ovvero l'email da verificare.
Gestione delle azioni email in un'applicazione mobile
Puoi specificare se vuoi gestire il link del codice azione all'interno della tua
applicazione mobile, a condizione che sia installata. Se si fa clic sul link da un dispositivo che non supporta l'applicazione mobile, il link viene aperto da una pagina web. A questo scopo, imposta handleCodeInApp su true nell'oggetto
firebase.auth.ActionCodeSettings. Dovrai specificare anche il nome del pacchetto Android o l'ID bundle iOS dell'applicazione mobile.
L'URL web di riserva utilizzato qui, quando non è disponibile alcuna app mobile, è quello configurato nella sezione dei modelli di azioni email. Per tutti i progetti viene eseguito il provisioning di uno predefinito. Per saperne di più su come personalizzare il gestore di azioni email, consulta Personalizzazione dei gestori email.
In questo caso, il link all'app mobile inviato all'utente sarà un link Hosting
il cui payload è l'URL del codice azione, configurato nella console, con i parametri
della query oobCode, mode, apiKey e continueUrl. Quest'ultimo sarà l'URL originale specificato nell'oggetto ActionCodeSettings. Il codice azione può essere applicato direttamente da un'applicazione mobile in modo simile a come viene gestito dal flusso web descritto nella sezione Personalizzazione dei gestori email.
Quando gestisci azioni email come la verifica email, il codice azione del parametro di query oobCode deve essere analizzato dal link diretto e poi applicato tramite applyActionCode affinché la modifica abbia effetto, ovvero l'email da verificare.