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

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

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

पहले कॉपी कर लेने वाला पता

ग्राहक GitHub पर लॉगिन पूरा कर लेता है, तो GitHub उसका परिणाम एक तय पते पर वापस भेजता है। यह पता GitHub में दर्ज करना होता है, इसलिए इसे पहले कॉपी कर लें। पहले चरण में इसे चिपकाना है।

नीचे अपना Space चुनने पर पहचानकर्ता भरा हुआ पता बन जाता है।

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

अगर आप खुद भरना चाहें, तो {spaceId} की जगह अपने Space का पहचानकर्ता डालें। कंटेंट स्टूडियो में उस Space को खोलकर ब्राउज़र का एड्रेस बार देखें; /spaces/ के बाद आने वाला मान ही पहचानकर्ता है।

यह पता आपकी साइट का पता नहीं है, बल्कि वह जगह है जहाँ WEEGLOO लॉगिन का परिणाम प्राप्त करता है। इसीलिए आपने अपनी साइट अभी तक नहीं बनाई हो, तब भी यह अभी तय हो जाता है। अगर आपने कंटेंट स्टूडियो में GitHub चालू कर रखा है, तो वही पता Step 1 में दिखता है, और आप उसे वहाँ से भी कॉपी कर सकते हैं।

GitHub से दो मान लेना

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

1

OAuth App दर्ज करना

स्क्रीन पर दिखने वाला OAuth उस तरीके का नाम है जो GitHub खाते से लॉगिन करने देता है। दोनों मान यहाँ दर्ज किए जाने वाले एक ही ऐप में होते हैं।

  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)।

  6. Redirect URI के खाने में पहले कॉपी कर लेने वाला पता से कॉपी किया हुआ पता चिपकाएं।

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

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

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

2

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

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

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

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

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

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

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

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

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

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

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 से लॉगिन करने वाली जगह पर यह शर्त पहले से लिख दें, ताकि ग्राहक को रुकने से पहले ही इसका पता चल जाए।

मिले हुए मान WEEGLOO में डालना

अब आपके हाथ में दो मान हैं। यहाँ से आगे का रास्ता इस बात पर बँटता है कि आप अब तक किस तरह काम करते आए हैं।

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

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

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

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

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