सीधे कंटेंट पर जाएँ
Localtonet Localtonet डैशबोर्ड

Microsoft के साथ सिंगल साइन-ऑन

बैलेंस ज़रूरी HTTP टनल

इस पेज पर मदद पाएँ
इस पेज पर 6 सेक्शन
  1. शुरू करने से पहले
  2. चरण
  3. Microsoft Entra में एप्लिकेशन रजिस्टर करें
  4. Localtonet में प्रोवाइडर जोड़ें
  5. टनल के लिए चालू करें
  6. इसे आज़माएँ
  7. अकाउंट टाइप और एंडपॉइंट
  8. Localtonet Microsoft से क्या पढ़ता है
  9. समस्या निवारण
  10. संबंधित पेज

विज़िटर को HTTP टनल खोलने से पहले Microsoft Entra ID के वर्क या स्कूल अकाउंट, या निजी Microsoft अकाउंट से साइन इन करने दें। आप Microsoft Entra में एक एप्लिकेशन रजिस्टर करते हैं, उसे Localtonet में प्रोवाइडर के रूप में जोड़ते हैं, फिर टनल के लिए चालू करते हैं।

शुरू करने से पहले #

  • एक HTTP टनल और आपके अकाउंट में बैलेंस। देखें सिंगल साइन-ऑन का परिचय।
  • Microsoft Entra admin center का एक्सेस, ऐसी भूमिका के साथ जो एप्लिकेशन रजिस्टर कर सके। Microsoft न्यूनतम भूमिका Application Developer बताता है।
  • यह तय करना कि कौन साइन इन कर सकता है: सिर्फ़ आपका संगठन, कोई भी संगठन, या निजी अकाउंट भी। इससे Localtonet में लिखे जाने वाले दो एड्रेस तय होते हैं। देखें अकाउंट टाइप और एंडपॉइंट।

चरण #

  1. Microsoft Entra में एप्लिकेशन रजिस्टर करें #

    Microsoft की अपनी गाइड ये हैं: Register an app in Microsoft Entra ID, Add a redirect URI और Add app credentials। संक्षेप में:

    1. Microsoft Entra admin center में Entra ID › App registrations पर जाएँ और New registration चुनें।
    2. Name लिखें। साइन इन करते समय विज़िटर इसे देखते हैं।
    3. Supported account types में चुनें कि एप्लिकेशन कौन इस्तेमाल कर सकता है, फिर Register चुनें।
    4. Overview पेज पर Application (client) ID कॉपी करें। सिंगल-टेनेंट एप्लिकेशन के लिए Directory (tenant) ID भी कॉपी करें।
    5. Manage के नीचे Authentication खोलें, Add Redirect URI चुनें, Web प्लेटफ़ॉर्म चुनें, नीचे दिया गया रीडायरेक्ट URI लिखें और Configure चुनें।
    6. Certificates & secrets › Client secrets खोलें और New client secret चुनें। विवरण जोड़ें, समाप्ति अवधि चुनें और Add चुनें। सीक्रेट की Value तुरंत कॉपी कर लें: पेज छोड़ने के बाद Microsoft उसे दोबारा नहीं दिखाता।
    Redirect URI (प्लेटफ़ॉर्म: Web)
    http://auth.localtonet.com/auth/callback

    क्लाइंट सीक्रेट की समाप्ति होती है। Microsoft उसकी अवधि 24 महीने तक सीमित रखता है। समाप्त होने पर साइन-इन तब तक काम नहीं करता जब तक आप नया सीक्रेट बनाकर Localtonet के प्रोवाइडर में सेव नहीं करते।

  2. Localtonet में प्रोवाइडर जोड़ें #

    मेरे टनल › HTTP खोलें और पेज के ऊपर SSO चुनें। SSO प्रोवाइडर डायलॉग में प्रोवाइडर जोड़ें चुनें।

    फ़ील्डवैल्यू
    प्रोवाइडर का नामकोई भी नाम, जैसे Company Microsoft। आप इसे टनल सेटिंग में देखते हैं।
    प्रोवाइडर का प्रकारMicrosoft। सेव किए हुए प्रोवाइडर का प्रकार बदलने पर Client ID खाली हो जाता है, इसलिए क्लाइंट ID और क्लाइंट सीक्रेट दोबारा लिखें।
    सक्रियचालू
    Client IDMicrosoft 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नहीं।

    चाहें तो ईमेल एक्सेस नियम भरें, फिर प्रोवाइडर सेव करें चुनें।

  3. टनल के लिए चालू करें #

    आपके टनल में टनल की सेटिंग्स चुनें, फिर SSO प्रोवाइडर के बगल में मैनेज करें। सिंगल साइन-ऑन डायलॉग में साइन-इन ज़रूरी करें और अपने Microsoft प्रोवाइडर का स्विच चालू करें। सेव करें चुनें।

    कौन साइन इन कर सकता है के नीचे की सूचियाँ और साइन-इन पाथ वैकल्पिक हैं। वे परिचय में समझाए गए हैं।

  4. इसे आज़माएँ #

    टनल का URL प्राइवेट ब्राउज़र विंडो में खोलें। Localtonet Sign in to continue दिखाता है, जिसमें आपके प्रोवाइडर का बटन होता है। Microsoft पर साइन इन करने के बाद आपको वापस टनल पर भेजा जाता है और आपकी सर्विस लोड होती है।

अकाउंट टाइप और एंडपॉइंट #

Microsoft एड्रेस में login.microsoftonline.com/ के बाद का हिस्सा तय करता है कि कौन साइन इन कर सकता है। यह आपके एप्लिकेशन के Supported account types से मेल खाना चाहिए। Authorization एंडपॉइंट और Token एंडपॉइंट को हमेशा एक ही वैल्यू मिलती है। User info एंडपॉइंट कभी नहीं बदलता।

Microsoft Entra में Supported account typescommon की जगह इस्तेमाल करेंकौन साइन इन कर सकता है
Single tenant onlyआपका Directory (tenant) IDआपके अपने टेनेंट के यूज़र और गेस्ट।
Multiple Entra ID tenantsorganizationsकिसी भी संगठन के वर्क या स्कूल अकाउंट।
Any Entra ID Tenant + Personal Microsoft accountscommon रखेंवर्क या स्कूल अकाउंट और निजी Microsoft अकाउंट।
Personal accounts onlyconsumersनिजी Microsoft अकाउंट।

सिंगल-टेनेंट एप्लिकेशन का उदाहरण। <TENANT_ID> की जगह अपना Directory (tenant) ID लिखें:

Single tenant
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 के किसी नियम ने अकाउंट को अस्वीकार किया। प्रोवाइडर पर ईमेल एक्सेस नियम, टनल पर कौन साइन इन कर सकता है, और यह जाँचें कि अकाउंट में ईमेल एड्रेस है भी या नहीं। नियम सुधारने के बाद एक मिनट रुकें और रीलोड करें।

सपोर्ट