सेटिंग्स › API ऐक्सेस में आप व्यक्तिगत ऐक्सेस टोकन बनाते हैं, ताकि कोई स्क्रिप्ट या MCP क्लाइंट आपकी ओर से Dvina का इस्तेमाल कर सके। एडमिन भी यहीं वेबहुक जोड़ते हैं, ताकि Livespace के इवेंट अपने सिस्टम को भेज सकें।
API ऐक्सेस Enterprise प्लान में शामिल है। हर सदस्य अपने टोकन बना सकता है; वेबहुक सिर्फ़ मालिकों और एडमिन को दिखते हैं।
टोकन बनाएँ
- सेटिंग्स खोलें और API ऐक्सेस चुनें।
- व्यक्तिगत ऐक्सेस टोकन के तहत टोकन बनाएँ चुनें।
- एक नाम डालें, ताकि बाद में आप पहचान सकें कि इसका इस्तेमाल किसमें हो रहा है।
- ऐक्सेस चुनें: केवल पढ़ने की अनुमति या पढ़ने और लिखने की अनुमति।
- चुनें कि इसकी वैधता कब खत्म होगी: 30 दिनों में, 90 दिनों में, 365 दिनों में या कभी नहीं।
- टोकन बनाएँ चुनें।
- अपना टोकन कॉपी करें के तहत टोकन कॉपी करें और उसे किसी सुरक्षित जगह पर रखें। यह सिर्फ़ इसी बार दिखाया जाता है।
टोकन उसी Livespace में आपकी ओर से काम करता है जिसमें आपने उसे बनाया है, और वहाँ आपकी मौजूदा भूमिका के अनुसार काम करता है। केवल पढ़ने की अनुमति वाला टोकन पढ़ सकता है, लेकिन कुछ भी जोड़ या बदल नहीं सकता।
MCP क्लाइंट के साथ टोकन इस्तेमाल करने के लिए, OAuth के बजाय API कुंजी से कनेक्ट करें देखें।
टोकन की जानकारी देखें, उसे बदलें या रद्द करें
आपके टोकन व्यक्तिगत ऐक्सेस टोकन के तहत उनकी ऐक्सेस अनुमतियों के साथ सूचीबद्ध होते हैं। किसी टोकन को चुनकर देखें कि वह किन अक्षरों से शुरू होता है, उसकी ऐक्सेस क्या है, उसका आखिरी इस्तेमाल कब हुआ और उसकी वैधता कब खत्म होगी।
- टोकन बदलने के लिए, टोकन बदलें… चुनें, फिर पुष्टि करने के लिए टोकन बदलें चुनें। उसकी जगह एक नया टोकन आ जाता है और पुराना टोकन तुरंत काम करना बंद कर देता है। अपना टोकन कॉपी करें के तहत नया टोकन कॉपी करें।
- टोकन बंद करने के लिए, रद्द करें… चुनें, फिर पुष्टि करने के लिए रद्द करें चुनें। उसका इस्तेमाल करने वाली हर चीज़ तुरंत काम करना बंद कर देती है।
टोकन बनाने, बदलने और रद्द करने की गतिविधियाँ ऑडिट लॉग में दर्ज होती हैं।
वेबहुक जोड़ें
वेबहुक Livespace के इवेंट आपके चुने हुए पते पर भेजता है। ये वही रिकॉर्ड हैं जो ऑडिट लॉग में होते हैं।
- सेटिंग्स › API ऐक्सेस में, वेबहुक के तहत वेबहुक जोड़ें चुनें।
- एक नाम और URL डालें। सार्वजनिक HTTPS URL का इस्तेमाल करें।
- इवेंट के तहत, सभी इवेंट पाने के लिए इसे खाली छोड़ें या कार्रवाइयों और क्षेत्रों की सूची डालें, जैसे
member.addedयाsharing.*। - जोड़ें चुनें।
- साइनिंग सीक्रेट कॉपी करें के तहत सीक्रेट कॉपी करें। यह सिर्फ़ इसी बार दिखाया जाता है।
अगर Dvina में Dvina से इस पते तक पहुँचा नहीं जा सकता दिखे, तो सार्वजनिक HTTPS URL का इस्तेमाल करें।
हर अनुरोध के सिग्नेचर की जाँच करें
Dvina इवेंट को बैच में, JSON के रूप में भेजता है और हर अनुरोध पर सिग्नेचर लगाता है। यह जाँचने के लिए कि अनुरोध Dvina से आया है, साइनिंग सीक्रेट का इस्तेमाल करें:
- हर अनुरोध में
X-Dvina-Signatureहेडर होता है, जैसेt=<timestamp>,v1=<signature>। - सिग्नेचर टाइमस्टैम्प, एक बिंदु और अनुरोध की बॉडी का HMAC-SHA256 होता है, जिसे आपके साइनिंग सीक्रेट से बनाया जाता है और हेक्स में लिखा जाता है।
- इसकी गणना खुद करें और तुलना करें। जिस अनुरोध का सिग्नेचर मेल न खाए या जिसका टाइमस्टैम्प बहुत पुराना हो, उसे अस्वीकार करें।
वेबहुक देखें या बदलें
आपके वेबहुक वेबहुक के अंतर्गत उनकी स्थिति के साथ दिखते हैं: चालू, रुका हुआ या विफल हो रहा है। विवरण देखने के लिए कोई वेबहुक चुनें।
- बदलने के लिए, उसका नाम, URL या इवेंट संपादित करें, फिर सहेजें चुनें।
- रोकने के लिए, इवेंट भेजें बंद करें। फिर से भेजना शुरू करने के लिए इसे दोबारा चालू करें।
- यह कैसा काम कर रहा है, यह देखने के लिए, उसकी स्थिति और भेजे गए इवेंट की संख्या देखें। विफल हो रहे वेबहुक में उसकी आखिरी त्रुटि दिखती है। Dvina दोबारा कोशिश करता रहता है और ऑडिट लॉग में विफलता दर्ज करता है।
- उसका सीक्रेट बदलने के लिए, नया साइनिंग सीक्रेट… चुनें, फिर पुष्टि करें। अनुरोधों पर तुरंत नए सीक्रेट से हस्ताक्षर किए जाने लगते हैं, इसलिए रिसीवर को भी तुरंत अपडेट करें।
- हटाने के लिए, हटाएँ… चुनें, फिर पुष्टि करने के लिए हटाएँ चुनें। इसके बाद उस पर कुछ भी नहीं भेजा जाता।