Firebase JS SDK का इस्तेमाल करते समय, यह तय किया जा सकता है कि पुष्टि करने की स्थिति कैसे बनी रहे. इसमें यह तय करने की सुविधा शामिल है कि साइन इन किए हुए उपयोगकर्ता को तब तक साइन इन रखा जाए, जब तक कि वह साफ़ तौर पर साइन आउट न कर दे. इसके अलावा, विंडो बंद होने पर या पेज को फिर से लोड करने पर, उपयोगकर्ता को साइन आउट कर दिया जाए.
किसी वेब ऐप्लिकेशन के लिए, डिफ़ॉल्ट व्यवहार यह होता है कि उपयोगकर्ता के ब्राउज़र को बंद करने के बाद भी उसका सेशन बना रहता है. यह सुविधा काफ़ी मददगार है, क्योंकि उपयोगकर्ता को एक ही डिवाइस पर वेब पेज पर जाने के लिए, हर बार साइन-इन करने की ज़रूरत नहीं पड़ती. इसके लिए, हो सकता है कि उपयोगकर्ता को अपना पासवर्ड फिर से डालना पड़े, एसएमएस से पुष्टि करनी पड़े वगैरह. इससे उपयोगकर्ता अनुभव पर असर पड़ सकता है.
हालांकि, कुछ मामलों में ऐसा करना सही नहीं होता:
- संवेदनशील डेटा वाले ऐप्लिकेशन, विंडो या टैब बंद होने पर स्टेट को मिटा सकते हैं. यह तब ज़रूरी होता है, जब उपयोगकर्ता साइन आउट करना भूल जाए.
- ऐसे ऐप्लिकेशन जिनका इस्तेमाल, कई लोगों के साथ शेयर किए गए डिवाइस पर किया जाता है. इसका एक आम उदाहरण है, लाइब्रेरी के कंप्यूटर पर चलने वाला ऐप्लिकेशन.
- शेयर किए गए डिवाइस पर मौजूद कोई ऐप्लिकेशन, जिसे कई उपयोगकर्ता ऐक्सेस कर सकते हैं. डेवलपर को यह नहीं पता होता कि उस ऐप्लिकेशन को कैसे ऐक्सेस किया जाता है. साथ ही, हो सकता है कि वह उपयोगकर्ता को यह चुनने की सुविधा देना चाहे कि उसका सेशन जारी रहे या नहीं. इसके लिए, साइन-इन करते समय "मुझे याद रखें" विकल्प जोड़ा जा सकता है.
- कुछ मामलों में, हो सकता है कि कोई डेवलपर किसी ऐसे उपयोगकर्ता की जानकारी सेव न करना चाहे जिसकी पहचान ज़ाहिर न की गई हो. ऐसा तब तक हो सकता है, जब तक उस उपयोगकर्ता के खाते को ऐसे खाते में अपग्रेड न कर दिया जाए जिसमें उसकी पहचान ज़ाहिर की गई हो. जैसे, फ़ेडरेटेड, पासवर्ड, फ़ोन वगैरह.
- ऐसा हो सकता है कि कोई डेवलपर, अलग-अलग उपयोगकर्ताओं को अलग-अलग टैब पर किसी ऐप्लिकेशन में साइन इन करने की अनुमति देना चाहे. डिफ़ॉल्ट रूप से, एक ही ऑरिजिन के लिए सभी टैब में स्थिति को बनाए रखा जाता है.
जैसा कि ऊपर बताया गया है, ऐसी कई स्थितियां होती हैं जिनमें डिफ़ॉल्ट तौर पर सेट की गई स्थायी परसिस्टेंस को बदलना पड़ सकता है.
पुष्टि की स्थिति को बनाए रखने के लिए, इस तरह के तरीके इस्तेमाल किए जा सकते हैं
अपने ऐप्लिकेशन या उपयोगकर्ता की ज़रूरतों के हिसाब से, Firebase Auth के किसी इंस्टेंस पर, पुष्टि करने की स्थिति को बनाए रखने के लिए, तीन में से कोई एक विकल्प चुना जा सकता है.
| Enum | वैल्यू | ब्यौरा |
|---|---|---|
firebase.auth.Auth.Persistence.LOCAL |
'local' | इससे पता चलता है कि ब्राउज़र विंडो बंद होने या React Native में गतिविधि खत्म होने पर भी, स्थिति बनी रहेगी. इस स्थिति को हटाने के लिए, साफ़ तौर पर साइन आउट करना ज़रूरी है. ध्यान दें कि Firebase Auth के वेब सेशन, सिंगल होस्ट ऑरिजिन होते हैं और इन्हें सिर्फ़ एक डोमेन के लिए सेव किया जाएगा. |
firebase.auth.Auth.Persistence.SESSION |
'session' | इससे पता चलता है कि स्थिति सिर्फ़ मौजूदा सेशन या टैब में बनी रहेगी. साथ ही, जिस टैब या विंडो में उपयोगकर्ता की पुष्टि की गई है उसे बंद करने पर, स्थिति मिटा दी जाएगी. सिर्फ़ वेब ऐप्लिकेशन पर लागू होती है. |
firebase.auth.Auth.Persistence.NONE |
'none' | इससे पता चलता है कि स्थिति सिर्फ़ मेमोरी में सेव की जाएगी और विंडो या गतिविधि को रीफ़्रेश करने पर, उसे मिटा दिया जाएगा. |
पुष्टि की स्थिति को सेव रखने की सुविधा में बदलाव करना
firebase.auth().setPersistence तरीके का इस्तेमाल करके, डेटा सेव करने के मौजूदा टाइप को तय किया जा सकता है या उसमें बदलाव किया जा सकता है:
Web
import { getAuth, setPersistence, signInWithEmailAndPassword, browserSessionPersistence } from "firebase/auth"; const auth = getAuth(); setPersistence(auth, browserSessionPersistence) .then(() => { // Existing and future Auth states are now persisted in the current // session only. Closing the window would clear any existing state even // if a user forgets to sign out. // ... // New sign-in will be persisted with session persistence. return signInWithEmailAndPassword(auth, email, password); }) .catch((error) => { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; });
Web
firebase.auth().setPersistence(firebase.auth.Auth.Persistence.SESSION) .then(() => { // Existing and future Auth states are now persisted in the current // session only. Closing the window would clear any existing state even // if a user forgets to sign out. // ... // New sign-in will be persisted with session persistence. return firebase.auth().signInWithEmailAndPassword(email, password); }) .catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; });
इससे, सेव किए गए मौजूदा Auth सेशन के लिए, Auth के तय किए गए इंस्टेंस पर पर्सिस्टेंस का टाइप बदल जाएगा. साथ ही, आने वाले समय में साइन इन करने के अनुरोधों के लिए, इस टाइप का पर्सिस्टेंस लागू हो जाएगा. इसमें रीडायरेक्ट करने के अनुरोधों के साथ साइन इन करना भी शामिल है. इस कॉल के रिस्पॉन्स में एक प्रॉमिस मिलेगा. जब स्टेट को एक तरह के स्टोरेज से दूसरे स्टोरेज में कॉपी कर लिया जाएगा, तब इस प्रॉमिस को रिज़ॉल्व कर दिया जाएगा. लगातार बने रहने की सेटिंग बदलने के बाद, साइन-इन का तरीका कॉल करने पर, लगातार बने रहने की सेटिंग में बदलाव होने का इंतज़ार किया जाएगा. इसके बाद ही, इसे पुष्टि करने की नई स्थिति पर लागू किया जाएगा.
वेब ब्राउज़र और React Native ऐप्लिकेशन के लिए, डिफ़ॉल्ट रूप से local का इस्तेमाल किया जाता है. हालांकि, इसके लिए ज़रूरी है कि ब्राउज़र, स्टोरेज के इस तरीके के साथ काम करता हो. उदाहरण के लिए, तीसरे पक्ष की कुकी/डेटा चालू है), जबकि Node.js बैकएंड ऐप्लिकेशन के लिए यह none है.
परसिस्टेंस बिहेवियर की खास जानकारी
परसिस्टेंस की मौजूदा स्थिति तय करते समय, इन शर्तों को लागू किया जाएगा.
- शुरुआत में, SDK टूल यह जांच करेगा कि पुष्टि किया गया कोई उपयोगकर्ता मौजूद है या नहीं. जब तक
setPersistenceको कॉल नहीं किया जाता, तब तक उस उपयोगकर्ता के लिए, साइन इन करने की मौजूदा सेटिंग लागू रहेगी. इसलिए, अगर उस उपयोगकर्ता को पिछले वेब पेज परsessionमें सेव किया गया था और उसने किसी नए पेज पर विज़िट किया, तो किसी दूसरे उपयोगकर्ता के तौर पर फिर से साइन इन करने पर, उस उपयोगकर्ता की स्थिति भीsessionमें सेव हो जाएगी. - अगर किसी उपयोगकर्ता ने साइन इन नहीं किया है और पर्सिस्टेंस की कोई सेटिंग तय नहीं की गई है, तो डिफ़ॉल्ट सेटिंग लागू होगी (ब्राउज़र ऐप्लिकेशन में
local). - अगर किसी उपयोगकर्ता ने साइन इन नहीं किया है और पर्सिस्टेंस का नया टाइप सेट किया गया है, तो आने वाले समय में साइन इन करने की किसी भी कोशिश के लिए, पर्सिस्टेंस के उस टाइप का इस्तेमाल किया जाएगा.
- अगर उपयोगकर्ता ने साइन इन किया हुआ है और पर्सिस्टेंस टाइप में बदलाव किया जाता है, तो साइन इन किया हुआ मौजूदा उपयोगकर्ता, पर्सिस्टेंस को नए टाइप में बदल देगा. आने वाले समय में, साइन इन करने की सभी कोशिशों के लिए, इस नए परसिस्टेंस का इस्तेमाल किया जाएगा.
signInWithRedirect को कॉल करने पर, मौजूदा पर्सिस्टेंस टाइप को बनाए रखा जाता है. साथ ही, OAuth फ़्लो के आखिर में, साइन इन करने वाले नए उपयोगकर्ता पर लागू किया जाता है. भले ही, पर्सिस्टेंस
noneहो. अगर उस पेज पर, सेव रहने की अवधि को साफ़ तौर पर बताया गया है, तो यह रीडायरेक्ट फ़्लो शुरू करने वाले पिछले पेज से सेव की गई पुष्टि की स्थिति को बदल देगा.Web
import { getAuth, setPersistence, signInWithRedirect, inMemoryPersistence, GoogleAuthProvider } from "firebase/auth"; const auth = getAuth(); setPersistence(auth, inMemoryPersistence) .then(() => { const provider = new GoogleAuthProvider(); // In memory persistence will be applied to the signed in Google user // even though the persistence was set to 'none' and a page redirect // occurred. return signInWithRedirect(auth, provider); }) .catch((error) => { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; });
Web
firebase.auth().setPersistence(firebase.auth.Auth.Persistence.NONE) .then(() => { var provider = new firebase.auth.GoogleAuthProvider(); // In memory persistence will be applied to the signed in Google user // even though the persistence was set to 'none' and a page redirect // occurred. return firebase.auth().signInWithRedirect(provider); }) .catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; });
ब्राउज़र टैब पर, उम्मीद के मुताबिक नतीजे मिलना
अलग-अलग टैब में अलग-अलग तरह के परसिस्टेंस टाइप इस्तेमाल करने पर, यह सामान्य व्यवहार लागू होगा. ज़रूरी शर्त यह है कि किसी भी समय, एक ही तरह की सेव की गई स्थितियों के कई टाइप नहीं होने चाहिए. उदाहरण के लिए, session और local टाइप के स्टोरेज में सेव की गई पुष्टि की स्थिति:
- उपयोगकर्ता, अलग-अलग टैब पर अलग-अलग उपयोगकर्ताओं के साथ
sessionयाnoneपरसिस्टेंस का इस्तेमाल करके साइन इन कर सकते हैं. एक टैब से दूसरे टैब की स्थिति नहीं देखी जा सकती. localपरसिस्टेंस का इस्तेमाल करके साइन इन करने की किसी भी कोशिश का पता लगाया जाएगा और उसे सभी टैब पर सिंक किया जाएगा. अगर उपयोगकर्ता ने पहलेsessionयाnoneपरसिस्टेंस का इस्तेमाल करके किसी खास टैब पर साइन इन किया था, तो वह स्थिति मिटा दी जाएगी.- अगर उपयोगकर्ता ने पहले कई टैब खोलकर,
localपरसिस्टेंस का इस्तेमाल करके साइन इन किया था और फिर किसी एक टैब मेंnoneयाsessionपरसिस्टेंस पर स्विच किया, तो उस टैब की स्थिति में बदलाव किया जाएगा. साथ ही, उपयोगकर्ता कोsessionयाnoneमें बनाए रखा जाएगा. इसके अलावा, अन्य सभी टैब पर, उपयोगकर्ता को साइन आउट कर दिया जाएगा.