ट्रस्ट चेक जीवनचक्र¶
प्रत्येक पॉलीगार्ड ट्रस्ट चेक तीन चरणों का पालन करता है: तैयारी, ट्रस्ट चेक, और ऑडिट। यह पृष्ठ बताता है कि प्रत्येक चरण में क्या होता है, जेडब्ल्यूटी बंडल कैसे काम करता है, और द्विपक्षीय पारदर्शिता कैसे बनाए रखी जाती है।
चरण 1: तैयारी¶
तैयारी में ट्रस्ट जांच शुरू होने से पहले लिंक ऑब्जेक्ट बनाने के लिए आवश्यक एपीआई कॉल शामिल हैं।
एक लिंक बनाना¶
एक लिंक ट्रस्ट चेक कॉन्फ़िगरेशन को परिभाषित करता है: इसका शीर्षक, आवश्यक प्रमाण और कोई भी मिलान पैरामीटर। लिंक डिफ़ॉल्ट रूप से पुन: प्रयोज्य होते हैं - प्रत्येक उपयोग अलग-अलग ईवेंट लॉग और लेनदेन शपथ पत्र तैयार करता है।
POST /api/v1/links
{
"title": "Identity Verification",
"required_proofs": ["government_id", "location", "pg_presence"],
"matching_params": { ... }
}
वैकल्पिक: लेनदेन-विशिष्ट डेटा आयात करें
तैयारी के दौरान, आप वैकल्पिक रूप से लिंक में लेनदेन-विशिष्ट डेटा (जैसे टोकन या संदर्भ आईडी) संलग्न कर सकते हैं। यह डेटा क्रॉस-सिस्टम वर्कफ़्लो को सक्षम करते हुए, ट्रस्ट जांच के माध्यम से पॉलीगार्ड वातावरण के बीच पारित किया जा सकता है।
आपको क्या वापस मिलता है¶
एपीआई एक आईडी और एक यूआरएल के साथ एक लिंक ऑब्जेक्ट लौटाता है। यूआरएल वह है जिसे आप अपने वेब एप्लिकेशन (वेब एसडीके के माध्यम से) में एम्बेड करते हैं या ट्रस्ट जांच शुरू करने के लिए मोबाइल एप्लिकेशन (मोबाइल एसडीके के माध्यम से) में पास करते हैं।
चरण 2: विश्वास की जाँच¶
यह वास्तविक समय पहचान सत्यापन चरण है। डेस्कटॉप और मोबाइल संदर्भों के बीच प्रवाह थोड़ा भिन्न होता है, लेकिन अंतर्निहित प्रोटोकॉल समान है।
डेस्कटॉप प्रवाह¶
- वेब एसडीके ब्राउज़र में मोडल ओवरले प्रदर्शित करता है।
- अंतिम उपयोगकर्ता पॉलीगार्ड मोबाइल ऐप के साथ एक क्यूआर कोड को स्कैन करता है (या पहले से ही युग्मित होने पर एक पुश अधिसूचना प्राप्त करता है)।
- वेब एप्लिकेशन, मोबाइल ऐप और पॉलीगार्ड सिस्टम के बीच एक वेबसॉकेट कनेक्शन स्थापित किया जाता है - सभी एक ही क्षेत्रीय एंडपॉइंट से जुड़े होते हैं।
- अंतिम उपयोगकर्ता अपने मोबाइल डिवाइस पर आवश्यक प्रमाण (चेहरे का बायोमेट्रिक, दस्तावेज़ स्कैन, आदि) पूरा करता है।
- स्कोर और उपस्थिति परिणाम पॉलीगार्ड बुनियादी ढांचे के भीतर संसाधित किए जाते हैं।
- परिणाम एसडीके कॉलबैक के माध्यम से वेब एप्लिकेशन पर लौटाए जाते हैं।
मोबाइल प्रवाह¶
- मोबाइल एसडीके पॉलीगार्ड मोबाइल ऐप में रीडायरेक्ट ट्रिगर करता है (या एम्बेडेड मोबाइल एसडीके का उपयोग करने पर इन-ऐप सत्यापन प्रवाह)।
- वही WebSocket-आधारित सत्र समन्वय होता है।
- पूरा होने पर, उपयोगकर्ता को परिणामों के साथ कॉलिंग एप्लिकेशन पर वापस भेज दिया जाता है।
वेबसॉकेट सत्र समन्वय¶
ट्रस्ट चेक के वेब और मोबाइल दोनों पक्ष वेबसॉकेट के माध्यम से एक ही लिंक सत्र से जुड़ते हैं। ये कनेक्शन एक ही क्षेत्रीय समापन बिंदु पर समाप्त होने चाहिए। पॉलीगार्ड सिस्टम क्षेत्रीय रूटिंग को स्वचालित रूप से संभालता है (रीडायरेक्ट कैसे काम करता है इसके विवरण के लिए मल्टीटेनेंसी और क्षेत्रीयकरण देखें)।
परिणाम प्राप्त करना¶
ट्रस्ट जांच परिणाम आपके आवेदन पर दो चैनलों के माध्यम से पहुंचाए जाते हैं:
| चैनल | वितरण | उदाहरण |
|---|---|---|
| एसडीके कॉलबैक | सिंक्रोनस, ब्राउज़र या मोबाइल ऐप में | तत्काल यूएक्स अपडेट - सत्यापन स्थिति दिखाएं, अगले चरण को अनलॉक करें |
| वेबहुक | आपके बैकएंड पर अतुल्यकालिक HTTP पोस्ट | सर्वर-साइड सत्यापन, रिकॉर्ड-कीपिंग, डाउनस्ट्रीम वर्कफ़्लो ट्रिगर करना |
वेबहुक कॉन्फ़िगरेशन
पॉलीगार्ड ऑब्जेक्ट मॉडल में वेबहुक प्रति ऐप कॉन्फ़िगर किए गए हैं। अपना ऐप कॉन्फ़िगरेशन बनाते या अपडेट करते समय वेबहुक यूआरएल सेट करें। वेबहुक पेलोड स्कीमा के लिए REST API डॉक्स देखें।
चरण 3: लेखापरीक्षा¶
ट्रस्ट जांच पूरी होने के बाद ऑडिट चरण किसी भी समय उपलब्ध होता है। यह इस बात में पूर्ण पारदर्शिता प्रदान करता है कि क्या सत्यापित किया गया था, किसके द्वारा और किस क्रिप्टोग्राफ़िक समर्थन के साथ।
उपलब्ध ऑडिट डेटा¶
| संसाधन | विवरण | पहुँच |
|---|---|---|
| इवेंट लॉग्स | ट्रस्ट जांच के दौरान की गई प्रत्येक कार्रवाई का विस्तृत रिकॉर्ड | बाकी एपीआई |
| लेनदेन शपथ पत्र | क्रिप्टोग्राफिक रूप से हस्ताक्षरित, पूर्ण ट्रस्ट जांच के गैर-अस्वीकार्य रिकॉर्ड | बाकी एपीआई |
| सार्वजनिक कुंजी अवसंरचना | PolyUser सार्वजनिक कुंजियों का पता लगाने और JWT हस्ताक्षरों को सत्यापित करने के लिए प्रसिद्ध समापन बिंदु | HTTPS (प्रसिद्ध यूआरआई) |
द्विपक्षीय पारदर्शिता¶
सभी ऑडिट लॉग प्रत्येक ट्रस्ट चेक के सभी पक्षों के लिए उपलब्ध हैं। इसका मतलब यह है:
- प्लेटफ़ॉर्म ऑपरेटर अनुपालन और विवाद समाधान के लिए लॉग तक पहुंच सकता है।
- व्यावसायिक उपयोगकर्ता अपने लेनदेन के सत्यापन परिणामों की समीक्षा कर सकता है।
- अंतिम उपयोगकर्ता देख सकता है कि कौन से सबूत प्रस्तुत किए गए और किसे प्रस्तुत किए गए।
यह द्विपक्षीय पारदर्शिता मॉडल यह सुनिश्चित करता है कि किसी भी पक्ष को सूचना का लाभ न मिले, और यह कि ऑडिट ट्रेल किसी भी भागीदार द्वारा स्वतंत्र सत्यापन के लिए उपलब्ध है।
जेडब्ल्यूटी बंडल¶
प्रत्येक ट्रस्ट जांच का अंतिम चरण मोबाइल ऐप से पॉलीगार्ड सिस्टम एंडपॉइंट तक हस्ताक्षरित JWT बंडल का HTTP POST है।
संरचना¶
JWT बंडल में अलग-अलग JWT का एक सेट होता है, प्रत्येक को उसके द्वारा दर्शाए गए प्रमाण के लिए संबंधित ट्रस्ट श्रृंखला द्वारा हस्ताक्षरित किया जाता है। उदाहरण के लिए, एक सरकारी आईडी प्रूफ JWT को पहचान सत्यापन भागीदार की ट्रस्ट श्रृंखला में निहित कुंजियों के साथ हस्ताक्षरित किया जाता है, जबकि एक डिवाइस पहचान प्रमाण JWT को Apple या Google के सत्यापन बुनियादी ढांचे में निहित कुंजियों के साथ हस्ताक्षरित किया जाता है।
प्रमुख क्षेत्र¶
| जेडब्ल्यूटी फील्ड | कीमत | उद्देश्य |
|---|---|---|
जारीकर्ता (iss) | पॉली यूजर आईडी | अंतिम उपयोगकर्ता की पहचान करता है. किसी भी भरोसेमंद पार्टी को पॉलीगार्ड के प्रसिद्ध स्थान पर संबंधित सार्वजनिक कुंजी का पता लगाने की अनुमति देता है। |
दर्शक (aud) | पॉलीगार्ड सिस्टम का FQDN + ऐप आईडी | इच्छित प्राप्तकर्ता और एप्लिकेशन संदर्भ की पहचान करता है। |
सत्यापन¶
कोई भी भरोसेमंद पार्टी स्वतंत्र रूप से JWT बंडल को सत्यापित कर सकती है:
- प्रत्येक JWT से
iss(पॉली यूजर आईडी) निकालना। - पॉलीगार्ड के सुप्रसिद्ध समापन बिंदु से संबंधित सार्वजनिक कुंजी प्राप्त करना।
- सार्वजनिक कुंजी के विरुद्ध JWT हस्ताक्षर को मान्य करना।
- यह पुष्टि करने के लिए
audफ़ील्ड की जाँच करना कि JWT अपेक्षित एप्लिकेशन के लिए था।
यह पॉलीगार्ड एपीआई पर कॉल बैक की आवश्यकता के बिना ट्रस्ट जांच परिणामों को स्वतंत्र रूप से सत्यापन योग्य बनाता है।
अनुक्रम सारांश¶
Preparation Trust Check Audit
----------- ----------- -----
Create Link --> Display modal / redirect --> Query event logs
(set proofs, WebSocket session Retrieve affidavits
import data) Biometric + proof capture Verify JWT signatures
Score processing (available to all parties)
JWT Bundle posted
Results via SDK + webhook
कार्यान्वयन विवरण के लिए, वेब एसडीके क्विक स्टार्ट या पूर्ण वेब एसडीके संदर्भ देखें।