बायोमेट्रिक प्रमाणीकरण रिपोर्ट: JSON स्कीमा

बायोमेट्रिक प्रमाणीकरण रिपोर्ट के माध्यम से Didit वापस लौटने वाले उपयोगकर्ता के पुनः सत्यापन की रिपोर्ट करता है। यह वर्कफ़्लो एक नया लाइवनेस चेक चलाता है और, जब वर्कफ़्लो में चेहरा मिलान सक्षम होता है, तो सत्र निर्माण के समय निर्धारित संदर्भ चेहरे (आपके द्वारा प्रदान की गई portrait_image, या vendor_data के ज़रिए खोजा गया उपयोगकर्ता का संग्रहीत चेहरा) के विरुद्ध 1:1 चेहरा मिलान करता है। दोनों चेक V3 सत्र निर्णय रिस्पॉन्स में मानक सुविधा आइटम के रूप में दिखाई देते हैं।

संग्रहीत पोर्ट्रेट के विरुद्ध लाइवनेस चेक और चेहरा मिलान को संयोजित करने वाली Didit बायोमेट्रिक प्रमाणीकरण रिपोर्ट

अवलोकन

बायोमेट्रिक प्रमाणीकरण एक वर्कफ़्लो प्रकार (workflow_type: "biometric_authentication") है, कोई अलग रिस्पॉन्स ऑब्जेक्ट नहीं। जब वर्कफ़्लो चलता है तो यह जनरेट करता है:

एक लाइवनेस चेक जो एक लाइव सेल्फ़ी कैप्चर करता है और स्पूफिंग के लिए इसे स्कोर करता है।
एक चेहरा मिलान जो कैप्चर किए गए चेहरे की तुलना सत्र निर्माण के समय निर्धारित संदर्भ चेहरे से करता है (केवल तभी जब वर्कफ़्लो में चेहरा मिलान सक्षम हो)।

जब भी वर्कफ़्लो में चेहरा मिलान शामिल होता है, सत्र निर्माण के लिए एक संदर्भ चेहरे की आवश्यकता होती है। portrait_image (base64-एनकोडेड इमेज, अधिकतम 2MB) भेजें, या इसे छोड़ दें और Didit vendor_data उपयोगकर्ता के लिए पहले से संग्रहीत चेहरे का पुनः उपयोग करता है: पहले एक स्वीकृत लाइवनेस चेहरा, फिर ePassport चिप फ़ोटो, फिर पहचान दस्तावेज़ का पोर्ट्रेट, फिर मैन्युअल रूप से दर्ज किया गया प्रोफ़ाइल चेहरा। यदि न तो portrait_image और न ही कोई संग्रहीत चेहरा उपलब्ध है, तो सत्र निर्माण 400 लौटाता है जिसमें

{"portrait_image": "No stored face image was found for this user. Send a portrait_image, or complete an approved verification with face liveness or an ID document for this vendor_data first."}

शामिल होता है। दोनों ही मामलों में निर्धारित संदर्भ नए सत्र के तहत रिकॉर्ड किया जाता है, इसलिए चेहरा मिलान आइटम का source_image_session_id उस सत्र के अपने session_id पर सेट होता है (यह आपको बताता है कि संदर्भ उसी सत्र में कैप्चर किए गए दस्तावेज़ पोर्ट्रेट के बजाय सत्र के संग्रहीत पोर्ट्रेट से आया है, जो इस फ़ील्ड को null छोड़ देगा)।

यह कहाँ दिखाई देता है

निर्णय रिस्पॉन्स कुंजी	बहुवचन	आइटम स्कीमा
`liveness_checks[]`	प्रति लाइवनेस चरण एक (बायोमेट्रिक प्रमाणीकरण में आमतौर पर 1)	data-models#liveness-check
`face_matches[]`	प्रति चेहरा मिलान चरण एक (केवल-लाइवनेस वर्कफ़्लो में `null`)	data-models#face-match

दोनों ऐरे उन सत्रों के लिए GET /v3/session/{sessionId}/decision/ द्वारा लौटाए जाते हैं जिनका वर्कफ़्लो प्रकार biometric_authentication है। वे हमेशा ऐरे होते हैं — कभी भी एकल ऑब्जेक्ट नहीं — और प्रत्येक तब तक null रहता है जब तक कि उसके चरण ने डेटा जनरेट न कर दिया हो। प्रत्येक आइटम में एक node_id होता है, ताकि बहु-इंस्टेंस वर्कफ़्लो में चरणों की पहचान अलग-अलग की जा सके।

स्कीमा संदर्भ

पूरी फ़ील्ड सूची डेटा-मॉडल पेज पर एक बार परिभाषित की गई है ताकि इन सुविधाओं को प्रदर्शित करने वाली प्रत्येक रिपोर्ट एकमात्र विश्वसनीय स्रोत साझा करे:

