Questa pagina è stata tradotta dall'API Cloud Translation.

Crea gestori di azioni email personalizzate

Alcune azioni di gestione degli utenti, come l'aggiornamento dell'indirizzo email di un utente e la reimpostazione della password, comportano l'invio di email all'utente. Questi Le email contengono link che i destinatari possono aprire per completare o annullare l'utente un'azione di gestione. Per impostazione predefinita, le email di gestione utenti si collegano all'azione predefinita , ovvero una pagina web ospitata su un URL in Firebase Hosting del tuo progetto dominio.

In alternativa, puoi creare e ospitare un gestore delle azioni email personalizzato per eseguire un'elaborazione personalizzata e integrare il gestore delle azioni email con il tuo sito web.

Le seguenti azioni di gestione utenti richiedono all'utente di completare l'azione utilizzando un gestore di azioni email:

Reimpostazione delle password
Revoca delle modifiche all'indirizzo email, quando gli utenti cambiano l'account principale indirizzi email, Firebase invia un'email ai loro indirizzi precedenti che consentono per annullare la modifica
Verifica degli indirizzi email

Per personalizzare il gestore dell'azione email del tuo progetto Firebase, devi creare e ospitare una pagina web che utilizzi l'SDK JavaScript di Firebase per verificare la validità della richiesta e completarla. Poi devi personalizzare Firebase i modelli email del tuo progetto per collegarti al tuo gestore delle azioni personalizzate.

Crea la pagina Gestore delle azioni email

Firebase aggiunge diversi parametri di query all'URL del gestore dell'azione quando genera email di gestione degli utenti. Ad esempio:

https://example.com/usermgmt?mode=resetPassword&oobCode=ABC123&apiKey=AIzaSy...&lang=fr

Questi parametri specificano l'attività di gestione utenti svolta dall'utente. completamento. La pagina del gestore delle azioni email deve gestire la seguente query parametri:

Parametri
modalità	L'azione di gestione utenti da completare. Può essere uno dei seguenti valori: `resetPassword` `recoverEmail` `verifyEmail`
oobCode	Un codice monouso, utilizzato per identificare e verificare una richiesta
apiKey	Chiave API del progetto Firebase, fornita per praticità
URLcontinua	Si tratta di un URL facoltativo che consente di ritrasmettere lo stato l'app tramite un URL. È pertinente per la reimpostazione della password e le email modalità di verifica. Quando invii un'email di reimpostazione della password o un'email di verifica, è necessario specificare un oggetto `ActionCodeSettings` con un URL di continuazione affinché sia disponibile. In questo modo, un utente può continuare esattamente da dove aveva interrotto dopo un'azione via email.
Lang	Questo è l'attributo BCP47 language tag che rappresenta le impostazioni internazionali dell'utente (ad esempio, `fr`). Puoi utilizzare questo valore per fornire indirizzi email localizzati pagine dei gestori di azioni per gli utenti. La localizzazione può essere impostata tramite la console Firebase o in modo dinamico chiamando l'API client corrispondente prima di attivare l'email un'azione. Ad esempio, utilizzando JavaScript: `firebase.auth().languageCode = 'fr';`. Per un'esperienza utente coerente, assicurati che il gestore delle azioni email corrisponde a quella del modello email.

L'esempio seguente mostra come gestire i parametri di query in un basato su browser. Puoi anche implementare il gestore come applicazione Node.js utilizzando una logica simile.

Web

import { initializeApp } from "firebase/app";
import { getAuth } from "firebase/auth";

document.addEventListener('DOMContentLoaded', () => {
  // TODO: Implement getParameterByName()

  // Get the action to complete.
  const mode = getParameterByName('mode');
  // Get the one-time code from the query parameter.
  const actionCode = getParameterByName('oobCode');
  // (Optional) Get the continue URL from the query parameter if available.
  const continueUrl = getParameterByName('continueUrl');
  // (Optional) Get the language code if available.
  const lang = getParameterByName('lang') || 'en';

  // Configure the Firebase SDK.
  // This is the minimum configuration required for the API to be used.
  const config = {
    'apiKey': "YOUR_API_KEY" // Copy this key from the web initialization
                             // snippet found in the Firebase console.
  };
  const app = initializeApp(config);
  const auth = getAuth(app);

  // Handle the user management action.
  switch (mode) {
    case 'resetPassword':
      // Display reset password handler and UI.
      handleResetPassword(auth, actionCode, continueUrl, lang);
      break;
    case 'recoverEmail':
      // Display email recovery handler and UI.
      handleRecoverEmail(auth, actionCode, lang);
      break;
    case 'verifyEmail':
      // Display email verification handler and UI.
      handleVerifyEmail(auth, actionCode, continueUrl, lang);
      break;
    default:
      // Error: invalid mode.
  }
}, false);auth_handle_mgmt_query_params.js

