Microsoft के साथ सिंगल साइन-ऑन
बैलेंस ज़रूरी HTTP टनल
इस पेज पर 6 सेक्शन
विज़िटर को HTTP टनल खोलने से पहले Microsoft Entra ID के वर्क या स्कूल अकाउंट, या निजी Microsoft अकाउंट से साइन इन करने दें। आप Microsoft Entra में एक एप्लिकेशन रजिस्टर करते हैं, उसे Localtonet में प्रोवाइडर के रूप में जोड़ते हैं, फिर टनल के लिए चालू करते हैं।
शुरू करने से पहले #
- एक HTTP टनल और आपके अकाउंट में बैलेंस। देखें सिंगल साइन-ऑन का परिचय।
- Microsoft Entra admin center का एक्सेस, ऐसी भूमिका के साथ जो एप्लिकेशन रजिस्टर कर सके। Microsoft न्यूनतम भूमिका Application Developer बताता है।
- यह तय करना कि कौन साइन इन कर सकता है: सिर्फ़ आपका संगठन, कोई भी संगठन, या निजी अकाउंट भी। इससे Localtonet में लिखे जाने वाले दो एड्रेस तय होते हैं। देखें अकाउंट टाइप और एंडपॉइंट।
चरण #
-
Microsoft Entra में एप्लिकेशन रजिस्टर करें #
Microsoft की अपनी गाइड ये हैं: Register an app in Microsoft Entra ID, Add a redirect URI और Add app credentials। संक्षेप में:
- Microsoft Entra admin center में Entra ID › App registrations पर जाएँ और New registration चुनें।
- Name लिखें। साइन इन करते समय विज़िटर इसे देखते हैं।
- Supported account types में चुनें कि एप्लिकेशन कौन इस्तेमाल कर सकता है, फिर Register चुनें।
- Overview पेज पर Application (client) ID कॉपी करें। सिंगल-टेनेंट एप्लिकेशन के लिए Directory (tenant) ID भी कॉपी करें।
- Manage के नीचे Authentication खोलें, Add Redirect URI चुनें, Web प्लेटफ़ॉर्म चुनें, नीचे दिया गया रीडायरेक्ट URI लिखें और Configure चुनें।
- Certificates & secrets › Client secrets खोलें और New client secret चुनें। विवरण जोड़ें, समाप्ति अवधि चुनें और Add चुनें। सीक्रेट की Value तुरंत कॉपी कर लें: पेज छोड़ने के बाद Microsoft उसे दोबारा नहीं दिखाता।
Redirect URI (प्लेटफ़ॉर्म: Web)http://auth.localtonet.com/auth/callbackक्लाइंट सीक्रेट की समाप्ति होती है। Microsoft उसकी अवधि 24 महीने तक सीमित रखता है। समाप्त होने पर साइन-इन तब तक काम नहीं करता जब तक आप नया सीक्रेट बनाकर Localtonet के प्रोवाइडर में सेव नहीं करते।
-
Localtonet में प्रोवाइडर जोड़ें #
मेरे टनल › HTTP खोलें और पेज के ऊपर SSO चुनें। SSO प्रोवाइडर डायलॉग में प्रोवाइडर जोड़ें चुनें।
फ़ील्ड वैल्यू प्रोवाइडर का नाम कोई भी नाम, जैसे Company Microsoft। आप इसे टनल सेटिंग में देखते हैं।प्रोवाइडर का प्रकार Microsoft। सेव किए हुए प्रोवाइडर का प्रकार बदलने पर Client ID खाली हो जाता है, इसलिए क्लाइंट ID और क्लाइंट सीक्रेट दोबारा लिखें। सक्रिय चालू Client ID Microsoft Entra का Application (client) ID। Client secret सीक्रेट की Value, Secret ID नहीं। सेव करने के बाद यह कभी नहीं दिखती। एंडपॉइंट और कॉलबैक खोलें। ये वैल्यू अपने-आप भरी जाती हैं:
फ़ील्ड भरी हुई वैल्यू क्या बदलें? Authorization एंडपॉइंट https://login.microsoftonline.com/common/oauth2/v2.0/authorizecommonको अगले सेक्शन की तालिका के अनुसार बदलें।Token एंडपॉइंट https://login.microsoftonline.com/common/oauth2/v2.0/tokencommonको ऊपर वाली वैल्यू से ही बदलें।User info एंडपॉइंट https://graph.microsoft.com/oidc/userinfoनहीं। इसमें कोई टेनेंट नहीं है। कॉलबैक पाथ /auth/callback/microsoftनहीं। चाहें तो ईमेल एक्सेस नियम भरें, फिर प्रोवाइडर सेव करें चुनें।
-
टनल के लिए चालू करें #
आपके टनल में टनल की सेटिंग्स चुनें, फिर SSO प्रोवाइडर के बगल में मैनेज करें। सिंगल साइन-ऑन डायलॉग में साइन-इन ज़रूरी करें और अपने Microsoft प्रोवाइडर का स्विच चालू करें। सेव करें चुनें।
कौन साइन इन कर सकता है के नीचे की सूचियाँ और साइन-इन पाथ वैकल्पिक हैं। वे परिचय में समझाए गए हैं।
-
इसे आज़माएँ #
टनल का URL प्राइवेट ब्राउज़र विंडो में खोलें। Localtonet Sign in to continue दिखाता है, जिसमें आपके प्रोवाइडर का बटन होता है। Microsoft पर साइन इन करने के बाद आपको वापस टनल पर भेजा जाता है और आपकी सर्विस लोड होती है।
अकाउंट टाइप और एंडपॉइंट #
Microsoft एड्रेस में login.microsoftonline.com/ के बाद का हिस्सा तय करता है कि कौन साइन इन कर सकता है। यह आपके एप्लिकेशन के Supported account types से मेल खाना चाहिए। Authorization एंडपॉइंट और Token एंडपॉइंट को हमेशा एक ही वैल्यू मिलती है। User info एंडपॉइंट कभी नहीं बदलता।
| Microsoft Entra में Supported account types | common की जगह इस्तेमाल करें | कौन साइन इन कर सकता है |
|---|---|---|
| Single tenant only | आपका Directory (tenant) ID | आपके अपने टेनेंट के यूज़र और गेस्ट। |
| Multiple Entra ID tenants | organizations | किसी भी संगठन के वर्क या स्कूल अकाउंट। |
| Any Entra ID Tenant + Personal Microsoft accounts | common रखें | वर्क या स्कूल अकाउंट और निजी Microsoft अकाउंट। |
| Personal accounts only | consumers | निजी Microsoft अकाउंट। |
सिंगल-टेनेंट एप्लिकेशन का उदाहरण। <TENANT_ID> की जगह अपना Directory (tenant) ID लिखें:
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoसिंगल-टेनेंट एप्लिकेशन common के साथ काम नहीं करता। Microsoft एरर AADSTS50194 के साथ जवाब देता है। या तो दोनों एंडपॉइंट में अपना टेनेंट ID लिखें, या एप्लिकेशन को मल्टीटेनेंट अकाउंट टाइप में बदलें।
मल्टीटेनेंट या निजी अकाउंट टाइप में आपके संगठन के बाहर के लोग भी Microsoft पर साइन इन कर सकते हैं। सिर्फ़ अपने चुने हुए लोगों को आने देने के लिए प्रोवाइडर पर अनुमत ईमेल डोमेन, या टनल पर कौन साइन इन कर सकता है इस्तेमाल करें।
Localtonet Microsoft से क्या पढ़ता है #
Microsoft का user info एंडपॉइंट ईमेल एड्रेस तभी लौटाता है जब वह अकाउंट से जुड़ा हो, इसलिए बिना ईमेल एड्रेस वाला अकाउंट उन नियमों को पास नहीं कर पाता जो ईमेल पर आधारित हैं।
समस्या निवारण #
AADSTS50011: रिप्लाई URL मेल नहीं खाता
रिक्वेस्ट में दिया गया रीडायरेक्ट URI एप्लिकेशन के लिए रजिस्टर नहीं है। संदेश वह एड्रेस दिखाता है जो भेजा गया था। यह ऐप रजिस्ट्रेशन के Authentication पेज पर, Web प्लेटफ़ॉर्म में, किसी रीडायरेक्ट URI के बिल्कुल समान होना चाहिए, अपरकेस और लोअरकेस समेत। ठीक http://auth.localtonet.com/auth/callback रजिस्टर करें।
AADSTS50194: एप्लिकेशन मल्टीटेनेंट एप्लिकेशन के रूप में कॉन्फ़िगर नहीं है
एप्लिकेशन सिंगल टेनेंट है, लेकिन एंडपॉइंट में अब भी common है। Authorization एंडपॉइंट और Token एंडपॉइंट में common को अपने Directory (tenant) ID से बदलें और प्रोवाइडर सेव करें चुनें।
AADSTS700016: डायरेक्टरी में एप्लिकेशन नहीं मिला
Client ID गलत है, या एंडपॉइंट ऐसे टेनेंट की ओर इशारा करते हैं जिसमें एप्लिकेशन मौजूद नहीं है। Application (client) ID और एंडपॉइंट में टेनेंट ID जाँचें।
AADSTS7000215 या AADSTS7000222: क्लाइंट सीक्रेट अमान्य या समाप्त
Certificates & secrets में नया क्लाइंट सीक्रेट बनाएँ, उसकी Value को Localtonet के Client secret में पेस्ट करें और प्रोवाइडर सेव करें चुनें।
Microsoft एडमिन की मंज़ूरी माँगता है
आपका टेनेंट यूज़र को एप्लिकेशन को खुद सहमति देने नहीं देता। टेनेंट के किसी एडमिनिस्ट्रेटर को Microsoft Entra admin center में एप्लिकेशन के लिए सहमति देनी होगी।
Microsoft साइन-इन सफल होने के बाद "403 - Access Denied"
Localtonet के किसी नियम ने अकाउंट को अस्वीकार किया। प्रोवाइडर पर ईमेल एक्सेस नियम, टनल पर कौन साइन इन कर सकता है, और यह जाँचें कि अकाउंट में ईमेल एड्रेस है भी या नहीं। नियम सुधारने के बाद एक मिनट रुकें और रीलोड करें।