लाइवनेस आइटम स्कीमा — status, method, score, reference_image, video_url, age_estimation, matches[], face_quality, face_luminance, warnings[], node_id।
चेहरा मिलान आइटम स्कीमा — status, score, source_image_session_id, source_image, target_image, warnings[], node_id।
चेतावनी प्रविष्टि संरचना — feature, risk, additional_data, log_type, short_description, long_description, node_id।

स्टेटस मान

liveness_checks[].status और face_matches[].status दोनों साझा सुविधा जीवनचक्र (सुविधा-स्तरीय स्थितियाँ) का उपयोग करते हैं:

स्टेटस	अर्थ
`Not Finished`	चरण ने अभी तक कोई अंतिम परिणाम नहीं दिया है (उपयोगकर्ता ने इसे पूरा नहीं किया है, या छोड़ दिया है)। किसी चरण के शुरू होने से पहले, निर्णय रिस्पॉन्स में उसका ऐरे केवल `null` होता है।
`Approved`	चेक ने सभी कॉन्फ़िगर किए गए थ्रेशोल्ड पास कर लिए।
`In Review`	स्कोर समीक्षा बैंड में आ गया, या एक कॉन्फ़िगरेबल चेतावनी को समीक्षा पर सेट किया गया था।
`Declined`	स्कोर अस्वीकृति थ्रेशोल्ड पर या उससे नीचे गिर गया, या एक ऑटो-अस्वीकृति चेतावनी ट्रिगर हो गई (फ़ेस अटैक, कोई चेहरा नहीं मिला, चेहरा ब्लॉकलिस्ट में है, चेहरा मिलान के लिए कोई संदर्भ छवि नहीं)।
`Resub Requested`	एक समीक्षक ने उपयोगकर्ता से इस चरण का पुनः प्रयास करने के लिए कहा।

समग्र सत्र status दोनों आइटम को जोड़ता है: Declined में कोई भी सुविधा सत्र को अस्वीकृत कर देती है, In Review में कोई भी सुविधा सत्र को In Review में डाल देती है, अन्यथा Approved (प्रत्येक सुविधा समाप्त होने के बाद)। थ्रेशोल्ड व्यवहार और चेतावनी कोड की पूरी सूची के लिए, बायोमेट्रिक प्रमाणीकरण चेतावनियाँ देखें।

उदाहरण — लाइवनेस + चेहरा मिलान (स्वीकृत)

उदाहरण संक्षिप्त हैं: पूर्ण निर्णय एन्वेलप में session_url, metadata, callback, reviews, contact_details, expected_details, environment, created_at, और expires_at भी शामिल होते हैं।

{
  "session_id": "11111111-2222-3333-4444-555555555555",
  "session_kind": "user",
  "session_number": 1234,
  "status": "Approved",
  "workflow_id": "018e7b2c-5555-7777-9999-aaaaaaaaaaaa",
  "features": ["LIVENESS", "FACE_MATCH"],
  "vendor_data": "user-123",
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Approved",
      "method": "PASSIVE",
      "score": 89.92,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": 92.4,
      "face_luminance": 58.1,
      "warnings": []
    }
  ],
  "face_matches": [
    {
      "node_id": "feature_face_match",
      "status": "Approved",
      "score": 88.47,
      "source_image_session_id": "11111111-2222-3333-4444-555555555555",
      "source_image": "https://<media-host>/.../source.jpg",
      "target_image": "https://<media-host>/.../target.jpg",
      "warnings": []
    }
  ],
  "id_verifications": null,
  "nfc_verifications": null,
  "poa_verifications": null,
  "phone_verifications": null,
  "email_verifications": null,
  "aml_screenings": null
}

उदाहरण — केवल-लाइवनेस (वर्कफ़्लो में चेहरा मिलान अक्षम)

{
  "session_id": "22222222-3333-4444-5555-666666666666",
  "session_kind": "user",
  "status": "Approved",
  "workflow_id": "018e7b2c-6666-7777-9999-bbbbbbbbbbbb",
  "features": ["LIVENESS"],
  "vendor_data": "user-456",
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Approved",
      "method": "ACTIVE_3D",
      "score": 96.10,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": null,
      "face_luminance": null,
      "warnings": []
    }
  ],
  "face_matches": null
}

केवल-लाइवनेस मोड एक वर्कफ़्लो कॉन्फ़िगरेशन है: जब चेहरा मिलान अक्षम होता है, तो सत्र निर्माण के समय किसी संदर्भ चेहरे की आवश्यकता नहीं होती है और face_matches null रहता है। जब चेहरा मिलान सक्षम होता है, तो portrait_image को छोड़ने से यह केवल-लाइवनेस पर वापस नहीं जाता है: Didit vendor_data उपयोगकर्ता के लिए संग्रहीत चेहरे का पुनः उपयोग करता है, और यदि कोई संग्रहीत चेहरा मौजूद नहीं है तो सत्र निर्माण 400 के साथ विफल हो जाता है।

