Google 致力于为黑人社区推动种族平等。查看具体举措

Stato di passaggio nelle azioni e-mail

Puoi passare lo stato tramite un URL continua quando invii azioni e-mail per la reimpostazione della password o verifichi l'e-mail di un utente. Ciò fornisce all'utente la possibilità di tornare all'app dopo che l'azione è stata completata. Inoltre, è possibile specificare se gestire il collegamento all'azione e-mail direttamente da un'applicazione mobile quando è installata anziché da una pagina web.

Questo può essere estremamente utile nei seguenti scenari comuni:

  • Un utente, attualmente non connesso, potrebbe tentare di accedere a contenuti che richiedono l'accesso dell'utente. Tuttavia, l'utente potrebbe aver dimenticato la password e quindi attivare il flusso di reimpostazione della password. Alla fine del flusso, l'utente si aspetta di tornare alla sezione dell'app a cui stava tentando di accedere.

  • Un'applicazione può offrire l'accesso solo ad account verificati. Ad esempio, un'app di newsletter potrebbe richiedere all'utente di verificare la propria posta elettronica prima di iscriversi. L'utente passerà attraverso il flusso di verifica della posta elettronica e si aspetterà di essere restituito all'app per completare l'abbonamento.

  • In generale, quando un utente avvia un flusso di reimpostazione della password o di verifica tramite posta elettronica su un'app iOS, si aspetta di completare il flusso all'interno dell'app; la possibilità di passare lo stato tramite l'URL continua lo rende possibile.

Avere la possibilità di passare lo stato tramite un URL continuo è una potente funzionalità fornita da Firebase Auth e che può migliorare significativamente l'esperienza dell'utente.

Passaggio dell'URL di stato/continua nelle azioni di posta elettronica

Per trasmettere in modo sicuro un URL di continuazione, il dominio per l'URL dovrà essere autorizzato nella console Firebase . Questa operazione viene eseguita nella sezione Autenticazione aggiungendo questo dominio all'elenco dei domini autorizzati nella scheda Metodo di accesso, se non è già presente.

Quando si invia un'e-mail di reimpostazione della password o un'e-mail di verifica, è necessario FIRActionCodeSettings un'istanza FIRActionCodeSettings . Questa interfaccia accetta i seguenti parametri:

Swift

Parametro genere Descrizione
URL Corda

Imposta il collegamento (stato/continua URL) che ha significati diversi in contesti diversi:

  • Quando il collegamento viene gestito nei widget delle azioni Web, questo è il collegamento diretto nel parametro di query continueUrl .
  • Quando il collegamento viene gestito direttamente nell'app, questo è il parametro di query continueUrl nel collegamento diretto del collegamento dinamico.
iOSBundleID Corda Imposta l'ID del pacchetto iOS. Questo proverà ad aprire il collegamento in un'app iOS se è installata. L'app iOS deve essere registrata nella Console. Se non viene fornito alcun ID bundle, il valore di questo campo viene impostato sull'ID bundle del bundle principale dell'app.
androidPackageName Corda Imposta il nome del pacchetto Android. Questo proverà ad aprire il collegamento in un'app Android se è installata.
androidInstallIfNotAvailable bool Specifica se installare l'app Android se il dispositivo la supporta e l'app non è già installata. Se questo campo viene fornito senza un nomepacchetto, viene generato un errore che spiega che il nomepacchetto deve essere fornito insieme a questo campo.
androidMinimumVersion Corda La versione minima dell'app supportata in questo flusso. Se viene specificato MinimumVersion ed è installata una versione precedente dell'app, l'utente viene indirizzato al Play Store per aggiornare l'app. L'app Android deve essere registrata nella Console.
handleCodeInApp bool Se il collegamento all'azione e-mail verrà aperto prima in un'app mobile o in un collegamento Web. L'impostazione predefinita è false. Se impostato su true, il collegamento al codice azione verrà inviato come collegamento universale o collegamento app Android e verrà aperto dall'app, se installata. Nel caso falso, il codice verrà inviato prima al widget web e poi su continue verrà reindirizzato all'app se installata.
dynamicLinkDomain Corda Imposta il dominio (o sottodominio) del collegamento dinamico da utilizzare per il collegamento corrente se deve essere aperto utilizzando Firebase Dynamic Links. Poiché è possibile configurare più domini di collegamento dinamico per progetto, questo campo offre la possibilità di sceglierne uno in modo esplicito. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato il primo dominio.

Obiettivo-C

Parametro genere Descrizione
URL NSString

Imposta il collegamento (stato/continua URL) che ha significati diversi in contesti diversi:

  • Quando il collegamento viene gestito nei widget delle azioni Web, questo è il collegamento diretto nel parametro di query continueUrl .
  • Quando il collegamento viene gestito direttamente nell'app, questo è il parametro di query continueUrl nel collegamento diretto del collegamento dinamico.
