Google is committed to advancing racial equity for Black communities. See how.
इस पेज का अनुवाद Cloud Translation API से किया गया है.
Switch to English

कस्टम ईमेल एक्शन हैंडलर बनाएं

कुछ उपयोगकर्ता प्रबंधन क्रियाएं, जैसे उपयोगकर्ता का ईमेल पता अपडेट करना और उपयोगकर्ता का पासवर्ड रीसेट करना, जिसके परिणामस्वरूप उपयोगकर्ता को ईमेल भेजे जाते हैं। इन ईमेल में ऐसे लिंक होते हैं जो प्राप्तकर्ता उपयोगकर्ता प्रबंधन कार्रवाई को पूरा करने या रद्द करने के लिए खोल सकते हैं। डिफ़ॉल्ट रूप से, उपयोगकर्ता प्रबंधन ईमेल डिफ़ॉल्ट एक्शन हैंडलर से लिंक होता है, जो आपके प्रोजेक्ट के फायरबेस होस्टिंग डोमेन के URL पर होस्ट किया गया एक वेब पेज है।

आप इसके बजाय कस्टम प्रोसेसिंग करने के लिए और अपनी वेबसाइट के साथ ईमेल एक्शन हैंडलर को एकीकृत करने के लिए एक कस्टम ईमेल एक्शन हैंडलर बना सकते हैं और होस्ट कर सकते हैं।

निम्नलिखित उपयोगकर्ता प्रबंधन क्रियाओं के लिए उपयोगकर्ता को ईमेल एक्शन हैंडलर का उपयोग करके कार्रवाई पूरी करने की आवश्यकता होती है:

  • पासवर्ड रीसेट करना
  • ई-मेल पते में परिवर्तन करना - जब उपयोगकर्ता अपने खातों के प्राथमिक ईमेल पते बदलते हैं, तो Firebase अपने पुराने पते पर एक ईमेल भेजता है जो उन्हें परिवर्तन को पूर्ववत करने की अनुमति देता है
  • ईमेल पते का सत्यापन

अपने फायरबेस प्रोजेक्ट के ईमेल एक्शन हैंडलर को अनुकूलित करने के लिए, आपको अनुरोध की वैधता को सत्यापित करने और अनुरोध को पूरा करने के लिए फायरबेस जावास्क्रिप्ट एसडीके का उपयोग करने वाला एक वेब पेज बनाना और होस्ट करना होगा। फिर, आपको अपने कस्टम एक्शन हैंडलर से लिंक करने के लिए अपने फायरबेस प्रोजेक्ट के ईमेल टेम्प्लेट को कस्टमाइज़ करना होगा।

