نظرة عامة
تُشير التحذيرات في تقرير NFC إلى كل حالة لاحظتها Didit أثناء قراءة الشريحة والتحقق من صحتها. وتظهر في مصفوفةwarnings[] لكل عنصر في nfc_verifications[] (انظر تقرير NFC)، مع تعيين feature إلى "NFC". يتبع كل إدخال شكل عنصر التحذير المشترك: feature وrisk وadditional_data وlog_type وshort_description وlong_description وnode_id.
يتكون كل تحذير من ثلاث طبقات:
- رمز
risk— معرّف ثابت يمكنك مطابقته برمجياً في الكود الخاص بك (الرموز الموضحة أدناه). - نوع السجل
log_type— إماinformationأوwarningأوerror. وهو مشتق من الإجراء الذي يحدده سير العمل الخاص بك لهذا الخطر: لا يوجد إجراء ←information، المراجعة ←warning، رفض ←error. - التأثير على القرار — يحدد الإجراء الذي تم تكوينه نفسه أيضاً قيمة
statusلتقرير NFC: يؤدي إجراء المراجعة إلى نقله إلىIn Review، بينما يؤدي إجراء الرفض إلى نقله إلىDeclined.
SKIPPED_NFC_VALIDATION وNFC_CHIP_NOT_VERIFIED وNFC_TRUST_ANCHOR_MISSING وNFC_AND_OCR_DATA_NOT_SAME)، بالإضافة إلى المخاطر الخمسة الخاصة بـ بطاقة My Number اليابانية، ولكل منها إعداد خاص به. يُعدّ خطرَا الشهادة (DSC_CERTIFICATE_REVOKED وDSC_CERTIFICATE_EXPIRED) لأغراض إعلامية فقط: فهما يحملان دائماً log_type: "information" ولا يغيران حالة NFC بمفردهما أبداً.
فيما يلي المجموعة الكاملة لرموز المخاطر التي تنشئها وحدة NFC. ولا توجد أي رموز مخاطر أخرى لـ NFC.
التحذيرات الناتجة
يتنافى
SKIPPED_NFC_VALIDATION مع NFC_CHIP_NOT_VERIFIED وNFC_TRUST_ANCHOR_MISSING: لا يتم تقييم تحذيرات التحقق من الشريحة إلا عندما لا يتم تخطي قراءة الشريحة. كما أن تحذيري التحقق من الشريحة متنافيان أيضاً.سلاسل الوصف الدقيقة
تُرجع API سلاسلshort_description وlong_description الدقيقة هذه لكل خطر:
أسباب التخطي
تحمل تحذيراتSKIPPED_NFC_VALIDATION الحقل additional_data.skip_reason، وهو أحد سبعة رموز ثابتة توضح بدقة سبب عدم تشغيل NFC (في الجلسات المسجلة قبل وجود أسباب التخطي، قد تكون قيمة additional_data هي null — تعامل مع الحقل على أنه اختياري عند معالجة القرارات السابقة). يظهر التصنيف نفسه على مستوى الجلسة كـ nfc_skip_reason في payload القرار — بما في ذلك الجلسات التي تعذر فيها تشغيل NFC على الإطلاق (مستند بدون شريحة، أو تكامل عبر الويب) وبالتالي لا يوجد لها تقرير أو تحذير NFC.
لا يوجد تقرير NFC وتحذير
SKIPPED_NFC_VALIDATION الخاص به إلا عندما يصل العميل إلى خطوة NFC ويتخطاها صراحةً (عادةً USER_SKIPPED، أو DEVICE_WITHOUT_NFC عندما يتضح أن القارئ غير متاح في وقت المسح). عندما يتم تجاوز خطوة NFC قبل أن يتسنى عرضها على الإطلاق — مستند بدون شريحة، أو شهادة مفقودة، أو عدم الإبلاغ عن إمكانية NFC، أو مفتاح MRZ غير قابل للقراءة، أو عدم توفر JPKI — لا يتم إنشاء أي تقرير أو تحذير ويظهر السبب فقط في حقل nfc_skip_reason على مستوى الجلسة، دون التأثير على حالة الجلسة.التكوين
تتحكم ثلاثة إعدادات في سير العمل في كيفية توجيه تحذيرات NFC. يمكن تعيين كل منها إلى لا يوجد إجراء، أو المراجعة، أو رفض:- إجراء تخطي NFC (
skip_nfc_action) — ينطبق علىSKIPPED_NFC_VALIDATION. لا يُعرض التخطي على المستخدمين إلا عند تمكينallow_nfc_skip. - إجراء الشريحة غير المتحقق منها (
unverified_chip_action) — ينطبق على كل منNFC_CHIP_NOT_VERIFIEDوNFC_TRUST_ANCHOR_MISSING، بحيث يظل سلوك حالة الجلسة كما هو بينما يوضح رمز المخاطر سبب فشل التحقق. - إجراء عدم تطابق البيانات (
inconsistent_data_action) — ينطبق علىNFC_AND_OCR_DATA_NOT_SAME. هذا هو نفس إعداد عدم تطابق البيانات المستخدم في التحقق من الهوية.
DSC_CERTIFICATE_* على إعداد إجراء — فهما دائماً لأغراض معلوماتية فقط. تحتوي مخاطر بطاقة My Number اليابانية على خمسة إعدادات إضافية، مذكورة في القسم التالي.
بطاقة My Number اليابانية (JPKI)
تتم قراءة بطاقة My Number اليابانية عبر JPKI بدلاً من ICAO 9303 (chip_protocol: "jpki")، لذا لا تُفعَّل مخاطر ICAO المذكورة أعلاه معها مطلقاً. وتثير قراءتها هذه المخاطر الخمسة بدلاً من ذلك، ولكل منها إعدادها الخاص في عقدة NFC:
تؤدي قراءة بطاقة My Number المتخطاة إلى إثارة
SKIPPED_NFC_VALIDATION وتتبع skip_nfc_action، تماماً مثل أي شريحة. راجع بطاقة My Number اليابانية (JPKI) لمعرفة كيفية عمل القراءة.
أمثلة
قيد المراجعة — تعذر التحقق من الشريحة
NFC_CHIP_NOT_VERIFIED القيمة log_type: "warning" وتكون حالة تقرير NFC هي In Review. ويُعد إدخال شهادة DSC منتهية الصلاحية إعلامياً بحتاً.
مرفوضة — عدم تطابق بين الشريحة وOCR
log_type: "error" وتكون حالة تقرير NFC هي Declined. لاحظ أن ocr_mrz عبارة عن مصفوفة من أسطر MRZ بينما nfc_mrz هو سلسلة MRZ نصية واحدة مدمجة خاصة بالشريحة.
قيد المراجعة: بطاقة My Number دون إجابة بشأن الإلغاء
jpki_revocation_unchecked_action بقيمته الافتراضية، Review، لذا يحمل التحذير القيمة log_type: "warning" وتكون حالة تقرير NFC هي In Review. وقد تم إثبات صحة البطاقة نفسها: كلٌّ من jpki.chain_valid وjpki.signature_valid يحملان القيمة true.
أنواع التحذيرات
يتم تعيين مستوى خطورة لكل خطر بناءً على تهيئة تطبيقك. ومستويات الخطورة الثلاثة هي:مواضيع ذات صلة
- تقرير NFC — مخطط التقرير الكامل وحالاته.
- Webhooks — يتم إطلاق
status.updatedعند تغيير حالة الجلسة؛ ويتم إرفاق payload القرار (بما في ذلك تحذيرات NFC) عندما تصل الجلسة إلى Approved أو Declined أو In Review أو Abandoned. - نماذج البيانات — التحقق عبر NFC — المخطط المرجعي حقلاً بحقل.
- نماذج البيانات — كائن التحذير — بنية كل إدخال في
warnings[].