वेब ऐप्लिकेशन में OpenID Connect का इस्तेमाल करके पुष्टि करें

अगर आपने Firebase Authentication with Identity Platform पर अपग्रेड किया है, तो OpenID Connect (OIDC) के मुताबिक काम करने वाले अपनी पसंद के प्रोवाइडर का इस्तेमाल करके, Firebase से अपने उपयोगकर्ताओं की पुष्टि की जा सकती है. इससे उन आइडेंटिटी प्रोवाइडर का इस्तेमाल किया जा सकता है जो Firebase के साथ काम नहीं करते.

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

OIDC की सेवा देने वाली कंपनी का इस्तेमाल करके उपयोगकर्ताओं को साइन इन कराने के लिए, आपको पहले उस कंपनी से कुछ जानकारी इकट्ठा करनी होगी:

  • क्लाइंट आईडी: यह सेवा देने वाली कंपनी के लिए एक यूनीक स्ट्रिंग होती है, जिससे आपके ऐप्लिकेशन की पहचान की जाती है. सेवा देने वाली कंपनी, आपको हर उस प्लैटफ़ॉर्म के लिए अलग क्लाइंट आईडी असाइन कर सकती है जिस पर आपका ऐप्लिकेशन काम करता है. यह सेवा देने वाली कंपनी की ओर से जारी किए गए आईडी टोकन में, aud दावे की वैल्यू में से एक है.

  • क्लाइंट सीक्रेट: यह एक सीक्रेट स्ट्रिंग होती है. इसका इस्तेमाल करके, सेवा देने वाली कंपनी किसी क्लाइंट आईडी के मालिकाना हक की पुष्टि करती है. हर क्लाइंट आईडी के लिए, आपको उससे मैच होने वाला क्लाइंट सीक्रेट चाहिए होगा. (यह वैल्यू सिर्फ़ तब ज़रूरी है, जब ऑथराइज़ेशन कोड फ़्लो का इस्तेमाल किया जा रहा हो. हमारा सुझाव है कि आप इसका इस्तेमाल ज़रूर करें.)

  • Issuer: यह एक स्ट्रिंग होती है, जिससे सेवा देने वाली कंपनी की पहचान की जाती है. यह वैल्यू एक ऐसा यूआरएल होना चाहिए जिसे /.well-known/openid-configuration के साथ जोड़ने पर, सेवा देने वाली कंपनी के ओआईडीसी खोज से जुड़े दस्तावेज़ की जगह की जानकारी मिलती हो. उदाहरण के लिए, अगर जारी करने वाला https://auth.example.com है, तो खोज से जुड़ा दस्तावेज़ https://auth.example.com/.well-known/openid-configuration पर उपलब्ध होना चाहिए.

ऊपर दी गई जानकारी मिलने के बाद, अपने Firebase प्रोजेक्ट के लिए साइन-इन की सुविधा देने वाली सेवा के तौर पर, OpenID Connect को चालू करें:

  1. अपने JavaScript प्रोजेक्ट में Firebase जोड़ें.

  2. अगर आपने Firebase Authentication with Identity Platform पर अपग्रेड नहीं किया है, तो ऐसा करें. OpenID Connect की मदद से पुष्टि करने की सुविधा, सिर्फ़ अपग्रेड किए गए प्रोजेक्ट में उपलब्ध है.

  3. Firebase कंसोल में, सुरक्षा > पुष्टि करना पर जाएं.

  4. साइन-इन का तरीका टैब में, नया प्रोवाइडर जोड़ें पर क्लिक करें. इसके बाद, OpenID Connect पर क्लिक करें.

  5. चुनें कि आपको ऑथराइज़ेशन कोड फ़्लो का इस्तेमाल करना है या इंप्लिसिट ग्रांट फ़्लो का.

    अगर सेवा देने वाली कंपनी कोड फ़्लो का इस्तेमाल करने की सुविधा देती है, तो आपको हमेशा इसका इस्तेमाल करना चाहिए. इंप्लिसिट फ़्लो कम सुरक्षित होता है. इसलिए, इसका इस्तेमाल करने का सुझाव नहीं दिया जाता.

  6. इस प्रोवाइडर को कोई नाम दें. जनरेट किए गए प्रोवाइडर आईडी को नोट करें: यह oidc.example-provider जैसा दिखता है. अपने ऐप्लिकेशन में साइन-इन कोड जोड़ते समय, आपको इस आईडी की ज़रूरत होगी.

  7. अपना क्लाइंट आईडी और क्लाइंट सीक्रेट डालें. साथ ही, सेवा देने वाली कंपनी की जारीकर्ता स्ट्रिंग डालें. ये वैल्यू, सेवा देने वाली कंपनी की ओर से आपको असाइन की गई वैल्यू से पूरी तरह से मेल खानी चाहिए.

  8. बदलावों को सेव करें.

