Combate à Fraude Docs

Combate à Fraude Docs

    ›JavaScript

    Introdução

    • Início
    • Token de acesso
    • Checando as respostas assinadas
    • Checklist de integração

    Android

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • FaceAuthenticator
    • AddressCheck
    • DeviceAnalyser
    • Customização
    • Resultado de um SDK
    • Reduzindo o tamanho dos SDKs
    • Configuração dos sensores
    • Configuração de proxy
    • Configuração de preview
    • Formulário de segurança Google
    • Analytics
    • Notas de atualização

    iOS

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • FaceAuthenticator
    • AddressCheck
    • DeviceAnalyser
    • Customização
    • Configuração de proxy
    • Notas de atualização

    Flutter

    • Primeiros passos
    • Notas de atualização

    React Native

    • Primeiros passos

    Ionic

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • Notas de atualização

    Xamarin

    • Primeiros passos

    JavaScript

    • Primeiros passos
    • DocumentDetector
    • PassiveFaceLiveness
    • FaceAuthenticator
    • Erros do SDK
    • Customização
    • Eventos do SDK
    • Notas de atualização (DocumentDetector)
    • Notas de atualização (PassiveFaceLiveness)
    • Notas de atualização (FaceAuthenticator)

    API

    • Primeiros passos
    • Assinatura de respostas
    • Registro Facial
    • Autenticação Facial
    • Prova de vida passiva
    • Autenticação de dispositivos
    • Comprovante de endereço digital

    PassiveFaceLiveness

    Importando o SDK

    Para utilizar o DocumentDetector, você pode tanto importar remotamente o arquivo .js como baixá-lo localmente.

    Remotamente

    Inclua o arquivo .js diretamente do CDN:

    <script src="https://repo.combateafraude.com/javascript/release/passive-face-liveness/<VERSION>.umd.js" type="text/javascript"></script>
    

    Você pode recuperar a classe do SDK utilizando o seguinte código:

    const { PassiveFaceLivenessSdk } = window['@combateafraude/passive-face-liveness'];
    

    Localmente

    Baixe o arquivo .js e importe-o como um módulo ES6:

    import { PassiveFaceLivenessSdk } from '../assets/js/passive-face-liveness-<VERSION>.js'
    

    Construção

    No construtor, o SDK recebe um único parâmetro com as configurações:

    const sdk = new PassiveFaceLivenessSdk(options);
    

    Parâmetros suportados

    Os campos sem valor padrão são obrigatórios.

    CampoTipoValor padrãoDescrição
    tokenstringToken de autenticação para consumir o SDK
    environmentSettings.disableDesktopExecutionboolfalseFlag indicando se a execução em desktops deve ser bloqueada
    capturerSettings.disableAdvancedCapturingboolfalseFlag indicando se a captura avançada deve ser desabilitada*
    (DEPRECATED) appearenceSettings.hideCaptureTitleboolfalseFlag indicando se o texto no topo da tela de captura deve ser oculto
    (DEPRECATED) appearenceSettings.hideCaptureMaskboolfalseFlag indicando se a máscara deve ser oculta
    (DEPRECATED) appearenceSettings.hideCameraSwitchButtonboolfalseFlag indicando se o botão para alternar entre câmeras deve ser oculto

    * A captura avançada consiste no uso de APIs mais complexas e não tão estáveis em navegadores que oferecem suporte à mesma (e.g. ImageCapture)

    ** As opções de aparência foram depreciadas pois um sistema mais avançado de customização será lançado.

    Exemplo

    const sdk = new PassiveFaceLivenessSdk({
        token: `my-sdk-token`,
        environmentSettings: {
            disableDesktopExecution: false,
        },
        appearenceSettings: {
            hideCaptureTitle: false,
            hideCaptureMask: false,
            hideCameraSwitchButton: false,
        },
        capturerSettings: {
            disableAdvancedCapturing: false,
        }
    });
    

    Inicialização

    initialize(): Promise<void>

    O SDK conta com um método isolado de inicialização, para permitir um maior controle de quando ela ocorre.

    Durante essa inicialização, o SDK irá inicializar suas variáveis internas e fazer download dos recursos necessários para sua execução.

    [!] Você deve chamar este método antes de utilizar outros métodos do SDK.

    [!] A inicialização do SDK pode levar alguns segundos. Recomendamos que você chame essa função o mais cedo possível no seu fluxo, para que a abertura do SDK seja suave para o usuário.

    Exemplo

    await sdk.initialize();
    

    Utilização

    Abertura

    open(container: HTMLElement): Promise<void>

    Método utilizado para carregar o SDK na tela.

    Irá inicializar a stream de vídeo (solicitando permissões se necessário) e carregá-la no container.

    Parâmetros

    ParâmetroTipoValores válidosDescrição
    containerHTMLElement-Elemento no DOM em que o SDK será carregado (e.g. div)

    Exemplo

    // div or another element on DOM
    const sdkContainer = document.getElementById('sdk-displayer');
    await sdk.open(sdkContainer);
    

    Captura de selfie

    captureSelfie(personData?: LivenessPersonData, captureSettings?: CaptureSettings): Promise<Result>

    Método utilizado para fazer a captura de uma selfie

    Parâmetros

    ParâmetroTipoValores válidosDescrição
    personData.cpfstringCPF do usuário fazendo a autenticação (opcional)
    personData.namestringNome do usuário fazendo a autenticação (opcional)
    captureSettings.mode¹stringautomatic, manualConfigura a captura como automática ou manual
    captureSettings.automaticCaptureTimeoutInSeconds²numberNúmeros.Timeout antes da captura automática alternar para manual (se não encontrar documento). Use 0 para nunca alternar.

    ¹ Se não especificado, a captura automática é utilizada

    ² Se não especificado, usa-se um valor padrão de 30 segundos

    Retorno

    O retorno consiste em um objeto com o seguintes campos:

    CampoTipoDescrição
    imageUrlstringLink temporário para a imagem, gerado pela nossa API
    blobBlobBlob da imagem capturada

    Exemplo

    const personData = { cpf: 'user-cpf', name: 'user-name' };
    const captureSettings = { mode: 'automatic', automaticCaptureTimeoutInSeconds: 10 };
    const result = await sdk.captureSelfie(personData, captureSettings);
    // { imageUrl: '[link da imagem]', blob: Blob }
    

    Fechar SDK

    close(): Promise<void>

    Método utilizado para remover o SDK na tela.

    Irá remover os elementos visuais do SDK do DOM.

    De-inicializar o SDK

    dispose(): Promise<void>

    Método utilizado para remover o SDK na tela.

    Irá de-inicializar a stream de vídeo e limpar as variáveis internas do SDK

    Exemplo completo

    Em breve.

    ← DocumentDetectorFaceAuthenticator →
    • Remotamente
    • Localmente
    • Parâmetros suportados
      • Exemplo
      • initialize(): Promise<void>
      • Exemplo
    • Abertura
      • open(container: HTMLElement): Promise<void>
      • Parâmetros
      • Exemplo
    • Captura de selfie
      • captureSelfie(personData?: LivenessPersonData, captureSettings?: CaptureSettings): Promise<Result>
      • Parâmetros
      • Retorno
      • Exemplo
    • Fechar SDK
      • close(): Promise<void>
    • De-inicializar o SDK
      • dispose(): Promise<void>
    Combate à Fraude Docs
    2021 © Combate à Fraude - Todos os direitos reservados.
    COMBATEAFRAUDE TECNOLOGIA DA INFORMACAO LTDA CNPJ: 34.102.645/0001-57
    R. Tiradentes, 1077 - 5º andar - Centro, Venâncio Aires - RS, CEP 95800-000