> ## 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 > Veja como a Didit aplica bloqueios a entidades de utilizadores: tipos de identificadores, como é feita a verificação e como adicionar ou remover uma entrada. As listas de bloqueio impedem que utilizadores que não foram aprovados nas verificações de conformidade criem novas sessões ou executem novas transações. A Didit suporta listas de bloqueio por **tipo de identificador**, para que possa bloquear o mesmo agente mal-intencionado com base em vários pontos de dados (rosto, documento, e-mail, telefone, vendor\_data do utilizador). ## Tipos de identificadores suportados para utilizadores | Tipo | Chave | Corresponde quando… | | - | - | - | | Rosto | `FACE` | A selfie de prova de vida de uma nova sessão corresponde ao rosto da lista de bloqueio | | Número do documento | `DOCUMENT` | A nova submissão de documento de identificação corresponde ao número de documento bloqueado | | E-mail | `EMAIL` | Uma nova sessão ou transação utiliza o e-mail bloqueado | | Telefone | `PHONE` | Uma nova sessão ou transação utiliza o telefone bloqueado | | Endereço | `IP_ADDRESS` | O IP de quem submete corresponde; suporta 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 submete corresponde | | Utilizador | `USER` | A sessão ou transação utiliza o `vendor_data` bloqueado | Cada tipo de identificador é aplicado no ponto de contacto natural: * Face e documento: aplicados durante uma nova sessão. * E-mail e telefone: aplicados durante uma etapa da sessão que os recolhe, ou durante o payload de uma transação. * IP e dispositivo: aplicados durante a Análise de dispositivo e IP numa sessão. * vendor\_data do utilizador: aplicado durante a criação da sessão ou da transação. ## Como acontece o bloqueio > [!NOTE] > > Uma sessão recusada não bloqueia ninguém. A sessão termina com o estado `Declined`, o utilizador mantém-se `ACTIVE` e não é criada nenhuma entrada na lista, pelo que a mesma pessoa pode iniciar outra sessão. O bloqueio é um passo manual: adicione a entrada a partir da [página da lista de bloqueio](https://docs.didit.me/pt/console/blocklist-users.md) ou com a [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md). Uma entrada `USER` (o `vendor_data` do utilizador) também define o estado do utilizador como `BLOCKED`. **1. Automático: na 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. **2. Manual: a partir da Consola** Um analista bloqueia um utilizador a partir de *Users → \[user] → Actions → Add to blocklist*, escolhendo um ou mais identificadores a capturar. **3. Programático: através da Lists API** Use a [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md) para adicionar entradas programaticamente. É a mesma API que a Consola utiliza internamente. ## Listas do sistema e listas personalizadas Cada aplicação tem **listas de bloqueio do sistema**, uma por tipo de identificador, que a Didit gere automaticamente. Não pode mudar-lhes o nome nem eliminá-las. As listas personalizadas são suas para criar, dar nome e definir o âmbito. | Lista | Criada por | Descrição | | - | - | - | | Lista de bloqueio facial do sistema | Didit | Lista de bloqueio facial canónica da aplicação | | Lista de bloqueio de documentos do sistema | Didit | Lista canónica de números de documento bloqueados | | Lista de bloqueio de e-mails do sistema | Didit | Lista canónica de e-mails bloqueados | | Lista de bloqueio de telefones do sistema | Didit | Lista canónica de telefones bloqueados | | Lista de bloqueio de utilizadores do sistema | Didit | Identificadores `vendor_data` bloqueados | | Listas de bloqueio personalizadas | Você | Listas com âmbito definido, por exemplo, por região, por parceiro ou por nível de risco | ## Adicionar um utilizador à lista de bloqueio através da API Use a [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md) para adicionar uma entrada à lista de bloqueio. Para bloquear um utilizador pelo `vendor_data`, adicione uma entrada do tipo USER à lista de bloqueio correspondente: 1. [Liste todas as listas](https://docs.didit.me/pt/management-api/lists/list.md) filtradas por `entry_type=user` e `is_system=true` para encontrar a lista de bloqueio de utilizadores do sistema. 2. [Crie uma entrada](https://docs.didit.me/pt/management-api/lists/create-entry.md) nessa lista, com `value` definido como o `vendor_data` do utilizador. Para bloquear um utilizador por rosto, consulte [Faces e biometria](https://docs.didit.me/pt/entities/users/faces-and-biometrics.md#carregar-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 adequado 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) ``` Nas listas de bloqueio de rostos e documentos, a verificação acontece 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 * **Consola**: *Blocklist → \[type] → row actions → Remove*. * **API**: use o endpoint [Eliminar entrada](https://docs.didit.me/pt/management-api/lists/delete-entry.md) com o UUID da lista e o UUID da entrada. Remover a entrada não devolve automaticamente o utilizador ao estado `ACTIVE`. Use `PATCH /v3/users/{vendor_data}/update-status/` para alterar o estado se quiser permitir novas sessões. ## Registo de auditoria da lista de bloqueio Todas as adições e remoções numa lista de bloqueio são registadas no [registo de auditoria](https://docs.didit.me/pt/console/audit-logs.md): * Quem adicionou a entrada (e-mail do utilizador ou `'system'`, `'api'`). * Quando. * `comment` opcional, que explica o motivo. * Sessão ou transação associada, se a entrada tiver sido gerada automaticamente. ## Próximos passos > [card] [Lists API](https://docs.didit.me/pt/management-api/lists/overview.md) > > Referência completa da API de listas de bloqueio e de permissões. > [card] [Lista de bloqueio na Consola](https://docs.didit.me/pt/console/blocklist-users.md) > > Faça a gestão das listas de bloqueio a partir da interface. > [card] [Faces e biometria](https://docs.didit.me/pt/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.