For the complete documentation index, see llms.txt. This page is also available as Markdown.

Notas de versão

11 de março de 2026

  • 1.1.3

    • Novo: Maior taxa de sucesso nas verificações: ajustes de tempo no carregamento do SDK e aumento do timeout de operações (até 20s) reduzem falhas em conexões lentas ou instáveis.

    • Novo: Estratégia de retentativa automática para falhas temporárias (quando o erro permite nova tentativa), aumentando a resiliência do fluxo em cenários de instabilidade de rede.

    • Novo: Adição de logs para aprimorar a observabilidade e o suporte à análise de desempenho.

    • Correção: Ajuste no descarte (dispose) do CafFaceLiveness SDK ao finalizar a autenticação, evitando falhas por reutilização de estado/token inválido em verificações subsequentes.

18 de fevereiro de 2026

  • 1.1.2

    • Correção: Resolução de um problema onde a tela de captura facial (fornecedor iProov) não era exibida corretamente em tela cheia em dispositivos móveis iOS.

    • Correção: Remoção do botão de fechar duplicado exibido durante a captura facial.

03 de fevereiro de 2026

  • 1.1.1

    • Novo: Recurso de Coleta de localização com GPS para analisar casos de divergência de fuso horário (fuso horário obtido via IP vs configurado no dispositivo). Atua como meio de confirmação da localização do usuário, disponível quando o método de localização da política é "Priorizar IP [...]" e a regra de divergência de fuso horário estiver configurada para "Desafiar o usuário a reautenticar [...]".

      Objetivo: Ajuda a reduzir a fricção na jornada uma vez que aumenta a segurança de se obter localizações inicialmente via IP, pedindo GPS do usuário apenas se necessário. Novas configurações opcionais disponíveis:

      • gpsAuthenticationSettings: objeto opcional com maxAttempts (número máximo de tentativas de coleta de GPS; padrão: 3).

      • successPageDisplayDuration: tempo em milissegundos em que a página de resultado (sucesso ou erro) permanece visível antes de fechar automaticamente (padrão: 3000).

    • Correção: Maior compatibilidade com bloqueadores e privacidade

      O fluxo de autenticação passa a utilizar infraestrutura própria (proxy) para as chamadas necessárias à validação do dispositivo. Com isso, reduzimos falhas causadas por:

      • Bloqueadores de anúncios e de conteúdo.

      • Navegadores com proteções de privacidade ativas (ex.: Brave Shields).

      • Serviços de DNS com função de bloqueio de rastreamento (ex.: AdGuard, NextDNS).

      Objetivo: Posibilita que mais usuários concluam a verificação com sucesso, mesmo nesses ambientes.

    • Novo: Observabilidade e suporte Foram aprimorados os registros de eventos (logs) do SDK para enriquecer a depuração de problemas.

15 de dezembro de 2025

  • 1.0.1

    • Novo: Atualização interna do SDK CafFaceLiveness para a versão 0.14.2, trazendo:

      • Correção de problemas de permissão de sensores em iframes no iOS 26 ao utilizar o fornecedor iProov.

      • Otimização de performance na inicialização e melhorias na estabilidade.

      • Melhorias no sistema de captura de imagem com mecanismo de fallback inteligente e rápidos feedbacks de validação de qualidade da imagem.

      • Melhorias e correções de compatibilidade em diferentes dispositivos e navegadores.

      • Correção de um problema com a câmera ao utilizar o SDK dentro de uma WebView.

      • Adição de novas métricas de abandono de sessão e refinamento na coleta de logs.

      • Atualização de dependências internas para maior segurança e estabilidade.

4 de setembro de 2025

  • 1.0.0

    • Novo: Integração com o CafFaceLiveness SDK: O SDK do Smart Auth agora utiliza um novo SDK para autenticação facial, permitindo a seleção dinâmica do provedor de liveness. Agora é possível utilizar os fornecedores Caf, iProov, FaceTec e Payface. Para alterar o provedor de liveness de acordo com a necessidade do seu fluxo, basta configurar o mobileToken e entrar em contato com nosso suporte.

    • Novo: Flexibilidade para criação do personId: Agora é possível informar um personId não numérico como identificador no lugar do cpf.

      • Caracteres permitidos: letras, números e os caracteres especiais @ . _ - (sem espaços).

      • Comprimento: entre 5 e 254 caracteres.

      • Se o personId contiver apenas números e os caracteres . - /, esses caracteres serão removidos pois o valor original será interpretado como uma máscara de documento.

27 de junho de 2025

  • 0.0.40 (BETA)

    • Novo: Recurso de geolocalização por IP como alternativa à coleta de dados de GPS, a depender do método de localização configurado na política de autenticação.

3 de abril de 2025

  • 0.0.39 (BETA)

    • Novo: Melhoria para aumentar conversão de autenticação facial, acionando retentativa caso um rosto não seja encontrado durante a captura.

    • Novo: Alteração nas metrificações de volume da autenticação facial.

    • Novo: Adição de tempo de espera em caso de recebimento de erro causado por excesso de requisições.

