Architecture
इसमें चार भाग शामिल हैं:
आपके ऐप में Didit API कुंजी या कोई सीक्रेट कभी नहीं होना चाहिए: प्रकाशन योग्य कुंजी सार्वजनिक होती है, और कोड एक्सचेंज क्लाइंट सीक्रेट की जगह PKCE से सुरक्षित रहता है।
होस्टेड पेज या आपकी अपनी स्क्रीन
लोग ईमेल, पासवर्ड या कोड कहाँ टाइप करें, यह चुनें। सेटिंगsign_in_ui है (डिफ़ॉल्ट hosted है, या own), और आप इसे बाद में भी बदल सकते हैं।
पासकी आपके एप्लिकेशन के साइन-इन ओरिजिन से जुड़ी होती हैं।
SDKs के पासकी मेथड्स केवल उसी ओरिजिन से सर्व किए गए पेजों पर काम करते हैं, इसलिए किसी दूसरे डोमेन पर अपनी स्क्रीन पर पासकी के लिए लोगों को होस्टेड पेज पर भेजें।
SDK चुनें
SDK के बिना, PKCE के साथ authorization code flow खुद लागू करें: JavaScript क्विकस्टार्ट पूरा कॉन्ट्रैक्ट दिखाता है।
अपने बैकएंड की सुरक्षा करें
फ़्रंटएंड सत्र जाँच केवल यह नियंत्रित करती है कि आप क्या दिखाते हैं। आपका बैकएंड हर निर्णय एक सत्यापित token से लेता है।- हर अनुरोध पर access token सत्यापित करें। ES256 हस्ताक्षर को अपने issuer के JWKS से जाँचें, फिर
iss,aud,expऔरtyp: at+jwtजाँचें, और ऐसे token को अस्वीकार करें जिसकाactnullन हो, जब तक रूट AI एजेंट स्वीकार न करता हो। देखें अपने सर्वर पर token सत्यापित करना। - संवेदनशील कार्रवाई से पहले लाइव सत्र जाँचें। Access token अपनी समाप्ति तक मान्य रहता है, और यह समाप्ति 5 मिनट के भीतर होती है।
GET /session/तुरंत विफल हो जाता है, जब सत्र रद्द किया गया हो, निष्क्रिय हो गया हो या समाप्त हो गया हो, जब व्यक्ति ब्लॉक किया गया हो, या जब सत्र अब आपकी MFA नीति को पूरा नहीं करता। देखें सत्र जाँचना। - जोखिम भरी कार्रवाई पर step-up माँगें। भुगतान, नए बैंक खाते, या ईमेल या फ़ोन बदलने से पहले, Didit से पूछें कि क्या व्यक्ति को फिर से सत्यापन करना होगा, और केवल ऐसे
approvedstep-up पर कार्य करें जिसे आपके बैकएंड ने स्वयं पढ़ा हो। देखें संवेदनशील कार्रवाइयों से पहले step-up। vendor_dataसत्यापित token से लें, ब्राउज़र द्वारा भेजे गए किसी फ़ील्ड से कभी नहीं, और उसका उपयोग व्यक्ति के सत्यापनों और लेन-देन के लिए करें।
सत्र
लंबाई बदलने के लिए Authentication > Security and sessions में जाएँ, या API से एप्लिकेशन सेटिंग्स में बदलें।