ईमेल एक्शन हैंडलर पेज बनाएं

  1. जब यह उपयोगकर्ता प्रबंधन ईमेल उत्पन्न करता है, तो Firebase आपके एक्शन हैंडलर URL में कई क्वेरी पैरामीटर जोड़ता है। उदाहरण के लिए:

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

    ये पैरामीटर उपयोगकर्ता प्रबंधन कार्य को निर्दिष्ट करते हैं जो उपयोगकर्ता पूरा कर रहा है। आपके ईमेल एक्शन हैंडलर पृष्ठ को निम्नलिखित क्वेरी मापदंडों को संभालना होगा:

    पैरामीटर
    मोड

    उपयोगकर्ता प्रबंधन कार्रवाई पूरी की जानी है। निम्नलिखित में से एक मान हो सकता है:

    • resetPassword
    • recoverEmail
    • verifyEmail
    oobCode एक बार कोड, एक अनुरोध को पहचानने और सत्यापित करने के लिए उपयोग किया जाता है
    एपीआई कुंजी आपकी फायरबेस परियोजना की एपीआई कुंजी, सुविधा के लिए प्रदान की गई है
    continueUrl यह एक वैकल्पिक URL है जो URL के माध्यम से ऐप में वापस जाने का रास्ता प्रदान करता है। यह पासवर्ड रीसेट और ईमेल सत्यापन मोड के लिए प्रासंगिक है। पासवर्ड रीसेट ईमेल या सत्यापन ईमेल ActionCodeSettings , एक ActionCodeSettings ऑब्जेक्ट को उपलब्ध होने के लिए जारी URL के साथ निर्दिष्ट करने की आवश्यकता होती है। यह एक उपयोगकर्ता के लिए सही जारी रखने के लिए संभव बनाता है जहां उन्होंने ईमेल कार्रवाई के बाद छोड़ दिया।
    लैंग

    यह उपयोगकर्ता के स्थान (उदाहरण के लिए, fr ) का प्रतिनिधित्व करने वाला वैकल्पिक BCP47 भाषा टैग है। आप अपने उपयोगकर्ताओं को स्थानीय ईमेल कार्रवाई हैंडलर पृष्ठ प्रदान करने के लिए इस मान का उपयोग कर सकते हैं।

    ईमेल कार्रवाई शुरू करने से पहले संबंधित क्लाइंट एपीआई को कॉल करके स्थानीयकरण को फायरबेस कंसोल या गतिशील रूप से सेट किया जा सकता है। उदाहरण के लिए, जावास्क्रिप्ट का उपयोग कर: firebase.auth().languageCode = 'fr';

    लगातार उपयोगकर्ता अनुभव के लिए, सुनिश्चित करें कि ईमेल एक्शन हैंडलर स्थानीयकरण ईमेल टेम्पलेट से मेल खाता है।

    निम्न उदाहरण दिखाता है कि आप ब्राउज़र आधारित हैंडलर में क्वेरी पैरामीटर को कैसे संभाल सकते हैं। (आप इसी तर्क का उपयोग करके हैंडलर को Node.js एप्लिकेशन के रूप में भी लागू कर सकते हैं।)

    <script src="https://www.gstatic.com/firebasejs/7.24.0/firebase.js"></script>
    <script>
    document.addEventListener('DOMContentLoaded', function() {
      // 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': <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);
    </script>
    
  2. पहले verifyPasswordResetCode के साथ कार्रवाई कोड को सत्यापित करके पासवर्ड रीसेट अनुरोधों को verifyPasswordResetCode ; फिर उपयोगकर्ता से एक नया पासवर्ड प्राप्त करें और उसे confirmPasswordReset । उदाहरण के लिए:

    function handleResetPassword(auth, actionCode, continueUrl, lang) {
      // Localize the UI to the selected language as determined by the lang
      // parameter.
      var accountEmail;
      // Verify the password reset code is valid.
      auth.verifyPasswordResetCode(actionCode).then(function(email) {
        var accountEmail = email;
    
        // TODO: Show the reset screen with the user's email and ask the user for
        // the new password.
    
        // Save the new password.
        auth.confirmPasswordReset(actionCode, newPassword).then(function(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(function(error) {
          // Error occurred during confirmation. The code might have expired or the
          // password is too weak.
        });
      }).catch(function(error) {
        // Invalid or expired action code. Ask user to try to reset the password
        // again.
      });
    }
    
  3. checkActionCode के साथ कार्रवाई कोड को पहले सत्यापित करके ईमेल पते में परिवर्तन को हैंडल करें; फिर applyActionCode साथ उपयोगकर्ता के ईमेल पते को applyActionCode । उदाहरण के लिए:

    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(function(info) {
        // Get the restored email address.
        restoredEmail = info['data']['email'];
    
        // Revert to the old email.
        return auth.applyActionCode(actionCode);
      }).then(function() {
        // 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(function() {
          // Password reset confirmation sent. Ask user to check their email.
        }).catch(function(error) {
          // Error encountered while sending password reset code.
        });
      }).catch(function(error) {
        // Invalid code.
      });
    }
    
  4. applyActionCode को कॉल करके ईमेल एड्रेस वेरिफिकेशन को हैंडल करें। उदाहरण के लिए:

    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(function(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(function(error) {
        // Code is invalid or expired. Ask the user to verify their email address
        // again.
      });
    }
    
  5. पेज को कहीं होस्ट करें, उदाहरण के लिए फायरबेस होस्टिंग का उपयोग करें।

इसके बाद, आपको अपने Firebase प्रोजेक्ट को अपने उपयोगकर्ता प्रबंधन ईमेल में अपने कस्टम ईमेल एक्शन हैंडलर से लिंक करना होगा।

अपने कस्टम ईमेल एक्शन हैंडलर का उपयोग करने के लिए अपने Firebase प्रोजेक्ट को कॉन्फ़िगर करने के लिए:

  1. Firebase कंसोल में अपना प्रोजेक्ट खोलें।
  2. प्रामाणिक अनुभाग में ईमेल टेम्प्लेट पृष्ठ पर जाएं।
  3. किसी भी ईमेल प्रकार प्रविष्टियों में, ईमेल टेम्पलेट को संपादित करने के लिए पेंसिल आइकन पर क्लिक करें।
  4. कस्टमाइज़्ड एक्शन URL पर क्लिक करें, और अपने कस्टम ईमेल एक्शन हैंडलर के लिए URL निर्दिष्ट करें।

URL सहेजने के बाद, इसका उपयोग आपके सभी Firebase प्रोजेक्ट के ईमेल टेम्प्लेट द्वारा किया जाएगा।