उदाहरण — कम समानता पर चेहरा मिलान अस्वीकृत

{
  "session_id": "33333333-4444-5555-6666-777777777777",
  "status": "Declined",
  "workflow_id": "018e7b2c-5555-7777-9999-aaaaaaaaaaaa",
  "liveness_checks": [
    {
      "node_id": "feature_liveness",
      "status": "Approved",
      "method": "PASSIVE",
      "score": 91.20,
      "reference_image": "https://<media-host>/.../reference.jpg",
      "video_url": "https://<media-host>/.../video.mp4",
      "age_estimation": null,
      "matches": [],
      "face_quality": 90.15,
      "face_luminance": 55.30,
      "warnings": []
    }
  ],
  "face_matches": [
    {
      "node_id": "feature_face_match",
      "status": "Declined",
      "score": 41.18,
      "source_image_session_id": "33333333-4444-5555-6666-777777777777",
      "source_image": "https://<media-host>/.../source.jpg",
      "target_image": "https://<media-host>/.../target.jpg",
      "warnings": [
        {
          "feature": "FACEMATCH",
          "risk": "LOW_FACE_MATCH_SIMILARITY",
          "additional_data": null,
          "log_type": "error",
          "short_description": "Low face match similarity",
          "long_description": "The facial features of the provided image don't closely match the reference image, suggesting a potential identity mismatch.",
          "node_id": "feature_face_match"
        }
      ]
    }
  ]
}

सुरक्षा नोट

reference_image, video_url, source_image, और target_image हस्ताक्षरित URL हैं जो एक सीमित वैधता विंडो (डिफ़ॉल्ट रूप से 4 घंटे) के बाद समाप्त हो जाते हैं। वे बायोमेट्रिक डेटा की ओर संकेत करते हैं — उन्हें सार्वजनिक रूप से कैश या प्रदर्शित न करें। अपने पक्ष में सत्यापन परिणाम (status, score, source_image_session_id) संग्रहीत करें; यदि आपको नए URL की आवश्यकता हो तो निर्णय endpoint को फिर से कॉल करें।

बायोमेट्रिक प्रमाणीकरण चेतावनियाँ

चेतावनी कोड, थ्रेशोल्ड, और स्वचालित अस्वीकृति शर्तें।

लाइवनेस रिपोर्ट

liveness_checks[] आइटम के लिए पूर्ण फ़ील्ड संदर्भ।

चेहरा मिलान रिपोर्ट

face_matches[] आइटम के लिए पूर्ण फ़ील्ड संदर्भ।

प्रमाणीकरण

सत्यापन

निगरानी

प्लेटफ़ॉर्म

बायोमेट्रिक प्रमाणीकरण रिपोर्ट: JSON स्कीमा

अवलोकन

यह कहाँ दिखाई देता है

स्कीमा संदर्भ

स्टेटस मान

उदाहरण — लाइवनेस + चेहरा मिलान (स्वीकृत)

उदाहरण — केवल-लाइवनेस (वर्कफ़्लो में चेहरा मिलान अक्षम)

उदाहरण — कम समानता पर चेहरा मिलान अस्वीकृत

सुरक्षा नोट

संबंधित

बायोमेट्रिक प्रमाणीकरण चेतावनियाँ

लाइवनेस रिपोर्ट

चेहरा मिलान रिपोर्ट

​अवलोकन

​यह कहाँ दिखाई देता है

​स्कीमा संदर्भ

​स्टेटस मान

​उदाहरण — लाइवनेस + चेहरा मिलान (स्वीकृत)

​उदाहरण — केवल-लाइवनेस (वर्कफ़्लो में चेहरा मिलान अक्षम)

​उदाहरण — कम समानता पर चेहरा मिलान अस्वीकृत

​सुरक्षा नोट

​संबंधित

बायोमेट्रिक प्रमाणीकरण चेतावनियाँ

लाइवनेस रिपोर्ट

चेहरा मिलान रिपोर्ट

अवलोकन

यह कहाँ दिखाई देता है

स्कीमा संदर्भ

स्टेटस मान

उदाहरण — लाइवनेस + चेहरा मिलान (स्वीकृत)

उदाहरण — केवल-लाइवनेस (वर्कफ़्लो में चेहरा मिलान अक्षम)

उदाहरण — कम समानता पर चेहरा मिलान अस्वीकृत

सुरक्षा नोट

संबंधित