Bu sayfa, Cloud Translation API ile çevrilmiştir.

Özel e-posta işlem işleyicileri oluşturma
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Kullanıcının e-posta adresini güncelleme ve kullanıcının şifresini sıfırlama gibi bazı kullanıcı yönetimi işlemleri, kullanıcıya e-posta gönderilmesine neden olur. Bu e-postalar, kullanıcı yönetimi işlemini tamamlamak veya iptal etmek için alıcılarının açabileceği bağlantılar içerir. Kullanıcı yönetimi e-postaları varsayılan olarak varsayılan işlem işleyiciye bağlantı verir. Varsayılan işlem işleyici, projenizin Firebase Hosting alanındaki bir URL'de barındırılan bir web sayfasıdır.

Bunun yerine, özel işlem yapmak ve e-posta işleme işleyicisini web sitenizle entegre etmek için özel bir e-posta işleme işleyicisi oluşturabilir ve barındırabilirsiniz.

Aşağıdaki kullanıcı yönetimi işlemleri için kullanıcının bir e-posta işlem işleyicisi kullanarak işlemi tamamlaması gerekir:

Şifreleri sıfırlama
E-posta adresi değişikliklerini iptal etme: Kullanıcılar hesaplarının birincil e-posta adreslerini değiştirdiğinde Firebase, eski adreslerine değişikliği geri almalarını sağlayan bir e-posta gönderir.
E-posta adreslerini doğrulama

Firebase projenizin e-posta işlem işleyicisini özelleştirmek için isteğin geçerliliğini doğrulamak ve isteği tamamlamak üzere Firebase JavaScript SDK'sını kullanan bir web sayfası oluşturup barındırmanız gerekir. Ardından, Firebase projenizin e-posta şablonlarını özel işlem işleyicinize bağlamak için özelleştirmeniz gerekir.

E-posta işlemi işleyici sayfasını oluşturma

Firebase, kullanıcı yönetimi e-postaları oluştururken işlem işleyici URL'nize çeşitli sorgu parametreleri ekler. Örneğin:

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

Bu parametreler, kullanıcının tamamlamakta olduğu kullanıcı yönetimi görevini belirtir. E-posta işlemi işleyici sayfanız aşağıdaki sorgu parametrelerini işlemelidir:

Parametreler
mod	Tamamlanması gereken kullanıcı yönetimi işlemi. Aşağıdaki değerlerden biri olabilir: `resetPassword` `recoverEmail` `verifyEmail`
oobCode	Bir isteği tanımlamak ve doğrulamak için kullanılan tek kullanımlık kod
apiKey	Kolaylık sağlamak amacıyla sağlanan Firebase projenizin API anahtarı
continueUrl	Bu, durumu bir URL aracılığıyla uygulamaya geri göndermenin yolunu sağlayan isteğe bağlı bir URL'dir. Bu, şifre sıfırlama ve e-posta doğrulama modlarıyla ilgilidir. Şifre sıfırlama e-postası veya doğrulama e-postası gönderirken, bu özelliğin kullanılabilmesi için devam URL'si içeren bir `ActionCodeSettings` nesnesi belirtilmesi gerekir. Bu sayede kullanıcılar, e-posta işleminin ardından kalkıştıkları yerden devam edebilir.
lang	Bu, kullanıcının yerel ayarını temsil eden isteğe bağlı BCP47 dil etiketidir (örneğin, `fr`). Kullanıcılarınıza yerelleştirilmiş e-posta işleme sayfaları sağlamak için bu değeri kullanabilirsiniz. Yerelleştirme, Firebase Konsolu üzerinden veya e-posta işlemini tetiklemeden önce ilgili istemci API'sini çağırarak dinamik olarak ayarlanabilir. Örneğin, JavaScript kullanarak: `firebase.auth().languageCode = 'fr';`. Tutarlı bir kullanıcı deneyimi için e-posta işlem işleyicisinin yerelleştirmesinin, e-posta şablonunun yerelleştirmesiyle eşleştiğinden emin olun.

Aşağıdaki örnekte, tarayıcı tabanlı bir işleyicide sorgu parametrelerini nasıl işleyeceğiniz gösterilmektedir. (Benzer mantığı kullanarak işleyiciyi Node.js uygulaması olarak da uygulayabilirsiniz.)

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

Önce verifyPasswordResetCode ile işlem kodunu doğrulayarak şifre sıfırlama isteklerini işleyin, ardından kullanıcıdan yeni bir şifre alın ve confirmPasswordReset'a iletin. Örneğin:

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

E-posta adresi değişikliği iptallerini işlemek için önce checkActionCode ile işlem kodunu doğrulayın, ardından applyActionCode ile kullanıcının e-posta adresini geri yükleyin. Örneğin:

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

applyActionCode numaralı telefonu arayarak e-posta adresi doğrulamasını yapın. Örneğin:

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

Sayfayı bir yerde barındırın (ör. Firebase Hosting).

Ardından, Firebase projenizi kullanıcı yönetimi e-postalarında özel e-posta işlem işleyicinize bağlanacak şekilde yapılandırmanız gerekir.

E-posta şablonlarınızda özel işleyicinizin bağlantısını ekleme

Firebase projenizi, özel e-posta işlem işleyicinizi kullanacak şekilde yapılandırmak için:

Projenizi Firebase konsolunda açın.
Auth bölümündeki E-posta Şablonları sayfasına gidin.
E-posta şablonunu düzenlemek için E-posta Türleri girişlerinden herhangi birinde kalem simgesini tıklayın.
İşlem URL'sini özelleştir'i tıklayın ve özel e-posta işlem işleyicinizin URL'sini belirtin.

Kaydettiğiniz URL, Firebase projenizin tüm e-posta şablonları tarafından kullanılır.

Özel bir alan kullanıyorsanız e-posta işlem işleyicinizi özelleştirmeseniz bile kullanıcı yönetimi e-postalarının varsayılan firebaseapp.com alanı yerine alanınıza bağlanması için bu adımı tamamlayabilirsiniz.

Özel e-posta işlem işleyicileri oluşturma Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

E-posta işlemi işleyici sayfasını oluşturma

Web

Web

Web

Web

Web

Web

Web

Web

E-posta şablonlarınızda özel işleyicinizin bağlantısını ekleme

Özel e-posta işlem işleyicileri oluşturma
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.