Google Identity Services की JavaScript लाइब्रेरी (google.accounts.oauth2) का इस्तेमाल करके, अपने वेब ऐप्लिकेशन में Google API को ऐक्सेस करने की अनुमति देने के लिए, आपको सबसे पहले ये काम करने होंगे:
- OAuth 2.0 क्लाइंट आईडी पाना.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है. साथ ही, स्कोप कॉन्फ़िगर करें.
- क्लाइंट लाइब्रेरी लोड करें.
- इसके अलावा, कॉन्टेंट की सुरक्षा के लिए नीति (सीएसपी) और क्रॉस-ऑरिजिन ओपनर पॉलिसी (सीओओपी) सेट अप करें.
अपना Google API क्लाइंट आईडी पाना
अपनी वेबसाइट पर Google खाते से अनुमति देने की सुविधा चालू करने के लिए, आपको सबसे पहले Google API क्लाइंट आईडी सेट अप करना होगा. यहां बताया गया तरीका अपनाएं:
- Google Cloud Console का क्लाइंट पेज खोलें.
- कोई Cloud Console प्रोजेक्ट बनाएं या चुनें. प्रोडक्शन ऐप्लिकेशन बनाते समय, कई प्रोजेक्ट ज़रूरी हो सकते हैं. मैनेज किए जा रहे हर प्रोजेक्ट के लिए, इस सेक्शन में बचे हुए चरणों को दोहराएं.
- नया क्लाइंट आईडी बनाने के लिए, क्लाइंट बनाएं पर क्लिक करें. इसके बाद, ऐप्लिकेशन टाइप के लिए, वेब ऐप्लिकेशन चुनें. किसी मौजूदा क्लाइंट आईडी का इस्तेमाल करने के लिए, वेब ऐप्लिकेशन टाइप का कोई क्लाइंट आईडी चुनें.
अनुमति वाले JavaScript ऑरिजिन में अपनी वेबसाइट का यूआरआई जोड़ें. यूआरआई में सिर्फ़ स्कीम और पूरी तरह से क्वालिफ़ाइड होस्टनेम शामिल होता है. उदाहरण के लिए,
https://www.example.com.अगर
ux_mode: 'redirect'के साथ ऑथराइज़ेशन कोड मॉडल का इस्तेमाल किया जाता है (या बैकएंड एंडपॉइंट पर ऑथराइज़ेशन कोड एक्सचेंज किए जाते हैं), तो अपने रीडायरेक्ट यूआरआई को अनुमति वाले रीडायरेक्ट यूआरआई में जोड़ें. रीडायरेक्ट यूआरआई में स्कीम, पूरी तरह से क्वालिफ़ाइड होस्टनेम, और पाथ शामिल होता है. साथ ही, यह ज़रूरी है कि रीडायरेक्ट यूआरआई, रीडायरेक्ट यूआरआई की पुष्टि करने के नियमों का पालन करता हो. उदाहरण के लिए,https://www.example.com/oauth2callback.
कॉन्फ़िगरेशन पूरा होने के बाद, जनरेट हुए क्लाइंट आईडी को नोट कर लें.
initCodeClient() या initTokenClient() को शुरू करते समय, आपको यह वैल्यू client_id प्रॉपर्टी में पास करनी होगी. (एक क्लाइंट सीक्रेट भी बनाया जाता है. इसे आपको गोपनीय रखना चाहिए और सिर्फ़ सर्वर-साइड टोकन एक्सचेंज की कार्रवाइयों के लिए इस्तेमाल करना चाहिए.)
ऐसी स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है
जब आपका वेब ऐप्लिकेशन, OAuth 2.0 के दायरों का इस्तेमाल करके उपयोगकर्ता के डेटा को ऐक्सेस करने का अनुरोध करता है, तब Google एक सहमति वाली स्क्रीन दिखाता है. इससे उपयोगकर्ताओं को पता चलता है कि कौनसा ऐप्लिकेशन ऐक्सेस का अनुरोध कर रहा है, डेटा के किन दायरों का अनुरोध किया गया है, और कौनसी शर्तें लागू होती हैं.
- Cloud Console के Google Auth Platform सेक्शन में, ब्रैंडिंग पेज खोलें.
- अगर कहा जाए, तो वह प्रोजेक्ट चुनें जिसे आपने कॉन्फ़िगर किया है.
- ब्रैंडिंग फ़ॉर्म भरें. इसमें ऐप्लिकेशन का नाम, ऐप्लिकेशन का लोगो, सहायता के लिए ईमेल पता, अनुमति वाले डोमेन, ऐप्लिकेशन के होम पेज का लिंक, और निजता नीति का लिंक शामिल है. इसके बाद, सेव करें पर क्लिक करें.
- डेटा ऐक्सेस पेज पर जाएं और अपने ऐप्लिकेशन के लिए ज़रूरी Google API के स्कोप कॉन्फ़िगर करें. सबसे सही तरीका यह है कि ऐक्सेस की ज़रूरत पड़ने पर, स्कोप का अनुरोध धीरे-धीरे किया जाए, न कि पहले ही.
- पुष्टि की स्थिति देखें. अगर आपका ऐप्लिकेशन संवेदनशील या प्रतिबंधित स्कोप का अनुरोध करता है, तो पुष्टि के लिए अपना आवेदन सबमिट करें. ज़्यादा जानकारी के लिए, OAuth से पुष्टि करने की ज़रूरी शर्तें देखें.
कॉन्टेंट की सुरक्षा के लिए नीति और सीओओपी
अगर आपका वेब ऐप्लिकेशन, कॉन्टेंट की सुरक्षा के लिए नीति (सीएसपी) लागू करता है, तो Google Identity Services के इन ऑरिजिन को अनुमति दें:
script-src:https://accounts.google.com/gsi/clientframe-src:https://accounts.google.com/gsi/connect-src:https://accounts.google.com/gsi/
पॉप-अप ऑथराइज़ेशन फ़्लो (initTokenClient या initCodeClient के साथ ux_mode: 'popup') के लिए, अपने Cross-Origin-Opener-Policy (सीओओपी) एचटीटीपी रिस्पॉन्स हेडर को same-origin-allow-popups पर कॉन्फ़िगर करें, ताकि डायलॉग विंडो आपके पेज पर ऑथराइज़ेशन रिस्पॉन्स भेज सके.
अगले चरण
इसके बाद, अपने वेब पेज पर क्लाइंट लाइब्रेरी लोड करें, ताकि अनुमति देने वाले क्लाइंट को शुरू किया जा सके.