Web

document.addEventListener('DOMContentLoaded', () => {
  // TODO: Implement getParameterByName()

  // Get the action to complete.
  var mode = getParameterByName('mode');
  // Get the one-time code from the query parameter.
  var actionCode = getParameterByName('oobCode');
  // (Optional) Get the continue URL from the query parameter if available.
  var continueUrl = getParameterByName('continueUrl');
  // (Optional) Get the language code if available.
  var lang = getParameterByName('lang') || 'en';

  // Configure the Firebase SDK.
  // This is the minimum configuration required for the API to be used.
  var config = {
    'apiKey': "YOU_API_KEY" // Copy this key from the web initialization
                            // snippet found in the Firebase console.
  };
  var app = firebase.initializeApp(config);
  var auth = app.auth();

  // Handle the user management action.
  switch (mode) {
    case 'resetPassword':
      // Display reset password handler and UI.
      handleResetPassword(auth, actionCode, continueUrl, lang);
      break;
    case 'recoverEmail':
      // Display email recovery handler and UI.
      handleRecoverEmail(auth, actionCode, lang);
      break;
    case 'verifyEmail':
      // Display email verification handler and UI.
      handleVerifyEmail(auth, actionCode, continueUrl, lang);
      break;
    default:
      // Error: invalid mode.
  }
}, false);custom-email-handler.js

Gestisci le richieste di reimpostazione della password verificando prima il codice di azione con verifyPasswordResetCode; quindi ottenere una nuova password dall'utente e trasmetterla a confirmPasswordReset. Ad esempio:

Web

import { verifyPasswordResetCode, confirmPasswordReset } from "firebase/auth";

function handleResetPassword(auth, actionCode, continueUrl, lang) {
  // Localize the UI to the selected language as determined by the lang
  // parameter.

  // Verify the password reset code is valid.
  verifyPasswordResetCode(auth, actionCode).then((email) => {
    const accountEmail = email;

    // TODO: Show the reset screen with the user's email and ask the user for
    // the new password.
    const newPassword = "...";

    // Save the new password.
    confirmPasswordReset(auth, actionCode, newPassword).then((resp) => {
      // Password reset has been confirmed and new password updated.

      // TODO: Display a link back to the app, or sign-in the user directly
      // if the page belongs to the same domain as the app:
      // auth.signInWithEmailAndPassword(accountEmail, newPassword);

      // TODO: If a continue URL is available, display a button which on
      // click redirects the user back to the app via continueUrl with
      // additional state determined from that URL's parameters.
    }).catch((error) => {
      // Error occurred during confirmation. The code might have expired or the
      // password is too weak.
    });
  }).catch((error) => {
    // Invalid or expired action code. Ask user to try to reset the password
    // again.
  });
}auth_handle_reset_password.js

Web

function handleResetPassword(auth, actionCode, continueUrl, lang) {
  // Localize the UI to the selected language as determined by the lang
  // parameter.

  // Verify the password reset code is valid.
  auth.verifyPasswordResetCode(actionCode).then((email) => {
    var accountEmail = email;

    // TODO: Show the reset screen with the user's email and ask the user for
    // the new password.
    var newPassword = "...";

    // Save the new password.
    auth.confirmPasswordReset(actionCode, newPassword).then((resp) => {
      // Password reset has been confirmed and new password updated.

      // TODO: Display a link back to the app, or sign-in the user directly
      // if the page belongs to the same domain as the app:
      // auth.signInWithEmailAndPassword(accountEmail, newPassword);

      // TODO: If a continue URL is available, display a button which on
      // click redirects the user back to the app via continueUrl with
      // additional state determined from that URL's parameters.
    }).catch((error) => {
      // Error occurred during confirmation. The code might have expired or the
      // password is too weak.
    });
  }).catch((error) => {
    // Invalid or expired action code. Ask user to try to reset the password
    // again.
  });
}custom-email-handler.js

Gestisci le revoche della modifica dell'indirizzo email verificando prima il codice di azione con checkActionCode, quindi ripristina l'indirizzo email dell'utente con applyActionCode. Ad esempio:

