> ## 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. # Liste de blocage utilisateurs : visages, docs, e-mails > Découvrez comment Didit applique les blocages sur les entités User : types d'identifiants, vérification d'un blocage, ajout ou suppression d'une entrée. Les listes de blocage empêchent les utilisateurs ayant échoué à vos contrôles de conformité de créer de nouvelles sessions ou d'effectuer de nouvelles transactions. Didit prend en charge les listes de blocage par **type d'identifiant**, ce qui vous permet de bloquer le même acteur malveillant à partir de plusieurs données (visage, document, e-mail, téléphone, vendor\_data de l'utilisateur). ## Types d'identifiants pris en charge pour les utilisateurs | Type | Clé | Correspond lorsque… | | - | - | - | | Visage | `FACE` | Le selfie de détection du vivant d'une nouvelle session correspond au visage figurant sur la liste de blocage | | Numéro de document | `DOCUMENT` | Une nouvelle soumission de pièce d'identité correspond au numéro de document figurant sur la liste de blocage | | E-mail | `EMAIL` | Une nouvelle session ou transaction utilise l'e-mail figurant sur la liste de blocage | | Téléphone | `PHONE` | Une nouvelle session ou transaction utilise le téléphone figurant sur la liste de blocage | | Adresse IP | `IP_ADDRESS` | L'adresse IP de l'auteur de la soumission correspond. Prend en charge les adresses IP uniques (`1.2.3.4`) et les plages CIDR (`10.0.0.0/8`) | | Empreinte de l'appareil | `DEVICE_FINGERPRINT` | L'empreinte de l'appareil de l'auteur de la soumission correspond | | Utilisateur | `USER` | La session ou la transaction utilise le `vendor_data` figurant sur la liste de blocage | Chaque type d'identifiant est appliqué au point de contact naturel : * Visage et document : appliqué lors d'une nouvelle session. * E-mail et téléphone : appliqué lors d'une étape de session qui les collecte, ou dans le payload d'une transaction. * Adresse IP et empreinte de l'appareil : appliqué pendant l'Analyse de l'appareil et de l'IP dans une session. * vendor\_data de l'utilisateur : appliqué lors de la création de la session ou de la transaction. ## Comment le blocage s'effectue > [!NOTE] > > Une session refusée n'ajoute personne à une liste de blocage. La session passe à l'état `Declined`, l'utilisateur reste `ACTIVE` et aucune entrée n'est écrite dans la liste, de sorte que la même personne peut démarrer une autre session. Le blocage est une étape manuelle : ajoutez l'entrée depuis la [page Liste de blocage](https://docs.didit.me/fr/console/blocklist-users.md) ou avec l'[API Lists](https://docs.didit.me/fr/management-api/lists/overview.md). Une entrée de type `USER` (le `vendor_data` de l'utilisateur) passe également le statut de l'utilisateur à `BLOCKED`. **1. Automatique : en cas de correspondance avec la liste de blocage** Lorsqu'une session entrante correspond à une entrée existante de la liste de blocage, la session est refusée automatiquement avec un code de motif tel que `blocked_face`, `blocked_document`, `blocked_email`, etc. **2. Manuel : depuis la console** Un analyste ajoute un utilisateur à la liste de blocage depuis *Users → \[user] → Actions → Add to blocklist*, en choisissant un ou plusieurs identifiants à capturer. **3. Programmatique : via l'API Lists** Utilisez l'[API Lists](https://docs.didit.me/fr/management-api/lists/overview.md) pour ajouter des entrées par programmation. C'est la même API que celle qu'utilise la console en coulisses. ## Listes système et listes personnalisées Chaque application dispose de **listes de blocage système**, une par type d'identifiant, que Didit gère automatiquement. Vous ne pouvez pas les renommer ni les supprimer. Les listes personnalisées sont à vous : vous les créez, les nommez et définissez leur périmètre. | Liste | Créée par | Description | | - | - | - | | Liste de blocage système des visages | Didit | Liste de blocage canonique des visages pour l'application | | Liste de blocage système des numéros de document | Didit | Liste de blocage canonique des numéros de document | | Liste de blocage système des e-mails | Didit | Liste de blocage canonique des e-mails | | Liste de blocage système des téléphones | Didit | Liste de blocage canonique des téléphones | | Liste de blocage système des utilisateurs | Didit | Identifiants `vendor_data` bloqués | | Listes personnalisées | Vous | Listes à périmètre défini, par exemple par région, par partenaire ou par niveau de risque | ## Ajouter un utilisateur à la liste de blocage via l'API Utilisez l'[API Lists](https://docs.didit.me/fr/management-api/lists/overview.md) pour ajouter une entrée à une liste de blocage. Pour bloquer un utilisateur par son `vendor_data`, ajoutez une entrée de type USER à la liste de blocage correspondante : 1. [Listez toutes les listes](https://docs.didit.me/fr/management-api/lists/list.md) filtrées avec `entry_type=user` et `is_system=true` pour trouver la liste de blocage système des utilisateurs. 2. [Créez une entrée](https://docs.didit.me/fr/management-api/lists/create-entry.md) sur cette liste, avec `value` défini sur le `vendor_data` de l'utilisateur. Pour bloquer un utilisateur par visage, consultez [Visages et biométrie](https://docs.didit.me/fr/entities/users/faces-and-biometrics.md#téléverser-un-visage-dans-la-liste-de-blocage). Pour bloquer par e-mail, téléphone, document ou adresse IP, utilisez la liste de blocage système correspondante avec l'identifiant approprié dans `value`. ## Déroulement de l'application du blocage ```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) ``` Pour les listes de blocage de visages et de documents, la vérification intervient à l'étape de vérification : ```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) ``` ## Retirer de la liste de blocage * **Console** : *Blocklist → \[type] → row actions → Remove*. * **API** : utilisez l'endpoint [Supprimer une entrée](https://docs.didit.me/fr/management-api/lists/delete-entry.md) avec l'UUID de la liste et l'UUID de l'entrée. La suppression de l'entrée ne remet pas automatiquement l'utilisateur à `ACTIVE`. Utilisez `PATCH /v3/users/{vendor_data}/update-status/` pour modifier le statut si vous souhaitez autoriser de nouvelles sessions. ## Journal d'audit des listes de blocage Chaque ajout ou retrait sur une liste de blocage est consigné dans le [journal d'audit](https://docs.didit.me/fr/console/audit-logs.md) : * Qui a ajouté l'entrée (e-mail de l'utilisateur, ou `'system'` ou `'api'`). * La date et l'heure. * Un `comment` facultatif expliquant le motif. * La session ou la transaction liée, si l'entrée a été générée automatiquement. ## Étapes suivantes > [card] [API Lists](https://docs.didit.me/fr/management-api/lists/overview.md) > > Référence complète de l'API des listes de blocage et d'autorisation. > [card] [Liste de blocage dans la console](https://docs.didit.me/fr/console/blocklist-users.md) > > Gérez vos listes de blocage depuis l'interface. > [card] [Visages et biométrie](https://docs.didit.me/fr/entities/users/faces-and-biometrics.md) > > Fonctionnement des listes de blocage de visages. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.