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

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

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

इस पेज पर मदद पाएँ
इस पेज पर 4 सेक्शन
  1. शुरू करने से पहले
  2. चरण
  3. GitHub पर OAuth ऐप रजिस्टर करें
  4. Localtonet में प्रोवाइडर जोड़ें
  5. टनल के लिए चालू करें
  6. इसे आज़माएँ
  7. समस्या निवारण
  8. संबंधित पेज

विज़िटर को HTTP टनल खोलने से पहले अपने GitHub अकाउंट से साइन इन करने दें। आप GitHub पर एक OAuth ऐप रजिस्टर करते हैं, उसे Localtonet में प्रोवाइडर के रूप में जोड़ते हैं, फिर टनल के लिए चालू करते हैं।

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

  • एक HTTP टनल और आपके अकाउंट में बैलेंस। देखें सिंगल साइन-ऑन का परिचय।
  • एक GitHub अकाउंट। किसी संगठन के लिए ऐप रजिस्टर करने हेतु आपको उस संगठन की सेटिंग का एक्सेस चाहिए।

चरण #

  1. GitHub पर OAuth ऐप रजिस्टर करें #

    GitHub की अपनी गाइड Creating an OAuth app है। संक्षेप में:

    1. GitHub पर प्रोफ़ाइल फ़ोटो के नीचे का मेनू खोलें और Settings, फिर Developer settings, फिर OAuth apps चुनें।
    2. New OAuth App चुनें। अगर आपके पास अभी कोई ऐप नहीं है, तो बटन पर Register a new application लिखा होता है।
    3. नीचे दी गई वैल्यू से फ़ॉर्म भरें और Register application चुनें।
    4. नए ऐप के पेज पर Client ID कॉपी करें, फिर Generate a new client secret चुनें और सीक्रेट तुरंत कॉपी कर लें।
    GitHub फ़ील्डवैल्यू
    Application nameऐसा नाम जिसे आपके विज़िटर पहचानें। GitHub उन्हें अनुमति देने को कहते समय यही नाम दिखाता है।
    Homepage URLऐसा वेब एड्रेस जो ऐप के बारे में बताए, जैसे आपकी वेबसाइट।
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device Flowइसे बंद रखें।

    GitHub पर आप स्कोप नहीं चुनते। साइन-इन रिक्वेस्ट उनके नाम देती है: read:user और user:email। GitHub विज़िटर से पहली बार साइन इन करते समय उन्हें मंज़ूर करने को कहता है।

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

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

    फ़ील्डवैल्यू
    प्रोवाइडर का नामकोई भी नाम, जैसे GitHub। आप इसे टनल सेटिंग में देखते हैं।
    प्रोवाइडर का प्रकारGitHub। सेव किए हुए प्रोवाइडर का प्रकार बदलने पर Client ID खाली हो जाता है, इसलिए क्लाइंट ID और क्लाइंट सीक्रेट दोबारा लिखें।
    सक्रियचालू
    Client IDGitHub से मिला क्लाइंट ID।
    Client secretGitHub से मिला क्लाइंट सीक्रेट। सेव करने के बाद यह कभी नहीं दिखता।

    एंडपॉइंट और कॉलबैक के नीचे GitHub के मानक एड्रेस अपने-आप भर जाते हैं। उन्हें वैसा ही रहने दें:

    फ़ील्डभरी हुई वैल्यू
    Authorization एंडपॉइंटhttps://github.com/login/oauth/authorize
    Token एंडपॉइंटhttps://github.com/login/oauth/access_token
    User info एंडपॉइंटhttps://api.github.com/user
    कॉलबैक पाथ/auth/callback/github

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

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

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

    GitHub अकाउंट कोई भी बना सकता है। बिना किसी नियम के, एड्रेस जानने वाला हर GitHub यूज़र टनल खोल सकता है। टनल पर कौन साइन इन कर सकता है, या प्रोवाइडर पर अनुमत ईमेल डोमेन भरें। सूचियाँ परिचय में समझाई गई हैं।

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

    टनल का 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 बटन नहीं है

प्रोवाइडर इस टनल के लिए चालू नहीं है, या निष्क्रिय पर सेट है। दोनों जाँचें।

सपोर्ट