ईमेल सत्यापन चेतावनियाँ और जोखिम कोड

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

अवलोकन

चेतावनियों को सुविधा EMAIL के साथ टैग किया जाता है। वे रिपोर्ट पर email_verifications[].warnings[] के अंतर्गत दिखाई देती हैं और मानक चेतावनी ऑब्जेक्ट के आकार (feature, risk, additional_data, log_type, short_description, long_description, node_id) का पालन करती हैं। प्रत्येक चेतावनी को प्रति-सत्र लॉग में भी रूट किया जाता है ताकि यह Business Console में Email अनुभाग के अंतर्गत दिखाई दे। कुछ चेतावनियाँ हार्ड ऑटो-अस्वीकृति ट्रिगर हैं — वे हमेशा सुविधा स्थिति को Declined पर सेट करती हैं और उनमें log_type: "error" होता है। अन्य प्रति वर्कफ़्लो नोड या प्रति API कॉल परिभाषित एक कॉन्फ़िगर करने योग्य कार्रवाई (DECLINE, REVIEW, या डिफ़ॉल्ट NO_ACTION) पर मैप होती हैं, इसलिए वही जोखिम कोड एक वर्कफ़्लो को अस्वीकार कर सकता है जबकि दूसरे को केवल फ़्लैग कर सकता है। कॉन्फ़िगर की गई कार्रवाई गंभीरता भी सेट करती है: DECLINE → error, REVIEW → warning, NO_ACTION → information।

ऑटो-अस्वीकृति की शर्तें

निम्नलिखित चेतावनियाँ कॉन्फ़िगरेशन की परवाह किए बिना ईमेल सत्यापन चरण को हमेशा अस्वीकार करती हैं:

EMAIL_CODE_ATTEMPTS_EXCEEDED — उपयोगकर्ता ने OTP बजट समाप्त कर दिया: डिफ़ॉल्ट रूप से 2 गलत कोड प्रविष्टियाँ (email_max_check_attempts) या 2 OTP भेजना — प्रारंभिक भेजना और एक पुनः भेजना (email_max_retries)।
EMAIL_IN_BLOCKLIST — पता Lists API के माध्यम से प्रबंधित ब्लॉकलिस्ट में है, या पहले से स्वीकृत ईमेल सत्यापन से मेल खाता है जिसे ब्लॉकलिस्ट किया गया था।
UNDELIVERABLE_EMAIL_DETECTED — पता मेल प्राप्त नहीं कर सकता: अमान्य सिंटैक्स, अस्तित्वहीन डोमेन, DNS (MX) रिकॉर्ड का न होना, या OTP ईमेल डिलीवर नहीं किया जा सका। चरण तुरंत Declined के रूप में अंतिम रूप ले लेता है — कोई कोड जांच कभी नहीं चलती है। अपवाद: जब उपयोगकर्ता ने स्वयं पता टाइप किया हो (यह सत्र निर्माण के समय पहले से भरा नहीं गया था), तो डिलीवरी विफल होने पर भेजने का प्रयास एक इनलाइन त्रुटि लौटाता है ताकि वे अस्वीकृत होने के बजाय किसी भिन्न पते के साथ पुनः प्रयास कर सकें।

कॉन्फ़िगर करने योग्य जोखिम

निम्नलिखित प्रत्येक जोखिम एक सेटिंग (प्रति वर्कफ़्लो नोड, या स्टैंडअलोन जाँच endpoint पर प्रति कॉल) पर मैप होता है जिसे आप DECLINE, REVIEW, या NO_ACTION पर कॉन्फ़िगर कर सकते हैं:

सेटिंग	जोखिम कोड	डिफ़ॉल्ट व्यवहार
`breached_email_action`	`BREACHED_EMAIL_DETECTED`	`NO_ACTION` — स्थिति बदले बिना `information` स्तर पर ब्रीच विवरण दिखाएं।
`disposable_email_action`	`DISPOSABLE_EMAIL_DETECTED`	`NO_ACTION` — स्थिति बदले बिना `information` स्तर पर डिस्पोजेबल प्रदाता को फ़्लैग करें।
`duplicated_email_action`	`DUPLICATED_EMAIL`	`NO_ACTION` — `information` स्तर पर डुप्लिकेट रिकॉर्ड करें। जब पता अनुमति सूची में हो तो छोड़ दिया जाता है।