Firebase SDK टूल की मदद से, साइन-इन फ़्लो को मैनेज करना

अपने ओआईडीसी प्रोवाइडर का इस्तेमाल करके, Firebase के साथ अपने उपयोगकर्ताओं की पुष्टि करने का सबसे आसान तरीका है कि Firebase SDK टूल की मदद से, साइन-इन करने की पूरी प्रोसेस को मैनेज किया जाए.

Firebase JavaScript SDK की मदद से साइन-इन फ़्लो को मैनेज करने के लिए, यह तरीका अपनाएं:

  1. Firebase कंसोल में मिले प्रोवाइडर आईडी का इस्तेमाल करके, OAuthProvider का इंस्टेंस बनाएं.

    Web

    import { OAuthProvider } from "firebase/auth";
    
    const provider = new OAuthProvider('oidc.example-provider');
    

    Web

    var provider = new firebase.auth.OAuthProvider('oidc.example-provider');
    
  2. ज़रूरी नहीं: OAuth अनुरोध के साथ भेजे जाने वाले, पसंद के मुताबिक बनाए गए अतिरिक्त OAuth पैरामीटर की जानकारी दें.

    Web

    provider.setCustomParameters({
      // Target specific email with login hint.
      login_hint: 'user@example.com'
    });
    

    Web

    provider.setCustomParameters({
      // Target specific email with login hint.
      login_hint: 'user@example.com'
    });
    

    सेवा देने वाली कंपनी से संपर्क करके, यह पता करें कि वह किन पैरामीटर के साथ काम करती है. ध्यान दें कि setCustomParameters के साथ, Firebase के लिए ज़रूरी पैरामीटर पास नहीं किए जा सकते. ये पैरामीटर हैं: client_id, response_type, redirect_uri, state, scope, और response_mode.

  3. ज़रूरी नहीं: पुष्टि करने वाली सेवा देने वाली कंपनी से, बुनियादी प्रोफ़ाइल के अलावा OAuth 2.0 के अन्य दायरों का अनुरोध करें.

    Web

    provider.addScope('mail.read');
    provider.addScope('calendars.read');
    

    Web

    provider.addScope('mail.read');
    provider.addScope('calendars.read');
    

    अपनी सेवा देने वाली कंपनी से संपर्क करके, यह पता करें कि वह किन स्कोप के साथ काम करती है.

  4. OAuth प्रोवाइडर ऑब्जेक्ट का इस्तेमाल करके, Firebase से पुष्टि करें.

    उपयोगकर्ता को सेवा देने वाली कंपनी के साइन-इन पेज पर रीडायरेक्ट किया जा सकता है या साइन-इन पेज को पॉप-अप ब्राउज़र विंडो में खोला जा सकता है.

    रीडायरेक्ट फ़्लो

    signInWithRedirect() को कॉल करके, सेवा देने वाली कंपनी के साइन-इन पेज पर रीडायरेक्ट करें:

    Web

    import { getAuth, signInWithRedirect } from "firebase/auth";
    
    const auth = getAuth();
    signInWithRedirect(auth, provider);
    

    Web

    firebase.auth().signInWithRedirect(provider);
    

    जब उपयोगकर्ता साइन-इन की प्रोसेस पूरी कर लेता है और आपके ऐप्लिकेशन पर वापस आता है, तो getRedirectResult() को कॉल करके साइन-इन का नतीजा पाया जा सकता है.

    Web

    import { getAuth, getRedirectResult, OAuthProvider } from "firebase/auth";
    
    const auth = getAuth();
    getRedirectResult(auth)
      .then((result) => {
        // User is signed in.
        // IdP data available in result.additionalUserInfo.profile.
    
        // Get the OAuth access token and ID Token
        const credential = OAuthProvider.credentialFromResult(result);
        const accessToken = credential.accessToken;
        const idToken = credential.idToken;
      })
      .catch((error) => {
        // Handle error.
      });
    

    Web

    firebase.auth().getRedirectResult()
      .then((result) => {
        // IdP data available in result.additionalUserInfo.profile.
        // ...
    
        /** @type {firebase.auth.OAuthCredential} */
        var credential = result.credential;
    
        // OAuth access and id tokens can also be retrieved:
        var accessToken = credential.accessToken;
        var idToken = credential.idToken;
      })
      .catch((error) => {
        // Handle error.
      });
    

    पॉप-अप फ़्लो

    Web

    import { getAuth, signInWithPopup, OAuthProvider } from "firebase/auth";
    
    const auth = getAuth();
    signInWithPopup(auth, provider)
      .then((result) => {
        // User is signed in.
        // IdP data available using getAdditionalUserInfo(result)
    
        // Get the OAuth access token and ID Token
        const credential = OAuthProvider.credentialFromResult(result);
        const accessToken = credential.accessToken;
        const idToken = credential.idToken;
      })
      .catch((error) => {
        // Handle error.
      });
    

    Web

    firebase.auth().signInWithPopup(provider)
      .then((result) => {
        // IdP data available in result.additionalUserInfo.profile.
        // ...
    
        /** @type {firebase.auth.OAuthCredential} */
        var credential = result.credential;
    
        // OAuth access and id tokens can also be retrieved:
        var accessToken = credential.accessToken;
        var idToken = credential.idToken;
      })
      .catch((error) => {
        // Handle error.
      });
    
  5. ऊपर दिए गए उदाहरण, साइन-इन करने के फ़्लो पर फ़ोकस करते हैं. हालांकि, linkWithRedirect() और linkWithPopup() का इस्तेमाल करके, किसी ओआईडीसी प्रोवाइडर को मौजूदा उपयोगकर्ता से लिंक करने के लिए भी इसी पैटर्न का इस्तेमाल किया जा सकता है. साथ ही, reauthenticateWithRedirect() और reauthenticateWithPopup() का इस्तेमाल करके, किसी उपयोगकर्ता की फिर से पुष्टि की जा सकती है. इसका इस्तेमाल, संवेदनशील कार्रवाइयों के लिए नए क्रेडेंशियल पाने के लिए किया जा सकता है. इन कार्रवाइयों के लिए, हाल ही में लॉगिन करना ज़रूरी होता है.

