> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# قائمة حظر المستخدمين: حظر الوجوه والمستندات والبريد الإلكتروني

> كيف يطبّق Didit الحظر على كيانات المستخدمين: أنواع المعرّفات، وطريقة فحص الحظر، وكيفية إضافة سجل أو إزالته.

## أنواع المعرّفات المدعومة للمستخدمين

تمنع قوائم الحظر المستخدمين الذين أخفقوا في فحوصات الامتثال لديك من إنشاء جلسات جديدة أو تنفيذ معاملات جديدة. يدعم Didit قوائم الحظر حسب **نوع المعرّف**، وبذلك يمكنك حظر الجهة المسيئة نفسها عبر عدة نقاط بيانات (الوجه، والمستند، والبريد الإلكتروني، ورقم الهاتف، وvendor\_data الخاص بالمستخدم).

| النوع | المفتاح | يتطابق عندما… |
| - | - | - |
| الوجه | `FACE` | تتطابق صورة سيلفي الخاصة بكشف الحيوية في الجلسة الجديدة مع الوجه المدرج في قائمة الحظر |
| رقم المستند | `DOCUMENT` | يتطابق رقم المستند في تقديم الهوية الجديد مع رقم المستند المدرج في قائمة الحظر |
| البريد الإلكتروني | `EMAIL` | تستخدم جلسة جديدة أو معاملة جديدة البريد الإلكتروني المدرج في قائمة الحظر |
| الهاتف | `PHONE` | تستخدم جلسة جديدة أو معاملة جديدة رقم الهاتف المدرج في قائمة الحظر |
| عنوان IP | `IP_ADDRESS` | يتطابق عنوان IP الخاص بمقدّم الطلب، ويدعم عناوين IP فردية (`1.2.3.4`) ونطاقات CIDR (`10.0.0.0/8`) |
| بصمة الجهاز | `DEVICE_FINGERPRINT` | تتطابق بصمة جهاز مقدّم الطلب |
| المستخدم | `USER` | تستخدم الجلسة أو المعاملة معرّف `vendor_data` المدرج في قائمة الحظر |

يُطبَّق كل نوع معرّف عند نقطة التفاعل الطبيعية له:

* الوجه والمستند: يُطبَّقان أثناء جلسة جديدة.
* البريد الإلكتروني والهاتف: يُطبَّقان أثناء خطوة في الجلسة تجمع هذه البيانات، أو أثناء payload المعاملة.
* عنوان IP والجهاز: يُطبَّقان أثناء تحليل الجهاز وعنوان IP في الجلسة.
* vendor\_data الخاص بالمستخدم: يُطبَّق أثناء إنشاء الجلسة أو المعاملة.

## كيف يتم الحظر

