تحذيرات التحقق من البريد الإلكتروني ورموز المخاطر

تُصدِر ميزة التحقق من البريد الإلكتروني تحذيرات كلما ظهرت إشارة مخاطر أثناء مسار OTP أو على العنوان نفسه: مثل حدوث تسريب بيانات معروف، أو استخدام مزود مؤقت، أو عدم إمكانية تسليم الرسائل إلى صندوق البريد، أو تجاوز الحد الأقصى لمحاولات OTP، أو وجود تطابق مع قائمة الحظر لديك أو مع عملية تحقق مقبولة أخرى. توضح هذه الصفحة جميع الرموز، ومسببات إطلاقها، وكيفية إعداد استجابة سير العمل.

نظرة عامة

تُصنَّف التحذيرات بالميزة EMAIL. وتظهر في التقرير ضمن email_verifications[].warnings[] وتتبع البنية القياسية لـ كائن التحذير (feature وrisk وadditional_data وlog_type وshort_description وlong_description وnode_id). كما يُوجَّه كل تحذير أيضاً إلى سجل الجلسة ليظهر في Business Console ضمن قسم البريد الإلكتروني. تُعد بعض التحذيرات مسببات رفض تلقائي صارم — حيث تضبط دائماً حالة الميزة إلى Declined وتحمل log_type: "error". بينما ترتبط التحذيرات الأخرى بـ إجراء قابل للإعداد (DECLINE، أو REVIEW، أو الإجراء الافتراضي NO_ACTION) يتم تحديده لكل عقدة سير عمل أو لكل استدعاء API، مما يتيح لنفس رمز المخاطر رفض سير عمل معين مع الاكتفاء بوضع علامة تنبيه في سير عمل آخر. كما يحدد الإجراء المُعدّ مستوى الخطورة: DECLINE → error، وREVIEW → warning، وNO_ACTION → information.

شروط الرفض التلقائي

تؤدي التحذيرات التالية دائماً إلى رفض خطوة التحقق من البريد الإلكتروني بغض النظر عن الإعدادات:

EMAIL_CODE_ATTEMPTS_EXCEEDED — استنفد المستخدم المحاولات المتاحة لرمز OTP: محاولتان لإدخال رمز غير صحيح (email_max_check_attempts) أو عمليتا إرسال لرمز 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"
    }
  ]
}

أنواع التحذيرات

يتم تعيين مستوى خطورة لكل خطر بناءً على تكوين التطبيق الخاص بك. وتنقسم مستويات الخطورة إلى ثلاث فئات:

المصادقة

التحقق

المراقبة

المنصة

تحذيرات التحقق من البريد الإلكتروني ورموز المخاطر

نظرة عامة

شروط الرفض التلقائي

المخاطر القابلة للإعداد

حدود محاولات التحقق

التحذيرات الناتجة

التطابقات عبر الجلسات

مثال

أنواع التحذيرات

مواضيع ذات صلة

​نظرة عامة

​شروط الرفض التلقائي

​المخاطر القابلة للإعداد

​حدود محاولات التحقق

​التحذيرات الناتجة

​التطابقات عبر الجلسات

​مثال

​أنواع التحذيرات

​مواضيع ذات صلة

نظرة عامة

شروط الرفض التلقائي

المخاطر القابلة للإعداد

حدود محاولات التحقق

التحذيرات الناتجة

التطابقات عبر الجلسات

مثال

أنواع التحذيرات

مواضيع ذات صلة