GitHub के साथ सिंगल साइन-ऑन
बैलेंस ज़रूरी HTTP टनल
इस पेज पर 4 सेक्शन
विज़िटर को HTTP टनल खोलने से पहले अपने GitHub अकाउंट से साइन इन करने दें। आप GitHub पर एक OAuth ऐप रजिस्टर करते हैं, उसे Localtonet में प्रोवाइडर के रूप में जोड़ते हैं, फिर टनल के लिए चालू करते हैं।
शुरू करने से पहले #
- एक HTTP टनल और आपके अकाउंट में बैलेंस। देखें सिंगल साइन-ऑन का परिचय।
- एक GitHub अकाउंट। किसी संगठन के लिए ऐप रजिस्टर करने हेतु आपको उस संगठन की सेटिंग का एक्सेस चाहिए।
चरण #
-
GitHub पर OAuth ऐप रजिस्टर करें #
GitHub की अपनी गाइड Creating an OAuth app है। संक्षेप में:
- GitHub पर प्रोफ़ाइल फ़ोटो के नीचे का मेनू खोलें और Settings, फिर Developer settings, फिर OAuth apps चुनें।
- New OAuth App चुनें। अगर आपके पास अभी कोई ऐप नहीं है, तो बटन पर Register a new application लिखा होता है।
- नीचे दी गई वैल्यू से फ़ॉर्म भरें और Register application चुनें।
- नए ऐप के पेज पर Client ID कॉपी करें, फिर Generate a new client secret चुनें और सीक्रेट तुरंत कॉपी कर लें।
GitHub फ़ील्ड वैल्यू Application name ऐसा नाम जिसे आपके विज़िटर पहचानें। GitHub उन्हें अनुमति देने को कहते समय यही नाम दिखाता है। Homepage URL ऐसा वेब एड्रेस जो ऐप के बारे में बताए, जैसे आपकी वेबसाइट। Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow इसे बंद रखें। GitHub पर आप स्कोप नहीं चुनते। साइन-इन रिक्वेस्ट उनके नाम देती है:
read:userऔरuser:email। GitHub विज़िटर से पहली बार साइन इन करते समय उन्हें मंज़ूर करने को कहता है। -
Localtonet में प्रोवाइडर जोड़ें #
मेरे टनल › HTTP खोलें और पेज के ऊपर SSO चुनें। SSO प्रोवाइडर डायलॉग में प्रोवाइडर जोड़ें चुनें।
फ़ील्ड वैल्यू प्रोवाइडर का नाम कोई भी नाम, जैसे GitHub। आप इसे टनल सेटिंग में देखते हैं।प्रोवाइडर का प्रकार GitHub। सेव किए हुए प्रोवाइडर का प्रकार बदलने पर Client ID खाली हो जाता है, इसलिए क्लाइंट ID और क्लाइंट सीक्रेट दोबारा लिखें। सक्रिय चालू Client ID GitHub से मिला क्लाइंट ID। Client secret GitHub से मिला क्लाइंट सीक्रेट। सेव करने के बाद यह कभी नहीं दिखता। एंडपॉइंट और कॉलबैक के नीचे GitHub के मानक एड्रेस अपने-आप भर जाते हैं। उन्हें वैसा ही रहने दें:
फ़ील्ड भरी हुई वैल्यू Authorization एंडपॉइंट https://github.com/login/oauth/authorizeToken एंडपॉइंट https://github.com/login/oauth/access_tokenUser info एंडपॉइंट https://api.github.com/userकॉलबैक पाथ /auth/callback/githubचाहें तो ईमेल एक्सेस नियम भरें, फिर प्रोवाइडर सेव करें चुनें।
-
टनल के लिए चालू करें #
आपके टनल में टनल की सेटिंग्स चुनें, फिर SSO प्रोवाइडर के बगल में मैनेज करें। सिंगल साइन-ऑन डायलॉग में साइन-इन ज़रूरी करें और अपने GitHub प्रोवाइडर का स्विच चालू करें। सेव करें चुनें।
GitHub अकाउंट कोई भी बना सकता है। बिना किसी नियम के, एड्रेस जानने वाला हर GitHub यूज़र टनल खोल सकता है। टनल पर कौन साइन इन कर सकता है, या प्रोवाइडर पर अनुमत ईमेल डोमेन भरें। सूचियाँ परिचय में समझाई गई हैं।
-
इसे आज़माएँ #
टनल का URL प्राइवेट ब्राउज़र विंडो में खोलें। Localtonet Sign in to continue दिखाता है, जिसमें आपके प्रोवाइडर का बटन होता है। GitHub पहली बार आपसे ऐप को अनुमति देने को कहता है। उसके बाद आपको वापस टनल पर भेजा जाता है और आपकी सर्विस लोड होती है।
समस्या निवारण #
GitHub रीडायरेक्ट URI मेल न खाने की सूचना देता है
GitHub का एरर redirect_uri_mismatch है: "The redirect_uri MUST match the registered callback URL for this application." OAuth ऐप का कोई भी कॉलबैक URL भेजे गए एड्रेस से मेल नहीं खाता। GitHub पर Authorization callback URL ठीक http://auth.localtonet.com/auth/callback रखें।
विज़िटर का एड्रेस सूची में होने पर भी उसे अस्वीकार किया जाता है
डिफ़ॉल्ट User info एंडपॉइंट, https://api.github.com/user, कोई ईमेल एड्रेस नहीं लौटा सकता, जब GitHub यूज़र ने अपनी प्रोफ़ाइल में पब्लिक ईमेल सेट नहीं किया हो। विज़िटर से कहें कि वह अपनी GitHub प्रोफ़ाइल में देखे कि कौन-सा एड्रेस पब्लिक ईमेल के रूप में सेट है, और उसे आपकी सूचियों से मिलाएँ।
GitHub साइन-इन सफल होने के बाद "403 - Access Denied"
Localtonet के किसी नियम ने अकाउंट को अस्वीकार किया। प्रोवाइडर पर ईमेल एक्सेस नियम और टनल पर कौन साइन इन कर सकता है जाँचें। नियम सुधारने के बाद एक मिनट रुकें और रीलोड करें।
साइन-इन GitHub के अनुमति पेज से पहले या बाद में विफल होता है
Localtonet में सेव किए गए Client ID और Client secret को OAuth ऐप से मिलाएँ। Client ID फिर से पेस्ट करें, GitHub पर नया क्लाइंट सीक्रेट बनाएँ, उसे प्रोवाइडर में पेस्ट करें और प्रोवाइडर सेव करें चुनें।
साइन-इन पेज पर GitHub बटन नहीं है
प्रोवाइडर इस टनल के लिए चालू नहीं है, या निष्क्रिय पर सेट है। दोनों जाँचें।