Skip to main content

​
Visão Geral

O Valid Liveness SDK é uma biblioteca JavaScript que permite a integração de verificação de vivacidade facial em aplicações web. O SDK oferece uma interface unificada e simplificada para captura biométrica, com suporte a personalização completa da interface e mensagens.

​
Principais Recursos

API Simplificada

Execute todo o fluxo de verificação com uma única chamada

Personalização Completa

Customize cores, textos e idiomas da interface

Segurança Avançada

Criptografia de dados e detecção de injeção de câmera

Multi-idioma

Português (pt-BR) e Inglês (en-US) nativos

​
Credenciais Necessárias

Você precisará das seguintes credenciais fornecidas pela Valid:
CredencialDescrição
API KeyChave de autenticação para acesso à API
CEKClient Encryption Key - string Base64
Backend URLEndpoint do servidor de processamento

​
Instalação via CDN

Adicione o script do SDK no seu HTML: 
<script src="https://storage.googleapis.com/hub-sdk-cdn/latest/prod/valid-hub-sdk.js"></script>
O SDK está disponível via CDN do Google Cloud Storage. Você pode usar a versão latest para sempre obter a mais recente, ou especificar uma versão específica.

​
Verificando o Carregamento

Após o carregamento do script, o objeto ValidHub estará disponível globalmente: 
if (typeof ValidHub !== 'undefined') {
  console.log('Valid Liveness SDK carregado com sucesso!');
} else {
  console.error('Falha ao carregar o SDK');
}

​
Estrutura HTML Mínima

<!DOCTYPE html>
<html lang="pt-BR">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Verificação de Identidade</title>
    <script src="https://storage.googleapis.com/hub-sdk-cdn/latest/prod/valid-hub-sdk.js"></script>
  </head>
  <body>
    <!-- Container onde o SDK irá renderizar a interface de captura -->
    <div id="camera-container"></div>

    <button id="iniciar-verificacao">Iniciar Verificação</button>

    <script src="seu-app.js"></script>
  </body>
</html>

​
Configuração do CEK

O CEK (Client Encryption Key) é uma string Base64 contendo as chaves de criptografia necessárias para a comunicação segura com o backend.

​
Usando o CEK

// O CEK é fornecido como uma string Base64
const cek = 'eyJrZXlJZCI6ImNlay0xMjM0NTYiLCJlbmNyeXB0aW9uS2V5Ijoi...base64...';

const config = {
  apiKey: 'sua-api-key',
  cek: cek, // Passar a string Base64 diretamente
  mount: '#camera-container',
  backendBaseUrl: 'https://api.valid.com/liveness',
};
Segurança: Proteja o CEK. Mantenha-o em um endpoint com autenticação e considere carregá-lo dinamicamente quando necessário.

​
Próximos Passos

Implementação

Veja como implementar a verificação de liveness

Customização

Personalize idiomas, textos e cores