Skip to main content
O LivenessIdentySDK Web é distribuído exclusivamente via CDN. Você adiciona uma única tag <script> à sua página e o SDK carrega sozinho os demais arquivos do motor IDENTY Face AI (estilos, imagens, worker e .wasm).

Visão geral

Integração com uma tag

Carregue o SDK inteiro com uma única tag <script>

B2B by design

A x-api-key nunca toca o navegador — vive no seu backend

Segurança ligada por padrão

Liveness em VERY_HIGH e detecção de deepfake e câmera virtual ativas

Captura criptografada

A captura é enviada criptografada e analisada no servidor

Autorize suas origens

O SDK só funciona em páginas autorizadas. Antes de integrar, envie à equipe da Valid as origens de onde o SDK vai rodar — sem essa liberação, a captura não funciona na sua página.
  • Origem = protocolo + domínio + porta, sem caminho: https://app.suaempresa.com.br, http://localhost:3000.
  • Envie as origens de homologação e de produção separadamente; cada ambiente é liberado no seu.
  • Cada subdomínio é uma origem diferente (www. e sem www. contam como duas).
  • Mudou ou ganhou um domínio? Envie a nova origem antes de publicar.
A x-api-key usada pelo seu backend para criar as sessões é gerada por você na Plataforma ID — veja Chaves de API.

Requisitos

Instalação via CDN

Não há pacote npm — o SDK é carregado diretamente do CDN.
Produção — recomendado (sempre a mais recente)
Produção — versão fixa
Para descobrir a versão publicada no momento:
Inclua o script cedo na página, antes do clique do usuário. Assim que o script carrega, o SDK já começa a se preparar — a câmera abre mais rápido quando o usuário iniciar a verificação.

Verificando o carregamento

Depois do carregamento, o objeto LivenessIdentySDK está disponível globalmente:

Estrutura HTML mínima

Backend obrigatório

O SDK não embarca a x-api-key. Você precisa expor um endpoint no seu backend que chame POST /api/v1/sessions e devolva apenas sessionId e sessionToken à página.
Nunca exponha a x-api-key no navegador. Mesmo ofuscada, qualquer chave embarcada no bundle JS pode ser extraída por DevTools. Veja Serviço para o fluxo recomendado.
Exemplo mínimo (Node.js / Express):

Próximos passos

Implementação

Inicie uma verificação de liveness com run()

Customização

Idioma, segurança, captura e visual da tela

Solução de problemas

Mapeamento de erros, CSP e diagnóstico

Serviço

Criação da sessão no seu backend