GitHub लॉगिन जोड़ना

आपकी सेवा के उपयोगकर्ता GitHub खाते से साइन अप कर सकें, इसके लिए पहले GitHub के पास अपनी सेवा दर्ज करनी होती है और Client ID तथा Client secret लेने होते हैं।

यह पेज Client ID और Client secret पाने का क्रम बताता है। मिले हुए दोनों मानों को WEEGLOO में डालने का तरीका Client ID और Client secret को WEEGLOO में डालना में है।

GitHub से Client ID और Client secret लेना

GitHub में साइन इन करने के बाद नीचे दिए दो चरण क्रम से पूरे करें। यहाँ किए जाने वाले काम पर कोई शुल्क नहीं लगता।

1

OAuth App दर्ज करना

Client ID और Client secret यहाँ दर्ज किए जाने वाले एक ही ऐप में होते हैं।

  1. डेवलपर सेटिंग वाली स्क्रीन (https://github.com/settings/developers (नए टैब में खुलता है)) खोलें।

  2. बाईं ओर के मेनू में OAuth Apps पर क्लिक करें।

  3. New OAuth app पर क्लिक करें।

    OAuth Apps स्क्रीन। बाईं ओर के मेनू में GitHub Apps, OAuth Apps और Personal access tokens हैं, सूची खाली है और New OAuth app बटन दिखता है

  4. Application name में उपयोगकर्ता को दिखने वाला नाम दर्ज करें (उदाहरण: कोज़ी क्लोज़ेट)।

  5. Homepage URL में अपनी साइट का पता दर्ज करें (उदाहरण: https://cozy-closet.com)।

    अगर अभी तक साइट नहीं है, तो आगे जो पता इस्तेमाल करना है वही लिख दें। इसे बाद में बदला जा सकता है। फ़ॉर्म में साथ ही मौजूद Application description वैकल्पिक आइटम है, और लिखने पर यह उपयोगकर्ता को वैसे का वैसा दिखता है, इसलिए ऐसा वाक्य लिखें जिसे उपयोगकर्ता पढ़ेगा।

  6. Redirect URI के खाने में नीचे दिया पता चिपकाएं। अपना Space चुनने पर पहचानकर्ता भर जाता है।

    Space
    https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/github

    अगर आपको पता न हो कि आपका Space कौन सा है और जोड़ने का काम आपने AI एजेंट को सौंप रखा है, तो एजेंट से पूछने का तरीका भी है। चैट में "GitHub लॉगिन में दर्ज करने वाला रीडायरेक्ट पता बता दो" ऐसा कहने पर पूरा बना हुआ पता मिल जाता है।

  7. Register application पर क्लिक करें।

    Register a new OAuth app फ़ॉर्म। Application name में "कोज़ी क्लोज़ेट", Homepage URL में साइट का पता और Redirect URI में WEEGLOO का पता भरा हुआ है

2

Client ID और Client secret कॉपी करना

Register application पर क्लिक करते ही अभी दर्ज किए हुए ऐप की सेटिंग स्क्रीन खुलती है। Client ID यहाँ पहले से दिख रहा होता है, और Client secret अभी बटन दबाकर बनाया जाता है।

  1. Client ID में लिखा मान कॉपी कर लें।

  2. Client secrets शीर्षक के दाईं ओर दिए Generate a new client secret पर क्लिक करें।

    दर्ज करने के तुरंत बाद की ऐप सेटिंग स्क्रीन। Client ID का मान दिखता है, और Client secrets शीर्षक के दाईं ओर Generate a new client secret बटन है

  3. बने हुए मान के दाईं ओर दिए कॉपी आइकन पर क्लिक करके सीक्रेट कॉपी कर लें।

    इस स्क्रीन से हट जाने पर सीक्रेट दोबारा नहीं देखा जा सकता

    Client ID इसी स्क्रीन पर बना रहता है, इसलिए उसे कभी भी दोबारा देखा जा सकता है, पर सीक्रेट के साथ ऐसा नहीं है। सीक्रेट खो जाए, तो Generate a new client secret से नया बनाएं, और नया मिला मान WEEGLOO में दोबारा डालें। सीक्रेट नाम के अनुसार ही एक गुप्त मान है। इसे किसी और को न बताएं, और न ही किसी सार्वजनिक जगह पर लिखकर रखें।

    सीक्रेट बनने के तुरंत बाद की स्क्रीन। नीली सूचना के साथ Client secret का मान और कॉपी आइकन दिखते हैं

ईमेल सार्वजनिक हो तभी लॉगिन होता है

GitHub लॉगिन के साथ एक शर्त जुड़ी है। लॉगिन करने वाला GitHub खाता अपना ईमेल सार्वजनिक कर रहा हो, यह ज़रूरी है।

उपयोगकर्ता GitHub से लॉगिन करता है, तो WEEGLOO उस खाते का सार्वजनिक ईमेल भी साथ में लेकर सदस्य में रखता है। एक ही Space में एक ईमेल से सिर्फ़ एक बार साइन अप किया जा सकता है। जिस खाते ने सार्वजनिक ईमेल तय नहीं किया है, उसका यह मान नहीं आता, और तब साइन अप वहीं रुक जाता है।

रुक जाने पर उपयोगकर्ता को WEEGLOO द्वारा दिखाई जाने वाली सूचना स्क्रीन दिखती है। उसमें उपयोगकर्ता की अपनी भाषा में लिखा होता है कि ईमेल प्राप्त नहीं किया जा सका और अब क्या करना है, और साथ में आपकी साइट पर वापस जाने वाला बटन होता है।

ईमेल प्राप्त नहीं किया जा सका, यह बताने वाली WEEGLOO की सूचना स्क्रीन। कारण के विवरण के साथ शुरुआत पर वापस जाएं बटन है

इस स्थिति में लॉगिन का परिणाम आपकी साइट तक नहीं आता। इसीलिए आपकी साइट के कोड से न तो इस स्थिति का पता चलता है, न ही उसे संभाला जा सकता है।

यह समस्या उपयोगकर्ता को खुद ही हल करनी होती है। उपयोगकर्ता अपने GitHub खाते की सेटिंग (https://github.com/settings/profile (नए टैब में खुलता है)) में Public profile खोले, तो वहाँ Public email आइटम मिलता है। यहाँ दिखाने वाला ईमेल चुन लेने पर अगली बार से लॉगिन पास हो जाता है। जिस खाते ने अभी तक नहीं चुना है, उसमें सिर्फ़ Select a verified email to display लिखा दिखता है।

GitHub प्रोफ़ाइल सेटिंग स्क्रीन। बाईं ओर के मेनू में Public profile चुना हुआ है, और Public email के नीचे ड्रॉपडाउन में Select a verified email to display दिखता है

आपकी साइट पर आप इतना कर सकते हैं कि GitHub से लॉगिन करने वाली जगह पर यह शर्त पहले से लिख दें, ताकि उपयोगकर्ता को रुकने से पहले ही इसका पता चल जाए।

Client ID और Client secret को WEEGLOO में डालना

अब Client ID और Client secret तैयार हैं। यहाँ से आगे का रास्ता इस बात पर बँटता है कि आप अब तक किस तरह काम करते आए हैं।

अगर आप कंटेंट स्टूडियो में खुद सेटिंग कर रहे थे, तो इस तरह आगे बढ़ें।

  1. सेवा सदस्य लॉगिन के सोशल लॉगिन चालू करने वाले हिस्से पर वापस जाएं।
  2. GitHub चालू करें।
  3. Step 2 के Client ID खाने में Client ID डालें।
  4. Client Secret खाने में Client secret डालें।
  5. सहेजें पर क्लिक करें।

अगर आपने जोड़ने का काम AI एजेंट को सौंप रखा है और आपसे Client ID तथा Client secret लाने को कहा गया था, तो लाए हुए दोनों मान चैट में वैसे के वैसे चिपकाकर अपना काम आगे बढ़ाएं। बाकी सेटिंग एजेंट आगे संभाल लेता है।

आगे क्या करना है

  • सेवा सदस्य लॉगिन: लाए हुए मान कंटेंट स्टूडियो में डालें, और सदस्य लॉगिन की बाकी सेटिंग पूरी करें।
  • सदस्य की भूमिका और अनुमतियाँ: साइन अप किया सदस्य क्या देख और इस्तेमाल कर सकता है, यह तय करने वाली ServiceUserRole बनाएं।
  • Auth API: लॉगिन को आपकी साइट के कोड से जोड़ते समय ज़रूरी अनुरोध प्रारूप जैसी तकनीकी विशिष्टियाँ बताई गई हैं।