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 backendSegurança ligada por padrão
Liveness em
VERY_HIGH e detecção de deepfake e câmera virtual ativasCaptura 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 semwww.contam como duas). - Mudou ou ganhou um domínio? Envie a nova origem antes de publicar.
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:
Verificando o carregamento
Depois do carregamento, o objetoLivenessIdentySDK está disponível globalmente:
Estrutura HTML mínima
Backend obrigatório
O SDK não embarca ax-api-key. Você precisa expor um endpoint no seu backend que chame POST /api/v1/sessions e devolva apenas sessionId e sessionToken à página.
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