ترتیبات › 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 کوشش جاری رکھتا ہے اور ناکامی کو آڈٹ لاگ میں درج کرتا ہے۔
- اس کی خفیہ کلید تبدیل کرنے کے لیے، نئی دستخطی خفیہ کلید… منتخب کریں، پھر تصدیق کریں۔ درخواستوں پر فوراً نئی خفیہ کلید سے دستخط ہونے لگتے ہیں، اس لیے وصول کنندہ کو فوراً اپ ڈیٹ کریں۔
- اسے ہٹانے کے لیے، حذف کریں… منتخب کریں، پھر تصدیق کے لیے حذف کریں منتخب کریں۔ اس کے بعد اسے مزید کچھ نہیں بھیجا جاتا۔