Web

import { checkActionCode, applyActionCode, sendPasswordResetEmail } from "firebase/auth";

function handleRecoverEmail(auth, actionCode, lang) {
  // Localize the UI to the selected language as determined by the lang
  // parameter.
  let restoredEmail = null;
  // Confirm the action code is valid.
  checkActionCode(auth, actionCode).then((info) => {
    // Get the restored email address.
    restoredEmail = info['data']['email'];

    // Revert to the old email.
    return applyActionCode(auth, actionCode);
  }).then(() => {
    // Account email reverted to restoredEmail

    // TODO: Display a confirmation message to the user.

    // You might also want to give the user the option to reset their password
    // in case the account was compromised:
    sendPasswordResetEmail(auth, restoredEmail).then(() => {
      // Password reset confirmation sent. Ask user to check their email.
    }).catch((error) => {
      // Error encountered while sending password reset code.
    });
  }).catch((error) => {
    // Invalid code.
  });
}auth_handle_recover_email.js

Web

function handleRecoverEmail(auth, actionCode, lang) {
  // Localize the UI to the selected language as determined by the lang
  // parameter.
  var restoredEmail = null;
  // Confirm the action code is valid.
  auth.checkActionCode(actionCode).then((info) => {
    // Get the restored email address.
    restoredEmail = info['data']['email'];

    // Revert to the old email.
    return auth.applyActionCode(actionCode);
  }).then(() => {
    // Account email reverted to restoredEmail

    // TODO: Display a confirmation message to the user.

    // You might also want to give the user the option to reset their password
    // in case the account was compromised:
    auth.sendPasswordResetEmail(restoredEmail).then(() => {
      // Password reset confirmation sent. Ask user to check their email.
    }).catch((error) => {
      // Error encountered while sending password reset code.
    });
  }).catch((error) => {
    // Invalid code.
  });
}custom-email-handler.js

Per gestire la verifica dell'indirizzo email, chiama il numero applyActionCode. Ad esempio:

Web

function handleVerifyEmail(auth, actionCode, continueUrl, lang) {
  // Localize the UI to the selected language as determined by the lang
  // parameter.
  // Try to apply the email verification code.
  applyActionCode(auth, actionCode).then((resp) => {
    // Email address has been verified.

    // TODO: Display a confirmation message to the user.
    // You could also provide the user with a link back to the app.

    // TODO: If a continue URL is available, display a button which on
    // click redirects the user back to the app via continueUrl with
    // additional state determined from that URL's parameters.
  }).catch((error) => {
    // Code is invalid or expired. Ask the user to verify their email address
    // again.
  });
}auth_handle_verify_email.js

Web

function handleVerifyEmail(auth, actionCode, continueUrl, lang) {
  // Localize the UI to the selected language as determined by the lang
  // parameter.
  // Try to apply the email verification code.
  auth.applyActionCode(actionCode).then((resp) => {
    // Email address has been verified.

    // TODO: Display a confirmation message to the user.
    // You could also provide the user with a link back to the app.

    // TODO: If a continue URL is available, display a button which on
    // click redirects the user back to the app via continueUrl with
    // additional state determined from that URL's parameters.
  }).catch((error) => {
    // Code is invalid or expired. Ask the user to verify their email address
    // again.
  });
}custom-email-handler.js

Ospita la pagina da qualche parte, ad esempio utilizza Firebase Hosting.

Il passaggio successivo consiste nel configurare il progetto Firebase per il collegamento all'indirizzo email personalizzato gestore di azioni nelle email di gestione degli utenti.

Link al gestore personalizzato nei modelli email

Per configurare il progetto Firebase in modo che utilizzi il gestore delle azioni email personalizzate:

Apri il progetto nella console Firebase.
Vai alla pagina Modelli email nella sezione Auth.
In una delle voci Tipi di email, fai clic sull'icona a forma di matita per modificare modello email.
Fai clic su personalizza l'URL di azione e specifica l'URL del gestore dell'azione email personalizzata.

Dopo aver salvato, l'URL verrà utilizzato da tutte le email del tuo progetto Firebase modelli di machine learning.

Se utilizzi un dominio personalizzato, anche personalizzato il tuo gestore di azioni email, potresti comunque passaggio per fare in modo che le email relative alla gestione utenti si colleghino al tuo dominio anziché all'indirizzo predefinito firebaseapp.com.