شروع کرنا
کوئک اسٹارٹ
ایک ایجنٹ رجسٹر کریں، ایک محدود دائرہ کار کی سند جاری کریں، ایک زیرِ نگرانی کال کریں، اور اسے منسوخ کریں — تقریباً دس منٹ میں۔
شروع کرنے سے پہلے
آپ کو ایک Mandavo ورک اسپیس، سیٹنگز سے ایک ایڈمن API کی، اور ایک نظام درکار ہے جس تک آپ کسی ایجنٹ کو پہنچانا چاہتے ہیں۔ پورا عمل تقریباً دس منٹ لیتا ہے اور اس کے پیچھے کچھ مستقل نہیں چھوڑتا۔
اپنی کی کو اپنے ماحول میں MANDAVO_API_KEY کے طور پر سیٹ کریں۔ ذیل کی ہر مثال اس سے پڑھتی ہے۔
1۔ ایجنٹ کو رجسٹر کریں
ڈائریکٹری میں ایک شناخت بنائیں اور اسے ایک انسانی سرپرست سے باندھیں۔ سرپرست آپ کی ٹیم کا جوابدہ شخص ہے؛ ایجنٹ کا ہر عمل دونوں سے منسوب ہوتا ہے۔
ایک نام، سرپرست ای میل، اور وہ دائرہ کار جو ایجنٹ کبھی بھی درخواست کر سکتا ہے کے ساتھ POST /v1/identities۔ جواب ایک شناختی id واپس کرتا ہے جسے آپ ہر جگہ استعمال کریں گے۔
2۔ ایک محدود دائرہ کار کی سند جاری کریں
اجراء انجن سے بالکل مخصوص کام کے دائرہ کار والی سند مانگیں۔ صرف وہی دیں جو اس کام کے لیے درکار ہے — ایجنٹ اپنے موجودہ دائرہ کار سے آگے کچھ نہیں پہنچتا۔
شناختی id، دائرہ کار، اور ایک ٹائم ٹو لیو کے ساتھ POST /v1/credentials۔ طے شدہ TTL پانچ منٹ ہے؛ سند لیک ہونے سے پہلے ہی ختم ہو جاتی ہے۔
3۔ ایک زیرِ نگرانی کال کریں
سند کو ہدف نظام کے کنیکٹر کے خلاف بیئرر ٹوکن کے طور پر استعمال کریں۔ پالیسی گراف عمل کو ہونے کے وقت جانچتا ہے: کم خطرے والی اجازتیں خود مختار طور پر چلتی ہیں، زیادہ خطرے والی منظوری پر رکتی ہیں۔
ہر کال شناخت، سرپرست، دائرہ کار، اور پالیسی فیصلے کے ساتھ آڈٹ لاگ میں درج ہوتی ہے۔
4۔ اسے منسوخ کریں
ایجنٹ کی اسناد اور دائرہ کار کو ہر جگہ بیک وقت غیر مؤثر بنانے کے لیے POST /v1/identities/{id}/revoke۔ قابو سیکنڈوں میں مکمل ہوتا ہے اور ریکارڈ میں درج کیا جاتا ہے۔
یہی مکمل لوپ ہے: نامزد شناخت، محدود دائرہ کار کا اجراء، عمل کے وقت کی پالیسی، ایک عمل میں منسوخی — کوئی مستقل کیز باقی نہیں بچتیں۔