> ## 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)।

## उपयोगकर्ताओं के लिए समर्थित पहचानकर्ता प्रकार

| प्रकार | Key | कब मेल खाता है |
| - | - | - |
| चेहरा | `FACE` | किसी नए सत्र की लाइवनेस सेल्फ़ी ब्लॉकलिस्ट किए गए चेहरे से मेल खाती है |
| दस्तावेज़ नंबर | `DOCUMENT` | किसी नई ID सबमिशन का दस्तावेज़ नंबर ब्लॉकलिस्ट किए गए दस्तावेज़ नंबर से मेल खाता है |
| ईमेल | `EMAIL` | कोई नया सत्र या लेन-देन ब्लॉकलिस्ट किए गए ईमेल का उपयोग करता है |
| फ़ोन | `PHONE` | कोई नया सत्र या लेन-देन ब्लॉकलिस्ट किए गए फ़ोन का उपयोग करता है |
| IP पता | `IP_ADDRESS` | सबमिट करने वाले का IP मेल खाता है। यह एकल IP (`1.2.3.4`) और CIDR रेंज (`10.0.0.0/8`) दोनों का समर्थन करता है |
| डिवाइस फ़िंगरप्रिंट | `DEVICE_FINGERPRINT` | सबमिट करने वाले के डिवाइस का फ़िंगरप्रिंट मेल खाता है |
| उपयोगकर्ता | `USER` | सत्र या लेन-देन ब्लॉकलिस्ट किए गए `vendor_data` का उपयोग करता है |

हर पहचानकर्ता प्रकार उसके स्वाभाविक संपर्क बिंदु पर लागू होता है:

* चेहरा और दस्तावेज़: नए सत्र के दौरान लागू होते हैं।
* ईमेल और फ़ोन: उस सत्र चरण के दौरान लागू होते हैं जो इन्हें एकत्र करता है, या लेन-देन पेलोड के दौरान।
* IP और डिवाइस: सत्र में डिवाइस और IP विश्लेषण के दौरान लागू होते हैं।
* उपयोगकर्ता vendor\_data: सत्र या लेन-देन बनाने के दौरान लागू होता है।

## ब्लॉकलिस्टिंग कैसे होती है

> [!NOTE]
>
> अस्वीकृत सत्र किसी को भी ब्लॉकलिस्ट नहीं करता। सत्र `Declined` पर समाप्त होता है, उपयोगकर्ता `ACTIVE` बना रहता है और कोई सूची प्रविष्टि नहीं लिखी जाती, इसलिए वही व्यक्ति दूसरा सत्र शुरू कर सकता है। ब्लॉकलिस्टिंग एक मैन्युअल चरण है: [Blocklist पेज](https://docs.didit.me/hi/console/blocklist-users.md) से या [Lists API](https://docs.didit.me/hi/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/hi/management-api/lists/overview.md) का उपयोग करें। यही API कंसोल भी पर्दे के पीछे उपयोग करता है।

## सिस्टम सूचियाँ बनाम कस्टम सूचियाँ

हर एप्लिकेशन में **सिस्टम ब्लॉकलिस्ट** होती हैं, जिनमें हर पहचानकर्ता प्रकार के लिए एक शामिल है, और इन्हें Didit स्वतः प्रबंधित करता है। आप इनका नाम नहीं बदल सकते और न इन्हें हटा सकते हैं। कस्टम सूचियाँ आपकी हैं: आप इन्हें बना सकते हैं, नाम दे सकते हैं और दायरा तय कर सकते हैं।

| सूची | किसने बनाई | विवरण |
| - | - | - |
| System Face Blocklist | Didit | एप्लिकेशन के लिए मानक चेहरा ब्लॉकलिस्ट |
| System Document Blocklist | Didit | मानक दस्तावेज़ नंबर ब्लॉकलिस्ट |
| System Email Blocklist | Didit | मानक ईमेल ब्लॉकलिस्ट |
| System Phone Blocklist | Didit | मानक फ़ोन ब्लॉकलिस्ट |
| System User Blocklist | Didit | ब्लॉक किए गए `vendor_data` पहचानकर्ता |
| कस्टम ब्लॉकलिस्ट | आप | दायरे वाली सूचियाँ, जैसे क्षेत्र, पार्टनर या जोखिम स्तर के अनुसार |

## Lists API से उपयोगकर्ता को ब्लॉकलिस्ट में जोड़ना

ब्लॉकलिस्ट प्रविष्टि जोड़ने के लिए [Lists API](https://docs.didit.me/hi/management-api/lists/overview.md) का उपयोग करें। `vendor_data` से उपयोगकर्ता को ब्लॉक करने के लिए संबंधित ब्लॉकलिस्ट में USER प्रकार की प्रविष्टि जोड़ें:

1. `entry_type=user` और `is_system=true` से फ़िल्टर करके [सभी सूचियाँ सूचीबद्ध करें](https://docs.didit.me/hi/management-api/lists/list.md), ताकि सिस्टम उपयोगकर्ता ब्लॉकलिस्ट मिल सके।
2. उस सूची पर [एक प्रविष्टि बनाएँ](https://docs.didit.me/hi/management-api/lists/create-entry.md), जिसमें `value` को उपयोगकर्ता के `vendor_data` पर सेट करें।

चेहरे से उपयोगकर्ता को ब्लॉक करने के लिए [चेहरे और बायोमेट्रिक्स](https://docs.didit.me/hi/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**: सूची UUID और प्रविष्टि UUID के साथ [Delete entry](https://docs.didit.me/hi/management-api/lists/delete-entry.md) endpoint का उपयोग करें।

प्रविष्टि हटाने से उपयोगकर्ता अपने-आप `ACTIVE` स्थिति में वापस नहीं आता। यदि आप नए सत्रों की अनुमति देना चाहते हैं, तो स्थिति बदलने के लिए `PATCH /v3/users/{vendor_data}/update-status/` का उपयोग करें।

## ब्लॉकलिस्ट ऑडिट ट्रेल

ब्लॉकलिस्ट पर जोड़ने और हटाने की हर कार्रवाई [ऑडिट लॉग](https://docs.didit.me/hi/console/audit-logs.md) में दर्ज होती है:

* किसने प्रविष्टि जोड़ी (उपयोगकर्ता ईमेल या `'system'`, `'api'`)।
* कब।
* कारण समझाने वाली वैकल्पिक `comment`।
* यदि प्रविष्टि स्वचालित रूप से बनी थी, तो जुड़ा सत्र या लेन-देन।

## अगले कदम

> [card] [Lists API](https://docs.didit.me/hi/management-api/lists/overview.md)
>
> ब्लॉकलिस्ट / अलाउलिस्ट API का पूरा संदर्भ।

> [card] [कंसोल ब्लॉकलिस्ट](https://docs.didit.me/hi/console/blocklist-users.md)
>
> UI से ब्लॉकलिस्ट प्रबंधित करें।

> [card] [चेहरे और बायोमेट्रिक्स](https://docs.didit.me/hi/entities/users/faces-and-biometrics.md)
>
> चेहरा ब्लॉकलिस्ट कैसे काम करती हैं।


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