> ## 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. # Lista de bloqueio: rostos, documentos e e-mails > O Didit bloqueia usuários por rosto, documento, e-mail, telefone ou vendor_data, com inclusão automática ou manual na lista de bloqueio. As listas de bloqueio impedem que usuários reprovados nas suas verificações de conformidade criem novas sessões ou realizem novas transações. A Didit organiza as listas de bloqueio por **tipo de identificador**, para que você possa bloquear o mesmo agente mal-intencionado em vários pontos de dados (rosto, documento, e-mail, telefone, vendor\_data do usuário). ## Tipos de identificador compatíveis para usuários | Tipo | Chave | Corresponde quando… | | - | - | - | | Rosto | `FACE` | A selfie de prova de vida de uma nova sessão corresponde ao rosto na lista de bloqueio | | Número do documento | `DOCUMENT` | Um novo envio de documento de identidade corresponde ao número de documento na lista de bloqueio | | E-mail | `EMAIL` | Uma nova sessão ou transação usa o e-mail na lista de bloqueio | | Telefone | `PHONE` | Uma nova sessão ou transação usa o telefone na lista de bloqueio | | Endereço IP | `IP_ADDRESS` | O IP de quem envia corresponde. Aceita IPs individuais (`1.2.3.4`) e intervalos CIDR (`10.0.0.0/8`) | | Impressão digital do dispositivo | `DEVICE_FINGERPRINT` | A impressão digital do dispositivo de quem envia corresponde | | Usuário | `USER` | A sessão ou transação usa o `vendor_data` na lista de bloqueio | Cada tipo de identificador é aplicado no momento apropriado: * Rosto e documento: aplicados durante uma nova sessão. * E-mail e telefone: aplicados durante uma etapa da sessão que os coleta ou no payload de uma transação. * IP e dispositivo: aplicados durante a Análise de dispositivo e IP em uma sessão. * vendor\_data do usuário: aplicado durante a criação da sessão ou da transação. ## Como ocorre a inclusão na lista de bloqueio **1. Automática: em uma sessão recusada** Quando uma sessão é recusada e a configuração de inclusão automática na lista de bloqueio do seu fluxo de verificação (workflow) está ativada, a Didit adiciona automaticamente os identificadores relevantes (rosto, documento, e-mail, telefone) às listas de bloqueio do sistema correspondentes e altera o status do usuário para `BLOCKED`. **2. Automática: em uma correspondência com a lista de bloqueio** Quando uma sessão recebida corresponde a uma entrada existente na lista de bloqueio, a sessão é recusada automaticamente com um código de motivo como `blocked_face`, `blocked_document`, `blocked_email` etc. **3. Manual: pelo console** Um analista inclui um usuário na lista de bloqueio em *Users → \[user] → Actions → Add to blocklist*, escolhendo um ou mais identificadores a registrar. **4. Programática: pela API de listas** Use a [API de listas](https://docs.didit.me/pt-br/management-api/lists/overview.md) para adicionar entradas de forma programática. É a mesma API que o console usa internamente. ## Listas do sistema e listas personalizadas Toda aplicação tem **listas de bloqueio do sistema**, uma por tipo de identificador, gerenciadas automaticamente pela Didit. Não é possível renomeá-las nem excluí-las. Você pode criar, nomear e definir o escopo das listas personalizadas. | Lista | Criada por | Descrição | | - | - | - | | System Face Blocklist | Didit | Lista de bloqueio canônica de rostos da aplicação | | System Document Blocklist | Didit | Lista de bloqueio canônica de números de documento | | System Email Blocklist | Didit | Lista de bloqueio canônica de e-mails | | System Phone Blocklist | Didit | Lista de bloqueio canônica de telefones | | System User Blocklist | Didit | Identificadores `vendor_data` bloqueados | | Listas de bloqueio personalizadas | Você | Listas com escopo definido, por exemplo por região, por parceiro ou por nível de risco | ## Adicionar um usuário à lista de bloqueio pela API Use a [API de listas](https://docs.didit.me/pt-br/management-api/lists/overview.md) para adicionar uma entrada à lista de bloqueio. Para bloquear um usuário pelo `vendor_data`, adicione uma entrada do tipo USER à lista de bloqueio correspondente: 1. [Liste todas as listas](https://docs.didit.me/pt-br/management-api/lists/list.md) com os filtros `entry_type=user` e `is_system=true` para encontrar a lista de bloqueio de usuários do sistema. 2. [Crie uma entrada](https://docs.didit.me/pt-br/management-api/lists/create-entry.md) nessa lista com `value` definido como o `vendor_data` do usuário. Para bloquear um usuário por reconhecimento facial, consulte [Faces e biometria](https://docs.didit.me/pt-br/entities/users/faces-and-biometrics.md#enviar-um-rosto-para-a-lista-de-bloqueio). Para bloquear por e-mail, telefone, documento ou IP, use a lista de bloqueio do sistema correspondente com o identificador apropriado em `value`. ## Fluxo de aplicação ```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) ``` Para as listas de bloqueio de rostos e de documentos, a verificação ocorre na etapa de verificação: ```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) ``` ## Remover da lista de bloqueio * **Console**: *Blocklist → \[type] → row actions → Remove*. * **API**: use o endpoint [Excluir entrada](https://docs.didit.me/pt-br/management-api/lists/delete-entry.md) com o UUID da lista e o UUID da entrada. A remoção da entrada não altera automaticamente o status do usuário para `ACTIVE`. Use `PATCH /v3/users/{vendor_data}/update-status/` para alterar o status se quiser permitir novas sessões. ## Trilha de auditoria da lista de bloqueio Toda inclusão ou remoção em uma lista de bloqueio é registrada no [registro de auditoria](https://docs.didit.me/pt-br/console/audit-logs.md): * Quem adicionou a entrada (e-mail do usuário ou `'system'`, `'api'`). * Quando. * Um `comment` opcional explicando o motivo. * A sessão ou transação vinculada, se a entrada foi gerada automaticamente. ## Próximos passos > [card] [API de listas](https://docs.didit.me/pt-br/management-api/lists/overview.md) > > Referência completa da API de listas de bloqueio e de permissões. > [card] [Lista de bloqueio no console](https://docs.didit.me/pt-br/console/blocklist-users.md) > > Gerencie as listas de bloqueio pela interface. > [card] [Faces e biometria](https://docs.didit.me/pt-br/entities/users/faces-and-biometrics.md) > > Como funcionam as listas de bloqueio de rostos. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.