GitLab के साथ सिंगल साइन-ऑन
बैलेंस ज़रूरी HTTP टनल
इस पेज पर 4 सेक्शन
विज़िटर को HTTP टनल खोलने से पहले अपने GitLab अकाउंट से साइन इन कराएँ। यह GitLab.com और सेल्फ़-मैनेज्ड GitLab इंस्टेंस दोनों के साथ काम करता है। आप GitLab में एक OAuth एप्लिकेशन बनाते हैं, उसे Localtonet में प्रोवाइडर के रूप में जोड़ते हैं, फिर टनल के लिए चालू करते हैं।
शुरू करने से पहले #
- एक HTTP टनल और आपके अकाउंट में बैलेंस। देखें सिंगल साइन-ऑन अवलोकन।
- GitLab.com पर या आपके अपने इंस्टेंस पर एक GitLab अकाउंट।
- सेल्फ़-मैनेज्ड इंस्टेंस के लिए: उसका पता इंटरनेट से पहुँच में होना चाहिए। आपके विज़िटर के ब्राउज़र उसका साइन-इन पेज खोलते हैं, और Localtonet का साइन-इन होस्ट उसके टोकन और यूज़र एंडपॉइंट को सीधे कॉल करता है।
चरण #
-
GitLab में OAuth एप्लिकेशन बनाएँ #
GitLab की अपनी गाइड Configure GitLab as an OAuth 2.0 authentication identity provider है। एप्लिकेशन किसी यूज़र, ग्रुप या पूरे इंस्टेंस का हो सकता है:
मालिक कहाँ बनाएँ आपका यूज़र अपना अवतार चुनें, फिर Edit profile, फिर Access › Applications और Add new application। एक ग्रुप ग्रुप खोलें, फिर Settings › Applications। इंस्टेंस (सेल्फ़-मैनेज्ड, सिर्फ़ एडमिनिस्ट्रेटर) Admin › Applications और New application। फ़ॉर्म भरें और Save application चुनें:
GitLab फ़ील्ड मान Name ऐसा नाम जिसे आपके विज़िटर पहचानें। GitLab उन्हें अनुमति देने को कहते समय इसे दिखाता है। Redirect URI http://auth.localtonet.com/auth/callbackConfidential इसे चुना हुआ रहने दें। Scopes read_userGitLab फिर Application ID और Secret दिखाता है। दोनों तुरंत कॉपी कर लें: GitLab सीक्रेट सिर्फ़ एप्लिकेशन बनने के तुरंत बाद दिखाता है।
read_userस्कोप/api/v4/userएंडपॉइंट के ज़रिए साइन इन यूज़र की प्रोफ़ाइल को पढ़ने की पहुँच देता है, जो वही User info एंडपॉइंट है जिसे Localtonet भरता है। साइन-इन सिर्फ़ यही स्कोप माँगता है, इसलिए एप्लिकेशन को किसी और स्कोप की ज़रूरत नहीं। -
Localtonet में प्रोवाइडर जोड़ें #
मेरे टनल › HTTP खोलें और पेज के ऊपर SSO चुनें। SSO प्रोवाइडर डायलॉग में प्रोवाइडर जोड़ें चुनें।
फ़ील्ड मान प्रोवाइडर का नाम कोई भी नाम, जैसे Company GitLab। आप इसे टनल सेटिंग्स में देखते हैं।प्रोवाइडर का प्रकार GitLab। सेव किए गए प्रोवाइडर का प्रकार बदलने से Client ID खाली हो जाता है, इसलिए क्लाइंट ID और क्लाइंट सीक्रेट फिर से दर्ज करें। सक्रिय चालू Client ID GitLab का Application ID। Client secret GitLab का Secret। सेव करने के बाद यह कभी नहीं दिखाया जाता। एंडपॉइंट और कॉलबैक खोलें। GitLab.com के पते अपने आप भर जाते हैं। सेल्फ़-मैनेज्ड इंस्टेंस के लिए, पहले तीन फ़ील्ड में
gitlab.comकी जगह अपने इंस्टेंस का होस्ट नाम डालें।GitLab.com
फ़ील्ड भरा हुआ मान Authorization एंडपॉइंट https://gitlab.com/oauth/authorizeToken एंडपॉइंट https://gitlab.com/oauth/tokenUser info एंडपॉइंट https://gitlab.com/api/v4/userकॉलबैक पाथ /auth/callback/gitlabसेल्फ़-मैनेज्ड
फ़ील्ड दर्ज करने का मान Authorization एंडपॉइंट https://<YOUR_GITLAB_HOST>/oauth/authorizeToken एंडपॉइंट https://<YOUR_GITLAB_HOST>/oauth/tokenUser info एंडपॉइंट https://<YOUR_GITLAB_HOST>/api/v4/userकॉलबैक पाथ /auth/callback/gitlab(बिना बदलाव)GitLab एप्लिकेशन का Redirect URI चरण 1 वाला Localtonet पता ही रहता है। उसमें आपका GitLab होस्ट नहीं होता।
चाहें तो ईमेल एक्सेस नियम भरें, फिर प्रोवाइडर सेव करें चुनें।
-
टनल के लिए चालू करें #
आपके टनल के अंतर्गत टनल पर सेटिंग्स चुनें, फिर SSO प्रोवाइडर के बगल में मैनेज करें। सिंगल साइन-ऑन डायलॉग में साइन-इन ज़रूरी करें और अपने GitLab प्रोवाइडर का स्विच चालू करें। सेव करें चुनें।
GitLab.com पर कोई भी अकाउंट बना सकता है। नियम के बिना, पता जानने वाला हर GitLab.com यूज़र टनल खोल सकता है। टनल पर कौन साइन इन कर सकता है भरें, या प्रोवाइडर पर अनुमत ईमेल डोमेन। सूचियाँ अवलोकन में समझाई गई हैं।
-
इसे आज़माएँ #
टनल URL को प्राइवेट ब्राउज़र विंडो में खोलें। Localtonet Sign in to continue दिखाता है, जिसमें आपके प्रोवाइडर का बटन होता है। GitLab पहली बार आपसे एप्लिकेशन को अनुमति देने को कहता है। उसके बाद आपको टनल पर वापस भेज दिया जाता है और आपकी सर्विस लोड होती है।
समस्या निवारण #
GitLab कहता है कि शामिल redirect URI मान्य नहीं है
GitLab एप्लिकेशन का कोई Redirect URI भेजे गए पते से मेल नहीं खाता। एप्लिकेशन के Redirect URI के रूप में ठीक http://auth.localtonet.com/auth/callback दर्ज करें।
GitLab कहता है कि माँगा गया स्कोप अमान्य, अज्ञात या गलत बनावट का है
माँगा गया कोई स्कोप GitLab एप्लिकेशन में चुना नहीं गया है। एप्लिकेशन को एडिट करें और read_user चुनें।
GitLab कहता है कि क्लाइंट ऑथेंटिकेशन विफल रहा
Localtonet में सेव किया Client ID या Client secret GitLab एप्लिकेशन से मेल नहीं खाता। Application ID और Secret फिर से पेस्ट करें और प्रोवाइडर सेव करें चुनें। अगर आप GitLab में सीक्रेट रिन्यू करते हैं, तो नया सीक्रेट Localtonet में सेव करने तक एप्लिकेशन काम करना बंद कर देता है।
सेल्फ़-मैनेज्ड इंस्टेंस से साइन-इन कभी पूरा नहीं होता
तीनों एंडपॉइंट में टाइपिंग की गलतियाँ जाँचें और सुनिश्चित करें कि इंस्टेंस इंटरनेट से जवाब देता है। अगर वह HTTPS इस्तेमाल करता है, तो उसे ऐसा सर्टिफ़िकेट चाहिए जिस पर सार्वजनिक क्लाइंट भरोसा करें। जो इंस्टेंस सिर्फ़ आपके नेटवर्क के अंदर पहुँच में है, उसे इस्तेमाल नहीं किया जा सकता।
सफल GitLab साइन-इन के बाद "403 - Access Denied"
किसी Localtonet नियम ने अकाउंट को अस्वीकार कर दिया। प्रोवाइडर पर ईमेल एक्सेस नियम और टनल पर कौन साइन इन कर सकता है जाँचें। नियम सुधारने के बाद एक मिनट रुकें और रीलोड करें।
साइन-इन पेज पर GitLab बटन नहीं है
प्रोवाइडर इस टनल के लिए चालू नहीं है, या निष्क्रिय पर सेट है। दोनों जाँचें।