डुप्लिकेट पहचान केवल उसी एप्लिकेशन में पहले से स्वीकृत ईमेल सत्यापनों पर विचार करती है, जिन्हें vendor_data द्वारा समूहीकृत किया जाता है — समान vendor_data साझा करने वाले सत्यापनों को एक ही अंतिम उपयोगकर्ता माना जाता है और बाहर रखा जाता है। vendor_data को खाली छोड़ दें और प्रत्येक सत्र को एक अलग उपयोगकर्ता माना जाता है। यदि पता आपकी ईमेल अनुमति सूची में है, तो डुप्लिकेट कार्रवाई को छोड़ दिया जाता है और इसके बजाय EMAIL_IN_ALLOWLIST उत्सर्जित होता है।

सत्यापन प्रयास सीमाएँ

ईमेल सत्यापन सुविधा दुरुपयोग को रोकने के लिए OTP प्रयासों पर एक सख्त सीमा लागू करती है:

कोड-प्रविष्टि प्रयास — email_max_check_attempts, डिफ़ॉल्ट 2: दूसरा गलत (या समय-सीमा समाप्त) कोड चरण को अंतिम रूप देता है।
भेजने के प्रयास — email_max_retries, डिफ़ॉल्ट रूप से कुल 2 बार भेजना (प्रारंभिक भेजना और एक बार पुनः भेजना): आगे पुनः भेजने का अनुरोध चरण को अंतिम रूप देता है।

किसी भी सीमा को पार करने पर EMAIL_CODE_ATTEMPTS_EXCEEDED उत्पन्न होता है और चरण ऑटो-अस्वीकृत हो जाता है। आप प्रति वर्कफ़्लो नोड दोनों सीमाओं को ट्यून कर सकते हैं।

उत्पन्न चेतावनियाँ

टैग	गंभीरता	विवरण
`EMAIL_CODE_ATTEMPTS_EXCEEDED`	`error`	उपयोगकर्ता कोड-प्रविष्टि या भेजने की सीमा पार कर गया। स्वतः अस्वीकृत होता है।
`EMAIL_IN_BLOCKLIST`	`error`	पता Lists API के माध्यम से बनाई गई ब्लॉकलिस्ट में मौजूद है, या ब्लॉकलिस्टेड स्वीकृत सत्यापन से मेल खाता है। स्वतः अस्वीकृत होता है। `additional_data` में `blocklisted_session_id`, `blocklisted_session_number` और `api_service` शामिल होते हैं (शुद्ध सूची मिलान के लिए सभी `null`)।
`EMAIL_IN_ALLOWLIST`	`information`	पता Lists API के माध्यम से बनाई गई अनुमति सूची से मेल खाता है, इसलिए डुप्लिकेट-ईमेल कार्रवाई छोड़ दी गई थी।
`BREACHED_EMAIL_DETECTED`	`breached_email_action` के अनुसार (डिफ़ॉल्ट रूप से `information`)	पता एक या अधिक ज्ञात डेटा उल्लंघनों में पाया गया था। रिपोर्ट पर `breaches[]` ऐरे में उल्लंघन की गई सेवा, तिथि और डेटा श्रेणियां शामिल होती हैं।
`DISPOSABLE_EMAIL_DETECTED`	`disposable_email_action` के अनुसार (डिफ़ॉल्ट रूप से `information`)	डोमेन एक ज्ञात डिस्पोज़ेबल / थ्रोअवे प्रदाता है जिसका उपयोग अक्सर ट्रैसेबिलिटी से बचने के लिए किया जाता है।
`UNDELIVERABLE_EMAIL_DETECTED`	`error`	पता मेल प्राप्त नहीं कर सकता (अमान्य सिंटैक्स, गैर-मौजूद डोमेन, अनुपलब्ध MX रिकॉर्ड, या विफल डिलीवरी)। स्वतः अस्वीकृत होता है।
`DUPLICATED_EMAIL`	`duplicated_email_action` के अनुसार (डिफ़ॉल्ट रूप से `information`)	पता किसी अन्य अंतिम उपयोगकर्ता (`vendor_data` द्वारा समूहीकृत) के पहले से स्वीकृत ईमेल सत्यापन से मेल खाता है। `additional_data` में `duplicated_session_id`, `duplicated_session_number` और `api_service` शामिल होते हैं।