iOSBundleID NSString Imposta l'ID del pacchetto iOS. Questo proverà ad aprire il collegamento in un'app iOS se è installata. L'app iOS deve essere registrata nella Console.
androidPackageName NSString Imposta il nome del pacchetto Android. Questo proverà ad aprire il collegamento in un'app Android se è installata.
androidInstallIfNotAvailable BOOL specifica se installare l'app Android se il dispositivo la supporta e l'app non è già installata. Se questo campo viene fornito senza un nomepacchetto, viene generato un errore che spiega che il nomepacchetto deve essere fornito insieme a questo campo.
androidMinimumVersion NSString La versione minima dell'app supportata in questo flusso. Se viene specificato MinimumVersion ed è installata una versione precedente dell'app, l'utente viene indirizzato al Play Store per aggiornare l'app. L'app Android deve essere registrata nella Console.
handleCodeInApp BOOL Se il collegamento all'azione e-mail verrà aperto prima in un'app mobile o in un collegamento Web. L'impostazione predefinita è false. Se impostato su true, il collegamento al codice azione verrà inviato come collegamento universale o collegamento app Android e verrà aperto dall'app, se installata. Nel caso falso, il codice verrà inviato prima al widget web e poi su continue verrà reindirizzato all'app se installata.
dynamicLinkDomain NSString Imposta il dominio (o sottodominio) del collegamento dinamico da utilizzare per il collegamento corrente se deve essere aperto utilizzando Firebase Dynamic Links. Poiché è possibile configurare più domini di collegamento dinamico per progetto, questo campo offre la possibilità di sceglierne uno in modo esplicito. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato il primo dominio.

L'esempio seguente illustra come inviare un link di verifica e-mail che verrà aperto prima in un'app mobile come collegamento dinamico Firebase utilizzando il dominio di collegamento dinamico personalizzato example.page.link (app iOS com.example.ios o app Android com.example.android cui verrà installata l'app se non è già installata e la versione minima è 12 ). Il deep link conterrà il payload dell'URL continuo https://www.example.com/?email=user@example.com .

Swift


var actionCodeSettings =  ActionCodeSettings.init()
actionCodeSettings.canHandleInApp = true
let user = Auth.auth().currentUser()
actionCodeSettings.URL =
    String(format: "https://www.example.com/?email=%@", user.email)
actionCodeSettings.iOSbundleID = Bundle.main.bundleIdentifier!
actionCodeSettings.setAndroidPakageName("com.example.android",
                                         installIfNotAvailable:true,
                                         minumumVersion:"12")
// When multiple custom dynamic link domains are defined, specify which one to use.
actionCodeSettings.dynamicLinkDomain = "example.page.link"
user.sendEmailVerification(withActionCodeSettings:actionCodeSettings { error in
  if error {
    // Error occurred. Inspect error.code and handle error.
    return
  }
  // Email verification sent.
})

Obiettivo-C

 FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init];
 actionCodeSettings.handleCodeInApp = YES;
 FIRUser *user = [FIRAuth auth].currentUser;
 NSString *urlString =
     [NSString stringWithFormat:@"https://www.example.com/?email=%@", user.email];
 actionCodeSettings.URL = [NSURL URLWithString:urlString];
 actionCodeSettings.iOSBundleID = [NSBundle mainBundle].bundleIdentifier;
 // When multiple custom dynamic link domains are defined, specify which one to use.
 actionCodeSettings.dynamicLinkDomain = @"example.page.link";
 [actionCodeSettings setAndroidPackageName:@"com.example.android"
                     installIfNotAvailable:YES
                            minimumVersion:'12'];
 [user sendEmailVerificationWithActionCodeSettings:actionCodeSettings
                                        completion:^(NSError *_Nullable error) {
   if (error) {
     // Error occurred. Inspect error.code and handle error.
     return;
   }
   // Email verification sent.
 }];

