जावास्क्रिप्ट में ईमेल लिंक का उपयोग करके फायरबेस से प्रमाणित करें

आप किसी उपयोगकर्ता को एक लिंक युक्त ईमेल भेजकर साइन इन करने के लिए फायरबेस प्रमाणीकरण का उपयोग कर सकते हैं, जिस पर वे साइन इन करने के लिए क्लिक कर सकते हैं। इस प्रक्रिया में, उपयोगकर्ता का ईमेल पता भी सत्यापित किया जाता है।

ईमेल द्वारा साइन इन करने के कई लाभ हैं:

• कम घर्षण साइन-अप और साइन-इन।
• सभी एप्लिकेशनों में पासवर्ड के पुन: उपयोग का जोखिम कम हो जाता है, जो अच्छी तरह से चयनित पासवर्ड की सुरक्षा को भी कमजोर कर सकता है।
• किसी उपयोगकर्ता को प्रमाणित करने की क्षमता, साथ ही यह सत्यापित करना कि उपयोगकर्ता ईमेल पते का वैध स्वामी है।
• उपयोगकर्ता को साइन इन करने के लिए केवल एक सुलभ ईमेल खाते की आवश्यकता होती है। फ़ोन नंबर या सोशल मीडिया खाते के स्वामित्व की आवश्यकता नहीं होती है।
• कोई उपयोगकर्ता पासवर्ड प्रदान करने (या याद रखने) की आवश्यकता के बिना सुरक्षित रूप से साइन इन कर सकता है, जो मोबाइल डिवाइस पर बोझिल हो सकता है।
• एक मौजूदा उपयोगकर्ता जिसने पहले ईमेल पहचानकर्ता (पासवर्ड या फ़ेडरेटेड) के साथ साइन इन किया था, उसे केवल ईमेल से साइन इन करने के लिए अपग्रेड किया जा सकता है। उदाहरण के लिए, एक उपयोगकर्ता जो अपना पासवर्ड भूल गया है, वह अपना पासवर्ड रीसेट किए बिना भी साइन इन कर सकता है।

शुरू करने से पहले

यदि आपने पहले से ऐसा नहीं किया है, तो फायरबेस कंसोल से इनिशियलाइज़ेशन स्निपेट को अपने प्रोजेक्ट में कॉपी करें जैसा कि अपने जावास्क्रिप्ट प्रोजेक्ट में फायरबेस जोड़ें में वर्णित है।

अपने फायरबेस प्रोजेक्ट के लिए ईमेल लिंक साइन-इन सक्षम करें

उपयोगकर्ताओं को ईमेल लिंक द्वारा साइन इन करने के लिए, आपको पहले अपने फायरबेस प्रोजेक्ट के लिए ईमेल प्रदाता और ईमेल लिंक साइन-इन विधि को सक्षम करना होगा:

1. फायरबेस कंसोल में, ऑथ सेक्शन खोलें।
2. साइन इन विधि टैब पर, ईमेल/पासवर्ड प्रदाता को सक्षम करें। ध्यान दें कि ईमेल लिंक साइन-इन का उपयोग करने के लिए ईमेल/पासवर्ड साइन-इन सक्षम होना चाहिए।
3. उसी अनुभाग में, ईमेल लिंक (पासवर्ड रहित साइन-इन) साइन-इन विधि सक्षम करें।
4. सहेजें पर क्लिक करें.

उपयोगकर्ता के ईमेल पते पर एक प्रमाणीकरण लिंक भेजें

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

