> ## Documentation Index > Fetch the complete documentation index at: https://docs.vu-one.com/llms.txt > Use this file to discover all available pages before exploring further. # Prova de Vida e Biometria Facial no Identity Link > Entenda como funciona a prova de vida anti-spoofing no fluxo FULL FLOW do Identity Link e como interpretar os resultados biométricos. A prova de vida (liveness) é um controle de segurança que verifica se a pessoa diante da câmera é real e está presente no momento da verificação. No VU Identity Link, a prova de vida é executada automaticamente dentro do fluxo `FULL FLOW`, comparando o rosto capturado ao vivo com a foto do documento apresentado. ## Quando a prova de vida é executada A biometria facial só é incluída no tipo de fluxo `FULL FLOW`. Se você criar um link do tipo `ID ONLY`, o usuário apenas capturará a frente e o verso do documento, sem prova de vida. | Tipo de fluxo | Captura documental | Prova de vida | | - | - | - | | `FULL FLOW` | Sim | Sim | | `ID ONLY` | Sim | Não | ### Ramificação adaptativa: apenas selfie Desde a versão 2.2.0, um link `FULL FLOW` com [fluxo adaptativo](/pt/identity-link/links#fluxo-adaptativo) pode se resolver em uma de duas ramificações para um cliente que já se verificou antes: | Ramificação (`method`) | O que o usuário faz | | - | - | | `DOCUMENT` | Fluxo completo: documento + prova de vida | | `FACE` | Apenas a prova de vida, sem repetir a captura documental | A ramificação é resolvida no servidor e persistida uma única vez. Você a lê em `GET /verifications/{id}/status?include=operationGuid`, no campo `method`. A prova de vida é executada nas **duas** ramificações: o que a ramificação `FACE` omite é a captura do documento, nunca o controle biométrico. ## Anti-spoofing no Identity Link O sistema aplica controles anti-spoofing em duas camadas: 1. **Anti-spoofing facial**: detecta tentativas de fraude com fotos, vídeos, máscaras ou telas. 2. **Anti-spoofing documental**: verifica que o documento capturado não é uma foto de tela nem uma cópia impressa. A ativação desses controles depende da configuração da sua empresa. Consulte o estado dos serviços pelo endpoint de saúde. ## Estado dos serviços de anti-spoofing ```bash theme={null} curl -X GET https://api.identity.vu-one.com/api/v1/health/status ``` ### Resposta de exemplo ```json theme={null} { "auth": { "status": "UP" }, "biometrics": { "status": "UP", "components": { "antiSpoofingDocServiceIndicator": { "status": "UP", "details": { "antiSpoofing-doc": "Available" } }, "antiSpoofingFaceServiceIndicator": { "status": "UP", "details": { "antiSpoofing-face": "Available" } }, "ping": { "status": "UP" }, "refreshScope": { "status": "UP" }, "sopServiceIndicator": { "status": "UP", "details": { "antiSpoofing-face": "Available" } } } } } ``` | Nó | O que informa | | - | - | | `auth.status` | Disponibilidade do serviço de autenticação (`UP` ou `DOWN`) | | `biometrics.status` | Disponibilidade agregada do serviço de biometria | | `biometrics.components.antiSpoofingDocServiceIndicator` | Anti-spoofing documental. Seu `details` indica `Available` ou `Not Available` | | `biometrics.components.antiSpoofingFaceServiceIndicator` | Anti-spoofing facial | | `biometrics.components.sopServiceIndicator` | Serviço SOP | | `biometrics.components.ping` | Conectividade básica com o motor biométrico | | `biometrics.components.refreshScope` | Estado da atualização de configuração | O endpoint devolve **200** quando o serviço está operacional e **503** quando não está, com o mesmo schema nos dois casos. Se algum indicador mostrar `DOWN`, as verificações que dependem desse serviço falharão até que ele seja restaurado. ## Interpretação dos resultados Durante o fluxo `FULL FLOW`, você recebe eventos de webhook específicos da etapa de registro facial: | Evento | Significado | | - | - | | `verification.register.successful` | A prova de vida foi concluída corretamente; o rosto ao vivo corresponde ao documento | | `verification.register.failed` | A prova de vida falhou; possível tentativa de spoofing ou rosto que não corresponde | O evento final `verification.successful` só é disparado se tanto a captura documental quanto a prova de vida passarem por todos os controles. A verificação **não** expõe pontuações biométricas nem indicadores separados de prova de vida. O resultado consolidado vive em `status` (`success` ou `failed`); quando falha, `errorMessage` descreve a causa. Consulte também os eventos de webhook granulares para saber em qual etapa ocorreu a falha. ## Acesso aos frames da selfie Você pode recuperar as imagens capturadas durante a prova de vida pelos endpoints de imagens: ```bash theme={null} # Listar todas as imagens de uma verificação curl -X GET https://api.identity.vu-one.com/api/v1/verifications/6ba7b810-9dad-11d1-80b4-00c04fd430c8/images \ -H "Authorization: Bearer " # Obter uma imagem específica pelo seu ID curl -X GET https://api.identity.vu-one.com/api/v1/verifications/images/3b4c5d6e-7f80-91a2-b3c4-d5e6f7081920 \ -H "Authorization: Bearer " ``` Os identificadores estão no objeto `images` da verificação: `addFront` e `addBack` são as faces do documento, e o array `register` contém os frames da selfie tirados durante a prova de vida, úteis para auditoria manual ou revisão de casos limítrofes. ## Configuração de anti-spoofing no nível da empresa O indicador `antiSpoofing` da sua empresa controla se os controles anti-spoofing estão ativos. É um ajuste administrado pela VU e somente leitura para a API: fica exposto dentro do bloco `company` de `GET /links/{id}`. ```bash theme={null} curl -X GET https://api.identity.vu-one.com/api/v1/links/550e8400-e29b-41d4-a716-446655440000 \ -H "Authorization: Bearer " ``` `PATCH /users/me/company` não aceita `antiSpoofing`. Os ajustes de empresa que você pode modificar são `name`, `color`, `logo`, `linkConfig` e `verificationConfig`. Para alterar a política anti-spoofing, contate seu responsável de conta na VU. O VU Identity Link utiliza tecnologia de prova de vida certificada iBeta Level 2, atendendo aos padrões mais exigentes do setor para prevenir ataques de apresentação (PAD). Se você precisa apenas da extração de dados documentais, sem verificação facial, crie sempre links do tipo `ID ONLY`. Isso reduz o atrito para o usuário final nos casos em que a biometria não é necessária. ## Related topics - [Criar e Gerenciar Links de Verificação](/pt/identity-link/links.md) - [Identity Link API: Guia de Integração Completo](/pt/identity-link/introducao.md) - [Webhooks do Identity Link: Eventos do Ciclo de Verificação](/pt/identity-link/webhooks.md) - [Documentação técnica da VU](/pt/index.md) - [Ler Resultados KYC de Verificações de Identidade](/pt/identity-link/kyc.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.