Overview
NFC सत्यापन रिपोर्ट यह कैप्चर करती है कि Didit ने किसी दस्तावेज़ की NFC चिप (जैसे ई-पासपोर्ट, इलेक्ट्रॉनिक आईडी कार्ड या कोई अन्य ICAO 9303 ई-दस्तावेज़) से क्या पढ़ा और सत्यापित किया। इसमें चिप का बायोग्राफिकल डेटा, क्रिप्टोग्राफ़िक अखंडता जांच (SOD और डेटा ग्रुप हैश), और जारीकर्ता देश द्वारा उपयोग किए गए दस्तावेज़ हस्ताक्षरकर्ता प्रमाणपत्र (DSC) का सारांश शामिल होता है। यह रिपोर्ट तब तैयार की जाती है जब उपयोगकर्ता किसी वर्कफ़्लो में NFC चरण को पूरा कर लेता है। Didit उपयोगकर्ता के डिवाइस पर चिप के डेटा ग्रुप को पढ़ता है, जारीकर्ता देश के CSCA प्रमाणपत्र के विरुद्ध दस्तावेज़ सुरक्षा ऑब्जेक्ट (SOD) हस्ताक्षर को सत्यापित करता है, SOD द्वारा हस्ताक्षरित मानों के विरुद्ध प्रत्येक डेटा ग्रुप हैश की जांच करता है, और दस्तावेज़ के दृश्यमान भाग से OCR किए गए MRZ के साथ चिप के MRZ की क्रॉस-जांच करता है। Japan My Number Card को इसके बजाय JPKI के माध्यम से पढ़ा जाता है (chip_protocol: "jpki"): इसकी रिपोर्ट jpki के तहत प्रमाणपत्र, हस्ताक्षर, निरस्तीकरण और धारक-डेटा जांच को दर्शाती है, और ICAO फ़ील्ड null रहते हैं। Japan My Number Card (JPKI) देखें।
प्रत्येक रिपोर्ट की अपनी status होती है — जो समग्र सत्र स्थिति से स्वतंत्र होती है — जो यह दर्शाती है कि केवल NFC चरण का समाधान कैसे हुआ:
- Approved (स्वीकृत) — चिप को पढ़ लिया गया था और सक्रिय हुई कोई भी चेतावनी चरण को समीक्षा या अस्वीकृति के लिए भेजने हेतु कॉन्फ़िगर नहीं की गई है।
- In Review (समीक्षाधीन) — कम से कम एक ऐसी चेतावनी सक्रिय हुई जिसकी कॉन्फ़िगर की गई कार्रवाई Review (समीक्षा) है (उदाहरण के लिए
NFC_CHIP_NOT_VERIFIEDयाNFC_TRUST_ANCHOR_MISSINGजब असत्यापित-चिप कार्रवाई को समीक्षा पर सेट किया गया हो, या अपनी डिफ़ॉल्ट कार्रवाई के साथJPKI_REVOCATION_UNCHECKED)। - Declined (अस्वीकृत) — कम से कम एक ऐसी चेतावनी सक्रिय हुई जिसकी कॉन्फ़िगर की गई कार्रवाई Decline (अस्वीकार करें) है (उदाहरण के लिए
NFC_AND_OCR_DATA_NOT_SAMEजब डेटा-विसंगति कार्रवाई को अस्वीकार करने पर सेट किया गया हो)। - Not Finished — उपयोगकर्ता ने NFC चरण कभी पूरा नहीं किया; चिप पढ़ने की प्रक्रिया को छोड़ दिया गया था या डिवाइस NFC का समर्थन नहीं करता था।
- Resub Requested — एक समीक्षक ने उपयोगकर्ता से पुनः सबमिट करने के लिए कहा; रिपोर्ट को एक नए प्रयास द्वारा प्रतिस्थापित किया जाएगा।
API रिस्पॉन्स में यह कहाँ दिखाई देती है
NFC रिपोर्टnfc_verifications[] ऐरे के अंदर आती है — हमेशा एक JSON ऐरे, कभी भी एकल nfc ऑब्जेक्ट नहीं। जब कोई वर्कफ़्लो एक से अधिक बार NFC चलाता है (उदाहरण के लिए एक स्टेप-अप फ़्लो), तो कई प्रविष्टियाँ दिखाई देती हैं; प्रत्येक प्रविष्टि का अपना node_id होता है।
- सत्र निर्णय API —
GET /v3/session/{sessionId}/decision/के शीर्ष स्तर परnfc_verifications[]के रूप में दिखाई देता है। सत्र निर्णय प्राप्त करें देखें। - webhook — एक बार जब NFC चरण डेटा उत्पन्न कर लेता है, तो
status.updatedpayload में वहीnfc_verifications[]ऐरे शामिल होता है। webhook देखें। - स्टैंडअलोन NFC — सीधे चिप सबमिशन के लिए, NFC अवलोकन देखें।
nfc_skip_reason फ़ील्ड भी होता है जो यह बताता है कि वास्तव में ऐसा क्यों हुआ — दस्तावेज़ में कोई चिप नहीं है, जारीकर्ता देश का प्रमाणपत्र अनुपलब्ध है, डिवाइस में कोई NFC रीडर नहीं है, सत्यापन बिना किसी नेटिव SDK के चला (ब्राउज़र से कोई NFC एक्सेस नहीं), चिप एक्सेस कुंजी MRZ से प्राप्त नहीं की जा सकी, My Number Card को JPKI के माध्यम से नहीं पढ़ा जा सका, या उपयोगकर्ता ने इसे छोड़ना चुना। उस वर्गीकरण से बाहर के परिणामों के लिए यह null रहता है — आमतौर पर ऐसा उपयोगकर्ता जिसने प्रयास के बीच में ही छोड़ दिया (रिपोर्ट स्थिति Not Finished) या कोई ऐसा सत्र जहाँ NFC अभी भी लंबित है। सटीक मानों के लिए स्किप करने के कारण देखें।
पुराने दस्तावेज़ों में एकल
nfc फ़ील्ड का संदर्भ दिया गया था। वह संरचना v3 निर्णय endpoint पर मौजूद नहीं है — यह केवल स्पष्ट रूप से V2 webhook पर पिन किए गए गंतव्यों पर दिखाई देती है, जहाँ यह chip_protocol और jpki भी ले जाती है। हमेशा response.nfc_verifications[0] पढ़ें और ऐरे पर पुनरावृत्ति करें।स्कीमा
प्रामाणिक फ़ील्ड-दर-फ़ील्ड स्कीमा डेटा मॉडल संदर्भ पेज पर उपलब्ध है। नीचे दिए गए फ़ील्ड उस प्रामाणिक स्कीमा को दर्शाते हैं।स्थिति मान
दो प्रमाणपत्र चेतावनियाँ (
DSC_CERTIFICATE_REVOKED, DSC_CERTIFICATE_EXPIRED) केवल सूचनात्मक हैं: वे warnings[] में दिखाई देती हैं लेकिन अपने आप NFC status को कभी नहीं बदलती हैं। संपूर्ण व्यवहार मैट्रिक्स के लिए NFC चेतावनियाँ देखें।उदाहरण
Approved — चिप पढ़ी गई और क्रिप्टोग्राफ़िक रूप से मान्य
Declined — OCR / चिप मिसमैच
Japan My Number Card (JPKI)
नेटिव SDK में Japan My Number Card को JPKI के माध्यम से पढ़ा जाता है: व्यक्ति कार्ड पिन दर्ज करता है और कार्ड एक वन-टाइम चैलेंज पर हस्ताक्षर करता है (देखें यह कैसे काम करता है)। इसकी रिपोर्ट मेंchip_protocol: "jpki" होता है और यह jpki के तहत साक्ष्य ले जाती है। portrait_image, signature_image, chip_data, authenticity और certificate_summary null होते हैं, क्योंकि कार्ड में कोई ICAO डेटा नहीं होता है।
JPKI फ़ील्ड
रिपोर्ट में कभी भी प्रमाणपत्र स्वयं, उनके सीरियल नंबर, हस्ताक्षर या कार्ड का 12-अंकीय व्यक्तिगत नंबर (My Number) शामिल नहीं होता है, जिसे NFC चरण कभी नहीं पढ़ता है।
उदाहरण: My Number Card पठन
revocation_status: "unchecked", एक JPKI_REVOCATION_UNCHECKED चेतावनी, और status: "In Review" होता है। देखें NFC चेतावनियाँ।
सुरक्षा नोट
NFC चिप डेटा जारीकर्ता प्राधिकरण द्वारा हस्ताक्षरित होता है, इसलिएsod_integrity: true और dg_integrity: true के साथ एक स्वीकृत रिपोर्ट सबसे मजबूत संभावित पहचान साक्ष्य है जो Didit प्रस्तुत कर सकता है। हस्ताक्षरित छवि URL (portrait_image, signature_image) को अल्पकालिक मानें: उन्हें तुरंत डाउनलोड करें और उन्हें सार्वजनिक रूप से कैश न करें — जब आपको नए लिंक की आवश्यकता हो तो निर्णय का पुनः अनुरोध करें।
संबंधित
- NFC चेतावनियाँ — पूर्ण चेतावनी एनम, कारण और समाधान।
- webhook — NFC रिपोर्ट प्राप्त करने के लिए
status.updatedइवेंट सुनें। - डेटा मॉडल — NFC सत्यापन — प्रत्येक फ़ील्ड के साथ कैनोनिकल स्कीमा।
- समर्थित दस्तावेज़ — Didit कौन से ई-दस्तावेज़ NFC के माध्यम से पढ़ सकता है।