1. ActionCodeSettings ऑब्जेक्ट का निर्माण करें, जो फायरबेस को ईमेल लिंक बनाने के निर्देश प्रदान करता है। निम्नलिखित फ़ील्ड सेट करें:

   • url : एंबेड करने के लिए डीप लिंक और पास की जाने वाली कोई भी अतिरिक्त स्थिति। लिंक के डोमेन को अधिकृत डोमेन की फायरबेस कंसोल सूची में जोड़ा जाना है, जिसे साइन-इन विधि टैब (प्रमाणीकरण -> सेटिंग्स) पर जाकर पाया जा सकता है।
   • android और ios : Android या Apple डिवाइस पर साइन-इन लिंक खोले जाने पर उपयोग किए जाने वाले ऐप्स। मोबाइल ऐप्स के माध्यम से ईमेल कार्रवाई लिंक खोलने के लिए फायरबेस डायनेमिक लिंक को कॉन्फ़िगर करने के तरीके के बारे में और जानें।
   • handleCodeInApp : सत्य पर सेट करें। साइन-इन ऑपरेशन को अन्य आउट ऑफ बैंड ईमेल क्रियाओं (पासवर्ड रीसेट और ईमेल सत्यापन) के विपरीत हमेशा ऐप में पूरा करना होता है। ऐसा इसलिए है, क्योंकि प्रवाह के अंत में, उपयोगकर्ता से साइन इन होने की उम्मीद की जाती है और ऐप के भीतर उनकी प्रामाणिक स्थिति बनी रहती है।

   • dynamicLinkDomain : जब किसी प्रोजेक्ट के लिए कई कस्टम डायनामिक लिंक डोमेन परिभाषित किए जाते हैं, तो निर्दिष्ट करें कि जब लिंक को एक निर्दिष्ट मोबाइल ऐप के माध्यम से खोला जाना है तो किसका उपयोग करना है (उदाहरण के लिए, example.page.link )। अन्यथा पहला डोमेन स्वचालित रूप से चयनित हो जाता है।

     Web modular API

     const actionCodeSettings = {
       // URL you want to redirect back to. The domain (www.example.com) for this
       // URL must be in the authorized domains list in the Firebase Console.
       url: 'https://www.example.com/finishSignUp?cartId=1234',
       // This must be true.
       handleCodeInApp: true,
       iOS: {
         bundleId: 'com.example.ios'
       },
       android: {
         packageName: 'com.example.android',
         installApp: true,
         minimumVersion: '12'
       },
       dynamicLinkDomain: 'example.page.link'
     };
     auth_email_link_actioncode_settings.js

     Web namespaced API

     var actionCodeSettings = {
       // URL you want to redirect back to. The domain (www.example.com) for this
       // URL must be in the authorized domains list in the Firebase Console.
       url: 'https://www.example.com/finishSignUp?cartId=1234',
       // This must be true.
       handleCodeInApp: true,
       iOS: {
         bundleId: 'com.example.ios'
       },
       android: {
         packageName: 'com.example.android',
         installApp: true,
         minimumVersion: '12'
       },
       dynamicLinkDomain: 'example.page.link'
     };
     email-link-auth.js

   ActionCodeSettings पर अधिक जानने के लिए, ईमेल कार्रवाई अनुभाग में पासिंग स्थिति देखें।

2. उपयोगकर्ता से उनका ईमेल पूछें.

3. उपयोगकर्ता के ईमेल पर प्रमाणीकरण लिंक भेजें, और यदि उपयोगकर्ता उसी डिवाइस पर ईमेल साइन-इन पूरा करता है तो उपयोगकर्ता का ईमेल सहेजें।

   Web modular API

   import { getAuth, sendSignInLinkToEmail } from "firebase/auth";
   
   const auth = getAuth();
   sendSignInLinkToEmail(auth, email, actionCodeSettings)
     .then(() => {
       // The link was successfully sent. Inform the user.
       // Save the email locally so you don't need to ask the user for it again
       // if they open the link on the same device.
       window.localStorage.setItem('emailForSignIn', email);
       // ...
     })
     .catch((error) => {
       const errorCode = error.code;
       const errorMessage = error.message;
       // ...
     });
   auth_email_link_send.js

   Web namespaced API

   firebase.auth().sendSignInLinkToEmail(email, actionCodeSettings)
     .then(() => {
       // The link was successfully sent. Inform the user.
       // Save the email locally so you don't need to ask the user for it again
       // if they open the link on the same device.
       window.localStorage.setItem('emailForSignIn', email);
       // ...
     })
     .catch((error) => {
       var errorCode = error.code;
       var errorMessage = error.message;
       // ...
     });
   email-link-auth.js

