सामग्री पर जाएं

साइट खोज

पेज खोजने के लिए टाइप करें

Docs

API

पहचान API

View as .md

निर्देशिका में एजेंट पहचान बनाएं, पढ़ें, प्रायोजित करें, और रद्द करें।

एक पहचान बनाएं

एक नाम, एक प्रायोजक ईमेल, और उस दायरा सीमा के साथ POST /v1/identities करें जिसे पहचान अनुरोध कर सकती है। जवाब में पहचान आईडी, इसकी स्थिति, और हल किया गया प्रायोजक मिलता है।

नाम मनुष्यों के लिए हैं और अद्वितीय होने की आवश्यकता नहीं है; आईडी वह स्थिर, प्रामाणिक संदर्भ है जो हर जगह उपयोग किया जाता है।

पुनर्प्राप्त करें और सूचीबद्ध करें

GET /v1/identities/{id} अपने प्रायोजक, दायरा सीमा, और स्थिति के साथ एक ही पहचान लौटाता है। GET /v1/identities कर्सर पेजिनेशन के साथ और प्रायोजक व स्थिति के लिए फ़िल्टर के साथ उन्हें सूचीबद्ध करता है।

सूचीकरण केवल-पठन है और पोल करने के लिए सुरक्षित है; यह निरसनों और प्रायोजक परिवर्तनों को तुरंत दर्शाता है।

प्रायोजक अपडेट करें

PATCH /v1/identities/{id} प्रायोजक बदलता है या दायरा सीमा को समायोजित करता है। पिछले मान ऑडिट लॉग में बनाए रखे जाते हैं, इसलिए रिकॉर्ड हमेशा दिखाता है कि किसी भी समय पर कौन जवाबदेह था और क्या अनुमति थी।

रद्द करें

POST /v1/identities/{id}/revoke सभी जुड़े हुए सिस्टमों में पहचान के लिए हर क्रेडेंशियल और दायरे को समकालिक रूप से अमान्य करता है। कॉल रोकथाम पूरी होने पर वापस आता है और घटना ऑडिट लॉग में लिखी जाती है।