प्रति प्रयास EMAIL_IN_BLOCKLIST, DUPLICATED_EMAIL और EMAIL_IN_ALLOWLIST में से अधिकतम एक ही ट्रिगर होता है — ब्लॉकलिस्ट को डुप्लिकेट पर प्राथमिकता मिलती है, और डुप्लिकेट को अनुमति सूची पर प्राथमिकता मिलती है।

क्रॉस-सत्र मिलान

जब कोई पता पहले से स्वीकृत ईमेल सत्यापनों में या आपकी ब्लॉकलिस्ट में पाया जाता है, तो वे मिलान email_verifications[].matches[] के तहत भी दिखाई देते हैं (अधिकतम 5 प्रविष्टियाँ)। प्रत्येक मिलान में session_id, session_number, vendor_data, verification_date, email, status, is_blocklisted, api_service शामिल होते हैं, और इसमें source का मान session (एक अन्य स्वीकृत सत्यापन) या list_entry (एक ब्लॉकलिस्ट प्रविष्टि) होता है। यदि वर्तमान पता आपकी ईमेल अनुमति सूची पर है, तो Didit मिलान साक्ष्य रखता है लेकिन डुप्लिकेट-ईमेल कार्रवाई लागू करने के बजाय EMAIL_IN_ALLOWLIST जारी करता है। संपूर्ण मिलान स्कीमा के लिए ईमेल सत्यापन रिपोर्ट देखें।

उदाहरण

{
  "warnings": [
    {
      "feature": "EMAIL",
      "risk": "EMAIL_IN_BLOCKLIST",
      "additional_data": {
        "blocklisted_session_id": null,
        "blocklisted_session_number": null,
        "api_service": null
      },
      "log_type": "error",
      "short_description": "Email in blocklist",
      "long_description": "The system detected that the email is in the blocklist, which is not allowed.",
      "node_id": "feature_email_1"
    },
    {
      "feature": "EMAIL",
      "risk": "DISPOSABLE_EMAIL_DETECTED",
      "additional_data": null,
      "log_type": "information",
      "short_description": "Disposable email detected",
      "long_description": "The system detected that the email is disposable, which is not allowed.",
      "node_id": "feature_email_1"
    }
  ]
}

चेतावनी के प्रकार

प्रत्येक जोखिम को आपके एप्लिकेशन के कॉन्फ़िगरेशन के आधार पर एक गंभीरता सौंपी जाती है। गंभीरताएँ तीन श्रेणियों में आती हैं:

प्रमाणीकरण

सत्यापन

निगरानी

प्लेटफ़ॉर्म

ईमेल सत्यापन चेतावनियाँ और जोखिम कोड

अवलोकन

ऑटो-अस्वीकृति की शर्तें

कॉन्फ़िगर करने योग्य जोखिम

सत्यापन प्रयास सीमाएँ

उत्पन्न चेतावनियाँ

क्रॉस-सत्र मिलान

उदाहरण

चेतावनी के प्रकार

संबंधित

​अवलोकन

​ऑटो-अस्वीकृति की शर्तें

​कॉन्फ़िगर करने योग्य जोखिम

​सत्यापन प्रयास सीमाएँ

​उत्पन्न चेतावनियाँ

​क्रॉस-सत्र मिलान

​उदाहरण

​चेतावनी के प्रकार

​संबंधित

अवलोकन

ऑटो-अस्वीकृति की शर्तें

कॉन्फ़िगर करने योग्य जोखिम

सत्यापन प्रयास सीमाएँ

उत्पन्न चेतावनियाँ

क्रॉस-सत्र मिलान

उदाहरण

चेतावनी के प्रकार

संबंधित