ईमेल लिंक के साथ पूर्ण साइन इन करें

सुरक्षा चिंताएं

साइन-इन लिंक को अनपेक्षित उपयोगकर्ता के रूप में या अनपेक्षित डिवाइस पर साइन इन करने से रोकने के लिए, फायरबेस ऑथ को साइन-इन प्रवाह पूरा करते समय उपयोगकर्ता का ईमेल पता प्रदान करना आवश्यक है। साइन-इन सफल होने के लिए, यह ईमेल पता उस पते से मेल खाना चाहिए जिस पर साइन-इन लिंक मूल रूप से भेजा गया था।

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

साइन-इन पूरा होने के बाद, साइन-इन का कोई भी पिछला असत्यापित तंत्र उपयोगकर्ता से हटा दिया जाएगा और कोई भी मौजूदा सत्र अमान्य कर दिया जाएगा। उदाहरण के लिए, यदि किसी ने पहले उसी ईमेल और पासवर्ड के साथ एक असत्यापित खाता बनाया था, तो उस प्रतिरूपणकर्ता को रोकने के लिए उपयोगकर्ता का पासवर्ड हटा दिया जाएगा जिसने स्वामित्व का दावा किया था और उस असत्यापित खाते को असत्यापित ईमेल और पासवर्ड के साथ फिर से साइन इन करने से रोका था।

यह भी सुनिश्चित करें कि आपके लिंक को मध्यस्थ सर्वर द्वारा संभावित रूप से बाधित होने से बचाने के लिए आप उत्पादन में HTTPS URL का उपयोग करें।

किसी वेब पेज में साइन-इन पूरा करना

ईमेल लिंक डीप लिंक का प्रारूप आउट ऑफ बैंड ईमेल क्रियाओं (ईमेल सत्यापन, पासवर्ड रीसेट और ईमेल परिवर्तन निरस्तीकरण) के लिए उपयोग किए जाने वाले प्रारूप के समान है। फायरबेस ऑथ यह जांचने के लिए isSignInWithEmailLink API प्रदान करके इस जांच को सरल बनाता है कि कोई लिंक ईमेल लिंक के साथ साइन-इन है या नहीं।

लैंडिंग पृष्ठ पर साइन इन पूरा करने के लिए, उपयोगकर्ता के ईमेल और वन-टाइम कोड वाले वास्तविक ईमेल लिंक के साथ signInWithEmailLink पर कॉल करें।

import { getAuth, isSignInWithEmailLink, signInWithEmailLink } from "firebase/auth";

// Confirm the link is a sign-in with email link.
const auth = getAuth();
if (isSignInWithEmailLink(auth, window.location.href)) {
  // Additional state parameters can also be passed via URL.
  // This can be used to continue the user's intended action before triggering
  // the sign-in operation.
  // Get the email if available. This should be available if the user completes
  // the flow on the same device where they started it.
  let email = window.localStorage.getItem('emailForSignIn');
  if (!email) {
    // User opened the link on a different device. To prevent session fixation
    // attacks, ask the user to provide the associated email again. For example:
    email = window.prompt('Please provide your email for confirmation');
  }
  // The client SDK will parse the code from the link for you.
  signInWithEmailLink(auth, email, window.location.href)
    .then((result) => {
      // Clear email from storage.
      window.localStorage.removeItem('emailForSignIn');
      // You can access the new user via result.user
      // Additional user info profile not available via:
      // result.additionalUserInfo.profile == null
      // You can check if the user is new or existing:
      // result.additionalUserInfo.isNewUser
    })
    .catch((error) => {
      // Some error occurred, you can inspect the code: error.code
      // Common errors could be invalid email and invalid or expired OTPs.
    });
}
email_link_complete.js