10 de março de 2025

  • 0.0.38 (BETA)

    • Novo: Melhora na identificação de modelo e sistema operacional do dispositivo em navegadores com base no Chromium.

27 de fevereiro de 2025

  • 0.0.37 (BETA)

    • Novo: Um UnknownError que acontecia durante o processo de captura de localização do usuário ([...] o aplicativo não possui permissões suficientes de geolocalização) agora foi categorizado como PositionUnavailableError. Isso geralmente ocorre quando o navegador - ou aplicativo que está fazendo o papel de webview - não tem permissão do sistema operacional para usar serviços de localização.

    • Novo: Mais logs para quando o SDK é inicializado e finalizado. A ingestão de logs também foi enriquecida com objetos de erro e dados de versão do navegador.

24 de fevereiro de 2025

  • 0.0.36 (BETA)

    • Novo: Alteração da mensagem do evento sdkStatus.

21 de fevereiro de 2025

  • 0.0.35 (BETA)

    • Novo: Adição de retentativa na coleta de geolocalização.

    • Novo: Adição de parâmetro que indica a plataforma (OS) do SDK nos logs.

    • Novo: Upgrade da versão do FingerprintJs para melhora na acurácia de dados de dispositivo.

    • Novo: Criação do evento sdkStatus para que seja possível verificar se o sdk está aberto.

    • Novo: Aumento do tempo de espera para coleta de geolocalização.

5 de fevereiro de 2025

  • 0.0.34 (BETA)

    • Novo: Aumento do tempo de espera para coleta de geolocalização.

28 de janeiro de 2025

  • 0.0.33 (BETA)

    • Novo: Adição de retentativas de captura facial.

    • Novo: Adição de novos parametros de personalização para o modal de autenticação do sdk: titulo, subtitulo, descrição, botão da página de validação de código, cor de fundo, cor de texto e posição do timer.

    • Novo: Aprimoramentos na ingestão de logs.

15 de janeiro de 2025

  • 0.0.32 (BETA)

    • Novo: Melhoria na detecção de erros e ações de usuário durante a captura facial.

    • Novo: Correção para cenário onde um erro "UNKNOWN" às vezes interrompia o sdk durante a captura facial.

15 de janeiro de 2025

  • 0.0.31 (BETA)

    • Novo: Melhoria em observabilidade com a ingestão de logs ao Axiom.

    • Novo: Melhoria na experiência do modal de sucesso.

04 de dezembro de 2024

  • 0.0.30 (BETA)

    • Novo: Adição da detecção de softwares para acesso remoto.

    • Novo: Atualização de versão em sdk do fornececedor de Smart Signals.

04 de setembro de 2024

  • 0.0.29 (BETA)

    • Novo: Atualização do retorno do sdk para incluir o attemptId.

07 de agosto de 2024

  • 0.0.28 (BETA)

    • Novo: Atualização das dependências do projeto.

    • Novo: Melhoria na captura de informação de dispositivos.

09 de julho de 2024

  • 0.0.27 (BETA)

    • Novo: Atualização da versão do SDK de Autenticação facial.

24 de outubro de 2023

  • 0.0.26 (BETA)

    • Novo: Autenticação facial com iProov.

    • Novo: Personalização de botões.

04 de julho de 2023

  • 0.0.25 (BETA)

    • Novo: Atualizada dependências de prova de vida.

    • Novo: Retorno para contexto pendente de análise.

    • Correção: Ajustes em retornos de erros no fluxo do SDK.

    • Correção: Erro com bloqueadores de anúncios.

18 de abril de 2023

  • 0.0.24 (BETA)

    • Novo: Alteração das options para receber metadados adicionais.

    • Correção: Bugs e melhorias no SDK.

03 de março de 2023

  • 0.0.23 (BETA)

    • Novo: Suporte a traduções

    • Novo: Parâmetros para tela pending

    • Novo: Cálculo de fingerPrint

    • Correção: Bugs e melhorias no SDK.

    • Mudança: Ajustes com a API, melhorias de layout.

22 de dezembro de 2022

  • 0.0.22 (BETA)

    • Correção: Bugs e melhorias no SDK.

    • Mudança: Ajustes com a API, melhorias de layout e novas funcionalidades inseridas.

07 de dezembro de 2022

  • 0.0.19 (BETA)

    • Novo: Reautenticação facial!

    • Novo: Status suspeito

    • Correção: Melhorias de processos interno

03 de outubro de 2022

  • 0.0.9 (BETA)

    • Correção: Bugs durante a execução do SDK.

    • Mudança: Ajustes na comunicação com a API.

28 de setembro de 2022

  • 0.0.8 (BETA)

    • Novo: Reautenticação por SMS!

01 de fevereiro de 2021

  • 0.0.2 (BETA)

    • Novo: Olá, mundo! Publicação da primeira versão!

Atualizado