Smart-ID और Mobile-ID इंटीग्रेशन गाइड

Smart-ID और Mobile-ID उपयोगकर्ताओं को अपने फ़ोन पर अनुरोध स्वीकृत करके अपनी पहचान सत्यापित करने की अनुमति देते हैं। वर्कफ़्लो के बिना अपने स्वयं के एप्लिकेशन से सत्यापन शुरू करने के लिए Smart-ID API या Mobile-ID API का उपयोग करें। दोनों विधियाँ Didit के पहचान सत्यापन वर्कफ़्लो चरण के भीतर भी चलती हैं, जो cryptographic अश्योरेंस के साथ वॉलेट सत्यापन परिणाम लौटाती हैं। नीचे वर्णित होस्टेड वर्कफ़्लो इंटीग्रेशन के लिए, अपने अन्य Didit वर्कफ़्लो की तरह ही सत्र निर्माण और webhook इंटीग्रेशन का उपयोग करें।

Smart-ID और Mobile-ID उपलब्ध हैं। Smart-ID एस्टोनिया, लातविया, लिथुआनिया और बेल्जियम का समर्थन करता है। Mobile-ID एस्टोनिया और लिथुआनिया का समर्थन करता है। कंसोल में प्रत्येक देश के लिए वे वॉलेट चुनें जिन्हें आपका वर्कफ़्लो स्वीकार करता है। पूरी सूची के लिए वॉलेट कवरेज और मूल्य निर्धारण देखें।

देश और पूर्वापेक्षाएँ

यह इंटीग्रेशन एस्टोनिया (EST), लातविया (LVA), लिथुआनिया (LTU) और बेल्जियम (BEL) में Smart-ID को कवर करता है। Mobile-ID एस्टोनिया (EST) और लिथुआनिया (LTU) को कवर करता है; लातविया के लिए Mobile-ID की पेशकश नहीं की जाती है। ये देश कोड एकीकृत रूट्स का वर्णन करते हैं, यह कोई वादा नहीं है कि आपके एनवायरनमेंट में हर रूट सक्रिय है। Smart-ID के लिए, उपयोगकर्ता को एक सक्रिय पात्र Smart-ID पहचान, उसके व्यक्तिगत पहचान कोड और ऐप तक पहुंच की आवश्यकता होती है। Mobile-ID के लिए, उपयोगकर्ता को एक सक्रिय Mobile-ID पहचान, उसके व्यक्तिगत पहचान कोड और उससे जुड़े फ़ोन नंबर की आवश्यकता होती है। अंतर्राष्ट्रीय प्रारूप में Mobile-ID फ़ोन नंबर दर्ज करें: एस्टोनिया के लिए +372 या लिथुआनिया के लिए +370। चयनित देश उपयोग की जा रही पहचान से मेल खाना चाहिए। दोनों में से कोई भी विधि पोर्ट्रेट नहीं लौटाती है। यदि आपके वर्कफ़्लो को सेल्फ़ी की आवश्यकता है, तो उपयुक्त लाइवनेस डिटेक्शन और चेहरा मिलान चरणों को अलग से कॉन्फ़िगर करके रखें।

उपयोगकर्ता को क्या दिखाई देता है

उपयोगकर्ता अपने देश का चयन करता है और आपके वर्कफ़्लो द्वारा स्वीकार किए जाने वाले वॉलेट में से Smart-ID या Mobile-ID चुनता है।
सत्यापन सत्र व्यक्तिगत पहचान कोड मांगता है; Mobile-ID संबद्ध फ़ोन नंबर भी मांगता है।
जब प्रमाणीकरण अनुरोध फ़ोन तक पहुँचता है, तब पेज एक तुलना कोड प्रदर्शित करता है।
उपयोगकर्ता जाँचता है कि फ़ोन पर मौजूद कोड सत्यापन पेज के कोड से मेल खाता है, फिर फ़ोन पर अपने PIN का उपयोग करके स्वीकृत करता है।
Didit हस्ताक्षरित पहचान परिणाम को मान्य करता है और सत्यापन वर्कफ़्लो जारी रखता है।

