HTTP टनल के लिए सिंगल साइन-ऑन
बैलेंस ज़रूरी HTTP टनल
इस पेज पर 10 सेक्शन
सिंगल साइन-ऑन (SSO) HTTP टनल के सामने एक साइन-इन पेज लगा देता है। कोई भी अनुरोध आपकी सेवा तक पहुँचने से पहले विज़िटर को आपके चुने हुए आइडेंटिटी प्रोवाइडर, जैसे Google, GitHub, Microsoft या GitLab, से या आपके तय किए यूज़रनेम और पासवर्ड से साइन इन करना होता है।
इसे कब इस्तेमाल करें #
जब तक आप सुरक्षा न लगाएँ, HTTP टनल उस हर व्यक्ति के लिए खुला रहता है जिसके पास उसका पता है। SSO तब सही सुरक्षा है जब लोग टनल को ब्राउज़र में खोलते हैं और आप तय करना चाहते हैं कि वे कौन हों: एडमिन पैनल, डैशबोर्ड, इंटरनल टूल, स्टेजिंग साइट। आपकी सेवा में कोई बदलाव नहीं होता और उसे कभी पासवर्ड दिखता भी नहीं।
SSO ब्राउज़र के लिए बना है। जिस अनुरोध में साइन-इन कुकी नहीं होती उसे साइन-इन पेज पर रीडायरेक्ट कर दिया जाता है, इसलिए स्क्रिप्ट, वेबहुक और API क्लाइंट पार नहीं हो सकते। उनके लिए केवल कुछ पाथ सुरक्षित करें (देखें साइन-इन पाथ) या एक्सेस कंट्रोल के विकल्प इस्तेमाल करें।
यह कैसे काम करता है #
- कोई विज़िटर टनल का URL खोलता है। HTTP पर आया अनुरोध पहले HTTPS पर रीडायरेक्ट किया जाता है।
- विज़िटर अभी साइन इन नहीं है, इसलिए Localtonet सर्वर ब्राउज़र को
auth.localtonet.comपर साइन-इन पेज पर रीडायरेक्ट करता है। पेज का शीर्षक Sign in to continue है और वह इस टनल के लिए आपके चालू किए प्रोवाइडर दिखाता है। - विज़िटर एक प्रोवाइडर चुनता है और वहाँ साइन इन करता है। यूज़रनेम और पासवर्ड वाले प्रोवाइडर के लिए फ़ॉर्म साइन-इन पेज पर ही होता है।
- Localtonet आपके एक्सेस नियम जाँचता है और विज़िटर को उसी पते पर वापस भेज देता है जो उसने माँगा था। साइन-इन टनल के होस्ट नाम की एक कुकी में रखा जाता है। यह ब्राउज़र-सेशन कुकी है, जो केवल HTTPS पर भेजी जाती है।
- इसके बाद अनुरोध पहले की तरह आपकी सेवा को फ़ॉरवर्ड होते हैं। जब साइन-इन मान्य नहीं रहता, तो विज़िटर को फिर से साइन-इन पेज पर भेजा जाता है।
जो विज़िटर साइन इन तो कर लेता है लेकिन आपके नियमों से अनुमत नहीं है, उसे 403 - Access Denied दिखता है, जिसके साथ "You do not have permission to access this tunnel." लिखा होता है।
/.well-known के नीचे के पाथ कभी साइन-इन के पीछे नहीं रखे जाते।
शुरू करने से पहले #
- एक HTTP टनल। देखें HTTP / HTTPS।
- आपके खाते में बैलेंस। इसके बिना प्रोवाइडर सेव करना या साइन-इन चालू करना "इस फ़ीचर का इस्तेमाल करने के लिए आपको बैलेंस खरीदना होगा।" के साथ विफल हो जाता है। देखें प्लान और बैलेंस और कीमतें।
- बाहरी प्रोवाइडर के लिए: वहाँ ऐसा खाता जिसमें आप OAuth एप्लिकेशन रजिस्टर कर सकें।
SSO आपके निजी डैशबोर्ड में सेट किया जाता है। टीम टनल के लिए SSO बटन और SSO प्रोवाइडर सेटिंग नहीं दिखाई जाती।
प्रोवाइडर #
ये गाइड सबसे आम विकल्पों को चरण-दर-चरण समझाती हैं:
डैशबोर्ड की प्रोवाइडर का प्रकार सूची में ये हैं: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon और Yahoo। Username-Password और Custom को छोड़कर हर प्रकार के एंडपॉइंट आपके लिए पहले से भरे होते हैं। OpenID Connect के लिए भरे हुए पते उदाहरण हैं, जिन्हें आप अपने प्रोवाइडर के एंडपॉइंट से बदलें।
सेट अप करें #
इसके दो हिस्से हैं। आप एक बार प्रोवाइडर जोड़ते हैं, और फिर वह आपके सभी HTTP टनल के लिए उपलब्ध हो जाता है। उसके बाद आप उसे हर उस टनल के लिए चालू करते हैं जिसे सुरक्षित करना है। सेव किया हुआ प्रोवाइडर तब तक कुछ सुरक्षित नहीं करता जब तक कोई टनल उसे इस्तेमाल न करे।
-
प्रोवाइडर जोड़ें #
मेरे टनल › HTTP खोलें और पेज के ऊपर SSO चुनें (इसका टूलटिप SSO प्रोवाइडर सेटिंग्स है)। SSO प्रोवाइडर डायलॉग खुलता है। प्रोवाइडर जोड़ें चुनें, फ़ॉर्म भरें और प्रोवाइडर सेव करें चुनें। हर प्रोवाइडर अलग से सेव होता है।
फ़ील्ड यह क्या है नोट प्रोवाइडर का नाम आपकी टनल सेटिंग्स में इस प्रोवाइडर की पहचान के लिए एक नाम। ज़रूरी। उदाहरण के लिए Company Google।प्रोवाइडर का प्रकार साइन-इन का तरीका। नया प्रोवाइडर Google से शुरू होता है। सेव किए हुए प्रोवाइडर का प्रकार बदलने पर Client ID खाली हो जाता है, इसलिए client ID और client secret फिर से दर्ज करें। सक्रिय प्रोवाइडर को टनल के लिए उपलब्ध कराता है। जब आप प्रोवाइडर को निष्क्रिय करके सेव करते हैं, तो वह उन सभी टनल पर भी बंद हो जाता है जो उसे इस्तेमाल करते थे। Client ID उस एप्लिकेशन की ID जिसे आपने प्रोवाइडर पर रजिस्टर किया। Username-Password और Custom को छोड़कर हर प्रकार के लिए ज़रूरी। Client secret उस एप्लिकेशन का सीक्रेट। सेव करने के बाद कभी नहीं दिखाया जाता। बाद में सेव किया हुआ सीक्रेट रखने के लिए इसे खाली छोड़ दें। एंडपॉइंट और कॉलबैक Authorization एंडपॉइंट, Token एंडपॉइंट, User info एंडपॉइंट और कॉलबैक पाथ। स्टैंडर्ड प्रोवाइडर के लिए अपने आप भरे जाते हैं। इन्हें तभी बदलें जब कोई गाइड कहे। ईमेल एक्सेस नियम अनुमत ईमेल डोमेन, ब्लॉक किए गए ईमेल डोमेन और ब्लॉक किए गए ईमेल पते। वैकल्पिक। देखें एक्सेस नियम। साइन-इन यूज़र यूज़रनेम और पासवर्ड। केवल Username-Password और Custom प्रकारों के लिए। प्रोवाइडर हटाने के लिए प्रोवाइडर हटाएँ चुनें। इससे वह आपके खाते से और आपके टनल की SSO सेटिंग्स से हट जाता है।
-
टनल के लिए चालू करें #
आपके टनल के नीचे टनल पर सेटिंग्स चुनें। टनल सेटिंग्स पैनल में SSO प्रोवाइडर खोजें और मैनेज करें चुनें। सिंगल साइन-ऑन डायलॉग खुलता है।
सेटिंग यह क्या करता है साइन-इन ज़रूरी करें इस टनल के लिए SSO चालू करता है। जो विज़िटर साइन इन नहीं हैं उन्हें पहले साइन-इन पेज पर भेजा जाता है। प्रोवाइडर आपके हर सक्रिय प्रोवाइडर के लिए एक स्विच। कम से कम एक चालू करें। अगर कई चालू हैं, तो विज़िटर साइन-इन पेज पर चुनता है। कौन साइन इन कर सकता है इस टनल के लिए ईमेल पते, ईमेल डोमेन और यूज़रनेम की वैकल्पिक सूचियाँ। साइन-इन और साइन-आउट पाथ वैकल्पिक साइन-इन पाथ और एक साइन-आउट पाथ। सेव करें चुनें।
-
इसे आज़माएँ #
टनल का URL प्राइवेट ब्राउज़र विंडो में खोलें। आपको Sign in to continue पेज पर पहुँचना चाहिए, और साइन इन के बाद आपकी सेवा पर।
रीडायरेक्ट URI #
बाहरी प्रोवाइडर पूछता है कि साइन इन के बाद वह लोगों को कहाँ भेज सकता है। हर टनल के लिए यह Localtonet के साइन-इन होस्ट का एक पता होता है, आपके टनल का पता नहीं। ठीक यही मान रजिस्टर करें:
http://auth.localtonet.com/auth/callbackहर प्रोवाइडर गाइड बताती है कि इसे कहाँ दर्ज करना है।
| मान | यह कहाँ जाता है |
|---|---|
| ऊपर दिया गया रीडायरेक्ट URI | प्रोवाइडर पर: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab)। |
कॉलबैक पाथ, उदाहरण के लिए /auth/callback/google | Localtonet में एंडपॉइंट और कॉलबैक के नीचे। यह आपके लिए भरा होता है। इसे जैसा है वैसा रहने दें। |
प्रोवाइडर रीडायरेक्ट URI की तुलना रजिस्टर किए मान से हूबहू करता है, इसलिए इसे वैसे ही कॉपी करें जैसा यहाँ दिखाया गया है।
एक्सेस नियम #
साइन इन करने से साबित होता है कि विज़िटर कौन है। नियम तय करते हैं कि वह व्यक्ति टनल खोल सकता है या नहीं। दो स्तर हैं, और दोनों लागू होते हैं।
| कहाँ | सूची | डैशबोर्ड क्या कहता है |
|---|---|---|
| प्रोवाइडर | अनुमत ईमेल डोमेन | डोमेन पर कोई पाबंदी न चाहिए तो खाली छोड़ें। वाइल्डकार्ड प्रोवाइडर पर निर्भर करते हैं। |
| प्रोवाइडर | ब्लॉक किए गए ईमेल डोमेन | इन ईमेल डोमेन से साइन-इन ब्लॉक करें। |
| प्रोवाइडर | ब्लॉक किए गए ईमेल पते | इन अलग-अलग ईमेल पतों को ब्लॉक करें। |
| टनल | ईमेल पते, ईमेल डोमेन, यूज़रनेम | वह जाँच छोड़ने के लिए सूची खाली छोड़ें। सूचियाँ टनल पर चालू सभी प्रोवाइडर पर लागू होती हैं। |
हर पंक्ति में एक आइटम दर्ज करें, या आइटम को कॉमा से अलग करें। डोमेन @ के बिना दर्ज किया जाता है, उदाहरण के लिए example.com।
नियम बदलने के बाद, जिस विज़िटर को पहले ही अंदर आने दिया गया था उसकी पहुँच पाँच मिनट तक बनी रह सकती है। जिस विज़िटर को मना किया गया था उसे एक मिनट बाद फिर से जाँचा जाता है।
साइन-इन पाथ और साइन-आउट पाथ #
| सेटिंग | व्यवहार | उदाहरण |
|---|---|---|
| साइन-इन पाथ | खाली: टनल के हर पाथ के लिए साइन-इन चाहिए। भरा हुआ: केवल उन अनुरोधों के लिए साइन-इन चाहिए जिनका पाथ किसी एक एंट्री से शुरू होता है। | /admin में /admin और /admin/users आते हैं, /administrator नहीं। |
| साइन-आउट पाथ | इसे खोलने से इस टनल का साइन-इन हट जाता है और विज़िटर टनल के स्टार्ट पेज पर, या returnUrl क्वेरी वैल्यू के पते पर भेज दिया जाता है। | /sso/logout |
पाथ स्लैश से शुरू होते हैं। अपरकेस और लोअरकेस में कोई फ़र्क नहीं पड़ता।
भरी हुई साइन-इन पाथ सूची बाकी सब कुछ खुला छोड़ देती है। सूची में /admin होने पर केवल /admin सुरक्षित रहता है और बाकी सभी पाथ बिना साइन-इन के पहुँच में रहते हैं। पूरे टनल को सुरक्षित करने के लिए सूची खाली छोड़ें।
साइन-आउट पाथ विज़िटर को केवल टनल से साइन आउट करता है। वह उसे Google, GitHub या किसी और आइडेंटिटी प्रोवाइडर से साइन आउट नहीं करता।
समस्या निवारण #
"इस फ़ीचर का इस्तेमाल करने के लिए आपको बैलेंस खरीदना होगा।"
SSO के लिए बैलेंस चाहिए। बैलेंस जोड़ें, फिर दोबारा सेव करें। बैलेंस के बिना भी आप डायलॉग खोलकर साइन-इन ज़रूरी करें को बंद कर सकते हैं।
"साइन-इन चालू करने से पहले प्रोवाइडर जोड़ें।"
आपके पास अभी कोई सक्रिय प्रोवाइडर नहीं है। डायलॉग में प्रोवाइडर जोड़ें चुनें, या HTTP पेज के ऊपर SSO बटन इस्तेमाल करें।
"कम से कम एक प्रोवाइडर चालू करें, या साइन-इन बंद करें।"
साइन-इन ज़रूरी करें चालू है लेकिन कोई प्रोवाइडर स्विच चालू नहीं है। जिस प्रोवाइडर को आप निष्क्रिय करते हैं वह अपने टनल पर बंद हो जाता है और सूची में नहीं दिखता।
साइन-इन पेज पर "No authentication providers are currently configured for this tunnel." लिखा आता है।
साइन-इन ज़रूरी है, लेकिन इस टनल के लिए कोई प्रोवाइडर चालू नहीं है। टनल पर SSO प्रोवाइडर › मैनेज करें खोलें और एक चालू करें।
टनल बिना साइन-इन माँगे खुल जाता है
जाँचें कि साइन-इन ज़रूरी करें चालू है और सेव किया गया है। अगर साइन-इन पाथ भरा है, तो केवल वही पाथ सुरक्षित हैं। प्राइवेट विंडो में भी जाँचें: आपका अपना ब्राउज़र अभी भी साइन इन हो सकता है।
साइन इन के बाद "403 - Access Denied"
साइन-इन सफल रहा, लेकिन किसी नियम ने खाते को मना कर दिया। प्रोवाइडर के ईमेल एक्सेस नियम और टनल की कौन साइन इन कर सकता है सूचियाँ जाँचें। नियम सुधारने के बाद एक मिनट रुकें और पेज फिर से लोड करें।
वेबहुक या API क्लाइंट को जवाब की जगह रीडायरेक्ट मिलता है
साइन-इन कुकी के बिना आए अनुरोध साइन-इन पेज पर रीडायरेक्ट हो जाते हैं। साइन-इन पाथ में केवल वही पेज रखें जो लोगों के लिए हैं, या मशीनी ट्रैफ़िक के लिए अलग टनल इस्तेमाल करें।
ऑटोमेशन #
प्रोवाइडर और टनल की SSO सेटिंग्स API से, /api/v2/sso-providers के नीचे, और MCP सर्वर से भी मैनेज की जा सकती हैं।