Authentication > Sign-ins > Active sessions, हर सत्र पर Revoke के साथ।
नेटिव ऐप्स
Didit किसी व्यक्ति को नेटिव ऐप पर केवल HTTPS रीडायरेक्ट के ज़रिए वापस भेजता है। यह कोई भी कस्टम URL स्कीम स्वीकार नहीं करता।- iOS: रीडायरेक्ट को एक एसोसिएटेड डोमेन बनाएँ, और अपनी
apple-app-site-associationमेंwebcredentialsजोड़ें। - Android: रीडायरेक्ट को App Link बनाएँ, और अपनी
assetlinks.jsonजोड़ें। - हर रीडायरेक्ट URL को Authentication > Security and sessions के अंतर्गत पंजीकृत करें, जैसे वेब कॉलबैक के लिए करते हैं।
PUT native-apps/ से पंजीकृत करें।
Didit फिर उन्हें आपके साइन-इन ओरिजिन पर दी गई apple-app-site-association और assetlinks.json में सूचीबद्ध करता है।
MANAGEMENT_BASE आपके एप्लिकेशन का प्रबंधन API पता है, और authentication स्कोप वाली API कुंजी, जिसमें write अनुमति हो, यह कॉल कर सकती है।
यह कॉल दोनों सूचियों को बदल देती है, इसलिए दोनों भेजें:
iOS और Android के क्विकस्टार्ट्स में ऐप वाला हिस्सा दिखाया गया है।
पहचान सत्यापन और लेन-देन निगरानी को जोड़ें
हर व्यक्ति का एकvendor_data मान होता है, जो उसके token और उसके सत्र दोनों में होता है।
जब आप सत्यापन सत्र बनाते हैं या लेन-देन सबमिट करते हैं, तो इसे vendor_data के रूप में उपयोग करें। इससे कंसोल एक ही व्यक्ति के साइन-इन, सत्यापन और लेन-देन को एक साथ दिखाता है।
- साइन-अप के समय, या भुगतान से पहले फिर से लोगों की जाँच करने के लिए, बिना सत्यापन फ़्लो बनाए सत्यापित पहचान का उपयोग करें।
- साइन-इन इवेंट अपने-आप इवेंट नियमों और धोखाधड़ी वाले व्यूज़ तक पहुँचते हैं। उन्हीं साइन-इन के लिए अपने
auth.loginइवेंट पोस्ट न करें। - सफल साइन-इन कभी भी सत्यापन या लेन-देन को स्वीकृत नहीं करता: हर प्रोडक्ट का निर्णय अलग से संभालें।
साइन-इन इवेंट प्राप्त करें
आपको जिनauth.* प्रकारों की ज़रूरत है, जैसे auth.new_device या auth.account_locked, उनके लिए एक webhook गंतव्य सब्सक्राइब करें।
auth_event.event_id के आधार पर डुप्लिकेट इवेंट हटाएँ, और हर Didit webhook की तरह उसके हस्ताक्षर को सत्यापित करें।
हर प्रकार और उसके payload के लिए इवेंट और webhooks देखें।
मौजूदा उपयोगकर्ताओं को माइग्रेट करें
यदि आपके उपयोगकर्ताओं के पास पहले से किसी अन्य पहचान प्लेटफ़ॉर्म पर या आपके अपने डेटाबेस में खाते हैं, तो साइन-इन बदलने से पहले उन्हें इंपोर्ट करें। जहाँ स्रोत उनके पासवर्ड हैश देता है, वहाँ उन्हें इंपोर्ट करें, उनके सोशल लिंक बनाए रखें, और अपनी उपयोगकर्ता आईडी कोexternal_id के रूप में रखें, जो उनका vendor_data बन जाएगा।
आपका ऐप Didit पर स्विच करने तक उनके लिए कुछ नहीं बदलेगा।
गो-लाइव चेकलिस्ट
- आपके लाइव एप्लिकेशन के लिए Products पेज पर प्रमाणीकरण चालू है।
- आपके प्रोडक्शन
https://रीडायरेक्ट URL और अनुमत ऑरिजिन लाइव एप्लिकेशन पर पंजीकृत हैं। लाइव एप्लिकेशन कोईhttp://पता स्वीकार नहीं करता। - हर सोशल साइन-इन विधि आपके अपने ऐप के क्लाइंट ID और सीक्रेट का उपयोग करती है: Didit के परीक्षण क्रेडेंशियल केवल Sandbox में काम करते हैं।
- आपके प्रोडक्शन कॉन्फ़िगरेशन में लाइव पब्लिशेबल की (
pk_live_) और आपका लाइव issuer शामिल हैं। - आपकी MFA नीति, सत्र की अवधि, निष्क्रियता टाइमआउट, पासवर्ड की लंबाई और साइन-अप नीति वैसी ही हैं जैसी आप चाहते हैं। देखें एप्लिकेशन सेटिंग्स।
- बॉट सुरक्षा चालू है, जिसमें लीक हुए पासवर्ड की जाँच भी शामिल है।
- आपका बैकएंड हर access token सत्यापित करता है, और संवेदनशील कार्रवाइयों से पहले
GET /session/को कॉल करता है। - आपकी ब्रांडिंग, पेज टेक्स्ट और नियम व शर्तों तथा गोपनीयता नीति के लिंक सेट हैं। यदि आप कस्टम डोमेन जोड़ने की योजना बना रहे हैं, तो लोगों के passkeys जोड़ना शुरू करने से पहले उसे सक्रिय करें।
- आपका webhook गंतव्य उन
auth.*प्रकारों की सदस्यता लिए हुए है जिन्हें आप संभालते हैं। - आपने लाइव एप्लिकेशन पर साइन-अप, वापस आने वाले उपयोगकर्ताओं का साइन-इन, रद्दीकरण, पासवर्ड भूलना, MFA, सत्र समाप्ति, साइन-आउट और निरस्त सत्र का परीक्षण कर लिया है।