Firebase Auth utilizza Firebase Dynamic Links quando invia un collegamento che deve essere aperto in un'applicazione mobile. Per utilizzare questa funzione, i collegamenti dinamici devono essere configurati nella console Firebase.

  1. Abilita collegamenti dinamici Firebase:

    1. Nella console Firebase , apri la sezione Collegamenti dinamici .
    2. Se non hai ancora accettato i termini di Dynamic Links e hai creato un dominio Dynamic Links, fallo ora.

      Se hai già creato un dominio Dynamic Links, prendine nota. Un dominio Dynamic Links in genere ha l'aspetto del seguente esempio:

      example.page.link

      Avrai bisogno di questo valore quando configuri la tua app iOS o Android per intercettare il collegamento in entrata.

  2. Configurazione delle applicazioni Android:

    1. Se prevedi di gestire questi collegamenti dalla tua applicazione Android, il nome del pacchetto Android deve essere specificato nelle impostazioni del progetto Firebase Console. Inoltre, è necessario fornire SHA-1 e SHA-256 del certificato dell'applicazione.
    2. Dovrai anche configurare il filtro intent per il deep link nel tuo file AndroidManifest.xml.
    3. Per ulteriori informazioni, fare riferimento alle istruzioni relative alla ricezione di collegamenti dinamici Android .
  3. Configurazione delle applicazioni iOS:

    1. Se prevedi di gestire questi link dalla tua applicazione iOS, l'ID bundle iOS deve essere specificato nelle impostazioni del progetto Firebase Console. Inoltre, è necessario specificare anche l'ID dell'App Store e l'ID del team di sviluppatori Apple.
    2. Sarà inoltre necessario configurare il dominio di collegamento universale FDL come dominio associato nelle funzionalità dell'applicazione.
    3. Se prevedi di distribuire la tua applicazione alle versioni iOS 8 e precedenti, dovrai impostare il tuo ID bundle iOS come schema personalizzato per gli URL in entrata.
    4. Per ulteriori informazioni su questo, fare riferimento a Ricezione di istruzioni di collegamenti dinamici iOS .

Gestire le azioni di posta elettronica in un'applicazione web

È possibile specificare se si desidera gestire prima il collegamento al codice azione da un'applicazione Web e quindi reindirizzare a un'altra pagina Web o applicazione mobile dopo il completamento con successo, a condizione che l'applicazione mobile sia disponibile. Questa operazione viene eseguita impostando handleCodeInApp su false FIRActionCodeSettings (Obj-C) o ActionCodeSettings (Swift). Sebbene non siano richiesti un ID bundle iOS o un nome pacchetto Android, fornirli consentirà all'utente di reindirizzare all'app specificata al completamento del codice azione e-mail.

L'URL web utilizzato qui è quello configurato nella sezione dei modelli di azione e-mail. Ne viene fornito uno predefinito per tutti i progetti. Fare riferimento a personalizzazione dei gestori di posta elettronica per ulteriori informazioni su come personalizzare il gestore di azioni di posta elettronica.

In questo caso, il collegamento all'interno del parametro di query continueURL sarà un collegamento FDL il cui payload è l' URL specificato nell'oggetto ActionCodeSettings . Sebbene tu possa intercettare e gestire il collegamento in entrata dalla tua app senza alcuna dipendenza aggiuntiva, ti consigliamo di utilizzare la libreria client FDL per analizzare il collegamento diretto per te.

Quando si gestiscono azioni e-mail come la verifica e-mail, il codice azione dal parametro query oobCode deve essere analizzato dal collegamento applyActionCode e quindi applicato tramite applyActionCode affinché la modifica abbia effetto, ovvero l'e-mail sia verificata.

Gestire le azioni e-mail in un'applicazione mobile

È possibile specificare se si desidera gestire prima il collegamento del codice azione all'interno dell'applicazione mobile, a condizione che sia installato. Con le applicazioni Android, hai anche la possibilità di specificare tramite androidInstallIfNotAvailable che l'app deve essere installata se il dispositivo la supporta e non è già installata. Se si fa clic sul collegamento da un dispositivo che non supporta l'applicazione mobile, viene invece aperto da una pagina Web. Questa operazione viene eseguita impostando handleCodeInApp su true FIRActionCodeSettings (Obj-C) o ActionCodeSettings (Swift). Sarà inoltre necessario specificare il nome del pacchetto Android dell'applicazione per dispositivi mobili o l'ID del pacchetto iOS. L'URL Web di fallback utilizzato qui, quando non è disponibile alcuna app per dispositivi mobili, è quello configurato nella sezione dei modelli di azione e-mail. Ne viene fornito uno predefinito per tutti i progetti. Fare riferimento a personalizzazione dei gestori di posta elettronica per ulteriori informazioni su come personalizzare il gestore di azioni di posta elettronica.

In questo caso, il collegamento dell'app mobile inviato all'utente sarà un collegamento FDL il cui payload è l'URL del codice azione, configurato nella Console, con i parametri di query oobCode , mode , apiKey e continueUrl . Quest'ultimo sarà l' URL originale specificato FIRActionCodeSettings (Obj-C) o ActionCodeSettings (Swift). Sebbene tu possa intercettare e gestire il collegamento in entrata dalla tua app senza alcuna dipendenza aggiuntiva, ti consigliamo di utilizzare la libreria client FDL per analizzare il collegamento diretto per te. 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 di posta elettronica .

Quando si gestiscono azioni e-mail come la verifica e-mail, il codice azione dal parametro query oobCode deve essere analizzato dal collegamento applyActionCode e quindi applicato tramite applyActionCode affinché la modifica abbia effetto, ovvero l'e-mail sia verificata.