// Confirm the link is a sign-in with email link.
if (firebase.auth().isSignInWithEmailLink(window.location.href)) {
  // Additional state parameters can also be passed via URL.
  // This can be used to continue the user's intended action before triggering
  // the sign-in operation.
  // Get the email if available. This should be available if the user completes
  // the flow on the same device where they started it.
  var email = window.localStorage.getItem('emailForSignIn');
  if (!email) {
    // User opened the link on a different device. To prevent session fixation
    // attacks, ask the user to provide the associated email again. For example:
    email = window.prompt('Please provide your email for confirmation');
  }
  // The client SDK will parse the code from the link for you.
  firebase.auth().signInWithEmailLink(email, window.location.href)
    .then((result) => {
      // Clear email from storage.
      window.localStorage.removeItem('emailForSignIn');
      // You can access the new user via result.user
      // Additional user info profile not available via:
      // result.additionalUserInfo.profile == null
      // You can check if the user is new or existing:
      // result.additionalUserInfo.isNewUser
    })
    .catch((error) => {
      // Some error occurred, you can inspect the code: error.code
      // Common errors could be invalid email and invalid or expired OTPs.
    });
}
email-link-auth.js

मोबाइल ऐप में साइन-इन पूरा करना

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

एंड्रॉइड एप्लिकेशन में ईमेल लिंक के साथ साइन-इन को संभालने के तरीके के बारे में अधिक जानने के लिए, एंड्रॉइड गाइड देखें।

Apple एप्लिकेशन में ईमेल लिंक के साथ साइन-इन को संभालने के तरीके के बारे में अधिक जानने के लिए, Apple प्लेटफ़ॉर्म गाइड देखें।

ईमेल लिंक से लिंक करना/पुन:प्रमाणीकरण करना

आप प्रमाणीकरण की इस पद्धति को किसी मौजूदा उपयोगकर्ता से भी लिंक कर सकते हैं। उदाहरण के लिए, पहले किसी अन्य प्रदाता, जैसे फ़ोन नंबर, से प्रमाणित उपयोगकर्ता साइन-इन की इस पद्धति को अपने मौजूदा खाते में जोड़ सकता है।

अंतर ऑपरेशन के दूसरे भाग में होगा:

import { getAuth, linkWithCredential, EmailAuthProvider } from "firebase/auth";

// Construct the email link credential from the current URL.
const credential = EmailAuthProvider.credentialWithLink(
  email, window.location.href);

// Link the credential to the current user.
const auth = getAuth();
linkWithCredential(auth.currentUser, credential)
  .then((usercred) => {
    // The provider is now successfully linked.
    // The phone user can now sign in with their phone number or email.
  })
  .catch((error) => {
    // Some error occurred.
  });
auth_email_link_link.js

// Construct the email link credential from the current URL.
var credential = firebase.auth.EmailAuthProvider.credentialWithLink(
  email, window.location.href);

// Link the credential to the current user.
firebase.auth().currentUser.linkWithCredential(credential)
  .then((usercred) => {
    // The provider is now successfully linked.
    // The phone user can now sign in with their phone number or email.
  })
  .catch((error) => {
    // Some error occurred.
  });
email-link-auth.js

इसका उपयोग किसी संवेदनशील ऑपरेशन को चलाने से पहले किसी ईमेल लिंक उपयोगकर्ता को पुनः प्रमाणित करने के लिए भी किया जा सकता है।

import { getAuth, reauthenticateWithCredential, EmailAuthProvider } from "firebase/auth";

// Construct the email link credential from the current URL.
const credential = EmailAuthProvider.credentialWithLink(
  email, window.location.href);

// Re-authenticate the user with this credential.
const auth = getAuth();
reauthenticateWithCredential(auth.currentUser, credential)
  .then((usercred) => {
    // The user is now successfully re-authenticated and can execute sensitive
    // operations.
  })
  .catch((error) => {
    // Some error occurred.
  });
auth_email_link_reauth.js

// Construct the email link credential from the current URL.
var credential = firebase.auth.EmailAuthProvider.credentialWithLink(
  email, window.location.href);