साइन-इन फ़्लो को मैन्युअल तरीके से मैनेज करना

अगर आपने अपने ऐप्लिकेशन में OpenID Connect साइन-इन फ़्लो पहले से ही लागू किया हुआ है, तो Firebase से पुष्टि करने के लिए, आईडी टोकन का सीधे तौर पर इस्तेमाल किया जा सकता है:

Web

import { getAuth, signInWithCredential, OAuthProvider } from "firebase/auth";

const provider = new OAuthProvider("oidc.example-provider");
const credential = provider.credential({
    idToken: idToken,
});
signInWithCredential(getAuth(), credential)
    .then((result) => {
        // User is signed in.
        // IdP data available in result.additionalUserInfo.profile.

        // Get the OAuth access token and ID Token
        const credential = OAuthProvider.credentialFromResult(result);
        const accessToken = credential.accessToken;
        const idToken = credential.idToken;
    })
    .catch((error) => {
        // Handle error.
    });

Web

const provider = new OAuthProvider("oidc.example-provider");
const credential = provider.credential({
    idToken: idToken,
});
firebase.auth().signInWithCredential(credential)
    .then((result) => {
        // User is signed in.
        // IdP data available in result.additionalUserInfo.profile.

        // Get the OAuth access token and ID Token
        const credential = OAuthProvider.credentialFromResult(result);
        const accessToken = credential.accessToken;
        const idToken = credential.idToken;
    })
    .catch((error) => {
        // Handle error.
    });