> [!NOTE]
>
> الجلسة المرفوضة لا تُدرج أي شخص في قائمة الحظر. تنتهي الجلسة بالحالة `Declined`، ويبقى المستخدم `ACTIVE` ولا يُكتب أي إدخال في القائمة، لذلك يستطيع الشخص نفسه بدء جلسة أخرى. الحظر خطوة يدوية: أضف الإدخال من [صفحة قائمة الحظر](https://docs.didit.me/ar/console/blocklist-users.md) أو عبر [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md). كما أن إدخال `USER` (وهو `vendor_data` الخاص بالمستخدم) يضبط حالة المستخدم أيضًا على `BLOCKED`.

**1. تلقائي: عند تطابق قائمة الحظر**

عندما تتطابق جلسة واردة مع إدخال موجود في قائمة الحظر، تُرفض الجلسة تلقائيًا برمز سبب مثل `blocked_face` و`blocked_document` و`blocked_email` وغيرها.

**2. يدوي: من وحدة التحكم**

يضيف المحلل المستخدم إلى قائمة الحظر من *Users → \[user] → Actions → Add to blocklist*، ويختار معرّفًا واحدًا أو أكثر ليتم حفظه.

**3. برمجي: عبر Lists API**

استخدم [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md) لإضافة الإدخالات برمجيًا. وهذه هي واجهة البرمجة نفسها التي تستخدمها وحدة التحكم في الخلفية.

## القوائم النظامية مقابل القوائم المخصصة

لكل تطبيق **قوائم حظر نظامية**، قائمة واحدة لكل نوع معرّف، يديرها Didit تلقائيًا. لا يمكنك إعادة تسميتها أو حذفها. أما القوائم المخصصة فأنت من ينشئها ويسميها ويحدد نطاقها.

| القائمة | أنشأها | الوصف |
| - | - | - |
| قائمة الوجوه النظامية | Didit | قائمة حظر الوجوه المرجعية للتطبيق |
| قائمة المستندات النظامية | Didit | قائمة حظر أرقام المستندات المرجعية |
| قائمة البريد الإلكتروني النظامية | Didit | قائمة حظر البريد الإلكتروني المرجعية |
| قائمة الهواتف النظامية | Didit | قائمة حظر أرقام الهواتف المرجعية |
| قائمة المستخدمين النظامية | Didit | معرّفات `vendor_data` المحظورة |
| القوائم المخصصة | أنت | قوائم بنطاق محدد، مثل قائمة لكل منطقة أو شريك أو مستوى من مستويات المخاطر |

## إضافة مستخدم إلى قائمة الحظر عبر API

استخدم [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md) لإضافة إدخال إلى قائمة الحظر. لحظر مستخدم باستخدام `vendor_data`، أضف إدخالًا من نوع USER إلى قائمة الحظر المناسبة:

1. [اعرض جميع القوائم](https://docs.didit.me/ar/management-api/lists/list.md) مرشّحةً بالقيمتين `entry_type=user` و`is_system=true` للعثور على قائمة المستخدمين النظامية.
2. [أنشئ إدخالًا](https://docs.didit.me/ar/management-api/lists/create-entry.md) في تلك القائمة، واضبط `value` على `vendor_data` الخاص بالمستخدم.

لحظر مستخدم عبر الوجه، راجع [الوجوه والبيانات البيومترية](https://docs.didit.me/ar/entities/users/faces-and-biometrics.md#رفع-وجه-إلى-قائمة-الحظر). ولحظره عبر البريد الإلكتروني أو الهاتف أو المستند أو عنوان IP، استخدم قائمة الحظر النظامية المناسبة مع المعرّف الملائم في `value`.

## سير التنفيذ

```mermaid theme={null}
sequenceDiagram
    participant Client
    participant Didit
    participant Lists as Blocklist check
    participant Workflow
    Client->>Didit: POST /v3/session/ (vendor_data=user-42)
    Didit->>Lists: Does user-42 match a USER blocklist?
    Lists-->>Didit: Match found
    Didit-->>Client: Session auto-declined (reason: blocked_user)
```

بالنسبة إلى قوائم حظر الوجوه والمستندات، يتم الفحص في خطوة التحقق:

```mermaid theme={null}
sequenceDiagram
    participant User
    participant Didit
    participant Lists as Face Blocklist
    User->>Didit: Liveness capture
    Didit->>Lists: Embedding search
    Lists-->>Didit: Match similarity > threshold
    Didit-->>User: Session declined (reason: blocked_face)
```

## الإزالة من قائمة الحظر

* **وحدة التحكم**: *Blocklist → \[type] → row actions → Remove*.
* **API**: استخدم endpoint [حذف إدخال](https://docs.didit.me/ar/management-api/lists/delete-entry.md) مع UUID القائمة وUUID الإدخال.

إزالة الإدخال لا تعيد المستخدم تلقائيًا إلى `ACTIVE`. استخدم `PATCH /v3/users/{vendor_data}/update-status/` لتغيير الحالة إذا أردت السماح بجلسات جديدة.

## سجل تدقيق قوائم الحظر

تُسجَّل كل عملية إضافة أو إزالة إلى قائمة الحظر في [سجل التدقيق](https://docs.didit.me/ar/console/audit-logs.md):

* من أضاف الإدخال (البريد الإلكتروني للمستخدم، أو `'system'`، أو `'api'`).
* متى.
* حقل `comment` اختياري يوضح سبب الإجراء.
* الجلسة أو المعاملة المرتبطة، إذا أُنشئ الإدخال تلقائيًا.

## الخطوات التالية

> [card] [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md)
>
> المرجع الكامل لواجهة API لقوائم الحظر والسماح.

> [card] [قائمة الحظر في وحدة التحكم](https://docs.didit.me/ar/console/blocklist-users.md)
>
> إدارة قوائم الحظر من الواجهة.

> [card] [الوجوه والبيانات البيومترية](https://docs.didit.me/ar/entities/users/faces-and-biometrics.md)
>
> كيف تعمل قوائم حظر الوجوه.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.