पहचान फ़ॉर्म और तुलना-कोड स्क्रीन अन्य सत्यापन विधियों के समान लेआउट का उपयोग करते हैं। जब व्हाइट लेबल कस्टमाइज़ेशन सक्षम होता है, तो वे सत्र के रंग, टाइपोग्राफी, बटन स्टाइलिंग और ग्राहक लोगो को इनहेरिट करते हैं, और सत्र के डोमेन पर बने रहते हैं। पेज को रीफ़्रेश करने से कोई अन्य स्वीकृति अनुरोध शुरू किए बिना सक्रिय तुलना कोड रीस्टोर हो जाता है। उपयोगकर्ता कभी भी सत्यापन पेज पर अपना वॉलेट PIN दर्ज नहीं करता है। यदि कोड भिन्न हैं या उपयोगकर्ता ने अनुरोध शुरू नहीं किया है, तो उन्हें इसे रद्द कर देना चाहिए। तुलना-कोड फ़्लो डेस्कटॉप या फ़ोन ब्राउज़र के साथ काम करता है और इसके लिए QR कोड की आवश्यकता नहीं होती है। पेज स्वचालित रूप से परिणाम की प्रतीक्षा करता है और रद्दीकरण विकल्प प्रदान करता है। Didit द्वारा वॉलेट सत्यापन को सफल मानने से पहले फ़ोन पर दी गई स्वीकृति को पहचान और हस्ताक्षर जाँच पास करनी होगी।

वर्कफ़्लो कॉन्फ़िगर करें

कंसोल में, अपने वर्कफ़्लो का पहचान सत्यापन नोड खोलें, देश चुनें, और वह देश खोलें जिसे आप कॉन्फ़िगर करना चाहते हैं। स्वीकृत वॉलेट के अंतर्गत, उपलब्ध वॉलेट चुनें और विफलता व्यवहार का चयन करें। नया सत्र बनाने से पहले वर्कफ़्लो को सहेजें और प्रकाशित करें। कंसोल के पूरे पथ के लिए कंसोल में पहचान सत्यापन विधियाँ देखें।

निम्नलिखित एक methods कॉन्फ़िगरेशन फ़्रैगमेंट है, संपूर्ण वर्कफ़्लो अनुरोध नहीं। इसका उपयोग केवल तभी करें जब आपके एनवायरनमेंट में एस्टोनिया के लिए smart_id और mobile_id दोनों को available के रूप में चिह्नित किया गया हो। एक अनुपलब्ध वॉलेट पूरे वर्कफ़्लो को सेव करने की प्रक्रिया को अस्वीकार कर देता है।

{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}

providers ऐरे एक स्वीकार-सूची है: उपयोगकर्ता इसके वॉलेट में से चयन करते हैं, और ऐरे क्रम किसी पसंदीदा वॉलेट को सेट नहीं करता है। लिथुआनिया के लिए, दोनों उपलब्ध होने पर समान वॉलेट पहचानकर्ताओं के साथ LTU का उपयोग करें। लातविया या बेल्जियम के लिए, उसी उपलब्धता जाँच के अधीन, केवल smart_id के साथ LVA या BEL का उपयोग करें। छोड़े गए देश अपने मौजूदा डिफ़ॉल्ट दस्तावेज़-कैप्चर व्यवहार को बनाए रखते हैं। पूर्ण कॉन्फ़िगरेशन अनुबंध वर्कफ़्लो सुविधा कॉन्फ़िगरेशन में है।

सत्यापित परिणाम पढ़ें

पूर्ण सत्र को सत्र निर्णय API या अपने webhook इंटीग्रेशन के माध्यम से पढ़ें। एक सफल वॉलेट जाँच verification_method: "wallet", assurance: "cryptographic" और wallet_provider: "smart_id" या "mobile_id" रिकॉर्ड करती है। wallet_verification ऑब्जेक्ट वॉलेट, जारीकर्ता देश, सत्यापन समय, अश्योरेंस के स्तर और हस्ताक्षर निर्णय की पहचान करता है। पहचान सत्यापन परिणाम सामान्यीकृत full_name और date_of_birth फ़ील्ड दिखाता है। इन दोनों वॉलेट के लिए, wallet_verification.attributes में मान्य पहचान से प्राप्त given_name, family_name, birthdate और personal_code शामिल होते हैं। जारीकर्ता देश पहचान रूट की पहचान करता है; यह व्यक्ति की राष्ट्रीयता स्थापित नहीं करता है। Didit हस्ताक्षर निर्णय लौटाता है, अंतर्निहित हस्ताक्षरित अभिकथन नहीं। कोई पोर्ट्रेट या वॉलेट PIN नहीं लौटाया जाता है। कंसोल में, सत्र का क्रेडेंशियल कार्ड वॉलेट और उसके सत्यापित साक्ष्य दिखाता है। एक सफल वॉलेट जाँच पहचान सत्यापन चरण को पूरा करती है; आपके वर्कफ़्लो में बाद की जाँचें अभी भी सत्र का अंतिम निर्णय निर्धारित करती हैं। फ़ील्ड प्रकारों और जाँच परिणाम तथा समग्र सत्र निर्णय के बीच अंतर के लिए पहचान सत्यापन डेटा मॉडल देखें।

रद्दीकरण और विफलता को संभालना