// Re-authenticate the user with this credential.
firebase.auth().currentUser.reauthenticateWithCredential(credential)
  .then((usercred) => {
    // The user is now successfully re-authenticated and can execute sensitive
    // operations.
  })
  .catch((error) => {
    // Some error occurred.
  });
email-link-auth.js

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

अस्वीकृत: ईमेल-पासवर्ड को ईमेल लिंक से अलग करना

यदि आपने अपना प्रोजेक्ट 15 सितंबर, 2023 को या उसके बाद बनाया है, तो ईमेल गणना सुरक्षा डिफ़ॉल्ट रूप से सक्षम है। यह सुविधा आपके प्रोजेक्ट के उपयोगकर्ता खातों की सुरक्षा में सुधार करती है, लेकिन यह fetchSignInMethodsForEmail() विधि को अक्षम कर देती है, जिसे हमने पहले पहचानकर्ता-प्रथम प्रवाह को लागू करने के लिए अनुशंसित किया था।

हालाँकि आप अपने प्रोजेक्ट के लिए ईमेल गणना सुरक्षा को अक्षम कर सकते हैं, हम ऐसा न करने की सलाह देते हैं।

अधिक विवरण के लिए ईमेल गणना सुरक्षा पर दस्तावेज़ देखें।

लिंक साइन-इन के लिए डिफ़ॉल्ट ईमेल टेम्पलेट

डिफ़ॉल्ट ईमेल टेम्प्लेट में विषय और ईमेल बॉडी में एक टाइमस्टैम्प शामिल होता है ताकि बाद के ईमेल एक ही थ्रेड में सिमट न जाएं और लिंक छिपा न रहे।

यह टेम्पलेट निम्नलिखित भाषाओं पर लागू होता है:

अगले कदम

किसी उपयोगकर्ता द्वारा पहली बार साइन इन करने के बाद, एक नया उपयोगकर्ता खाता बनाया जाता है और क्रेडेंशियल्स से लिंक किया जाता है - यानी, उपयोगकर्ता नाम और पासवर्ड, फोन नंबर, या ऑथ प्रदाता जानकारी - जिस उपयोगकर्ता के साथ साइन इन किया जाता है। यह नया खाता आपके फायरबेस प्रोजेक्ट के हिस्से के रूप में संग्रहीत है, और इसका उपयोग आपके प्रोजेक्ट के प्रत्येक ऐप में उपयोगकर्ता की पहचान करने के लिए किया जा सकता है, भले ही उपयोगकर्ता कैसे भी साइन इन करता हो।

• आपके ऐप्स में, आपके उपयोगकर्ता की प्रामाणिक स्थिति जानने का अनुशंसित तरीका Auth ऑब्जेक्ट पर एक पर्यवेक्षक सेट करना है। फिर आप User ऑब्जेक्ट से उपयोगकर्ता की मूल प्रोफ़ाइल जानकारी प्राप्त कर सकते हैं। उपयोगकर्ता प्रबंधित करें देखें.

• अपने फायरबेस रीयलटाइम डेटाबेस और क्लाउड स्टोरेज सुरक्षा नियमों में, आप साइन-इन किए गए उपयोगकर्ता की अद्वितीय उपयोगकर्ता आईडी को auth वेरिएबल से प्राप्त कर सकते हैं, और इसका उपयोग यह नियंत्रित करने के लिए कर सकते हैं कि उपयोगकर्ता किस डेटा तक पहुंच सकता है।

आप किसी मौजूदा उपयोगकर्ता खाते से प्रमाणीकरण प्रदाता क्रेडेंशियल्स को लिंक करके उपयोगकर्ताओं को एकाधिक प्रमाणीकरण प्रदाताओं का उपयोग करके अपने ऐप में साइन इन करने की अनुमति दे सकते हैं।

किसी उपयोगकर्ता को साइन आउट करने के लिए, signOut पर कॉल करें:

import { getAuth, signOut } from "firebase/auth";

const auth = getAuth();
signOut(auth).then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});
auth_sign_out.js

firebase.auth().signOut().then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});
index.js