यदि कोई उपयोगकर्ता रद्द करता है, समय समाप्त हो जाता है या प्रमाणीकरण पूरा नहीं कर पाता है, तो Didit देश की wallet.on_failure सेटिंग लागू करता है। fallback_to_document उस देश के लिए सक्षम होने पर दस्तावेज़ कैप्चर शुरू करता है। decline पहचान सत्यापन चरण को अस्वीकृत कर देता है। यदि दस्तावेज़ कैप्चर अक्षम है, तो कोई दस्तावेज़ फ़ॉलबैक उपलब्ध नहीं होता है। केवल एक पूर्ण, सत्यापित वॉलेट जाँच पर ही वॉलेट सत्यापन शुल्क लगता है। रद्द किए गए, समय-सीमा समाप्त और विफल वॉलेट प्रयासों पर कोई शुल्क नहीं लगता है। एक पूर्ण दस्तावेज़ फ़ॉलबैक दस्तावेज़ सत्यापन मूल्य निर्धारण के तहत एक अलग जाँच है। प्रकाशित दरों के लिए वॉलेट मूल्य निर्धारण तालिका देखें; बिना प्रकाशित दर वाले तरीके को निःशुल्क नहीं माना जाना चाहिए।

प्रोडक्शन से पहले परीक्षण करें

जिन वॉलेट और देशों को आप पेश करने की योजना बना रहे हैं, उनमें से प्रत्येक का उस एनवायरनमेंट में परीक्षण करें जहाँ वह सक्षम है। पुष्टि करें कि सही वॉलेट दिखाई देते हैं, तुलना कोड दिखाई देता है, स्वीकृति वर्कफ़्लो को जारी रखती है, और सत्र परिणाम में अपेक्षित वॉलेट साक्ष्य शामिल हैं। रद्दीकरण, समाप्ति और अपने चुने हुए फ़ॉलबैक व्यवहार की भी जाँच करें। सैंडबॉक्स सिमुलेशन और स्टेजिंग परीक्षण प्रोडक्शन प्रमाणीकरण से भिन्न होते हैं। एक सिम्युलेटेड स्वीकृति आपके इंटीग्रेशन की जाँच के लिए उपयोगी है, लेकिन यह साबित नहीं करती है कि कोई वास्तविक पहचान प्रोडक्शन में प्रमाणित हो सकती है। रोलआउट से पहले, कंसोल में प्रोडक्शन उपलब्धता की पुष्टि करें और उस रूट के लिए एक अधिकृत वास्तविक-डिवाइस सत्यापन पूरा करें जिसका आप उपयोग करना चाहते हैं।

अन्य डिजिटल पहचान वॉलेट

Didit के डिजिटल ID वॉलेट कैटलॉग में प्रोडक्शन उपलब्धता और आगामी वॉलेट शामिल हैं, जिनमें उपलब्ध Finnish Trust Network और आगामी BankID तथा EUDI Wallet इंटीग्रेशन शामिल हैं। सूचीबद्ध वॉलेट, प्रकाशित कीमत या पूर्ण ऑनबोर्डिंग फ़ॉर्म अपने आप में प्रोडक्शन प्रमाणीकरण को सक्षम नहीं करते हैं। आज आप क्या सक्रिय कर सकते हैं, यह निर्धारित करने के लिए कैटलॉग और अपने एनवायरनमेंट के कंसोल का उपयोग करें। यह भी देखें फ़िनलैंड के लिए Finnish Trust Network।

प्रमाणीकरण

सत्यापन

निगरानी

प्लेटफ़ॉर्म

Smart-ID और Mobile-ID इंटीग्रेशन गाइड

देश और पूर्वापेक्षाएँ

उपयोगकर्ता को क्या दिखाई देता है

वर्कफ़्लो कॉन्फ़िगर करें

सत्यापित परिणाम पढ़ें

रद्दीकरण और विफलता को संभालना

प्रोडक्शन से पहले परीक्षण करें

अन्य डिजिटल पहचान वॉलेट

​देश और पूर्वापेक्षाएँ

​उपयोगकर्ता को क्या दिखाई देता है

​वर्कफ़्लो कॉन्फ़िगर करें

​सत्यापित परिणाम पढ़ें

​रद्दीकरण और विफलता को संभालना

​प्रोडक्शन से पहले परीक्षण करें

​अन्य डिजिटल पहचान वॉलेट

देश और पूर्वापेक्षाएँ

उपयोगकर्ता को क्या दिखाई देता है

वर्कफ़्लो कॉन्फ़िगर करें

सत्यापित परिणाम पढ़ें

रद्दीकरण और विफलता को संभालना

प्रोडक्शन से पहले परीक्षण करें

अन्य डिजिटल पहचान वॉलेट