Cadastro com verificação de identidade no mesmo fluxo
Conta numa ferramenta e verificação em outra deixam uma janela de conta ativa sem pessoa verificada. A ordem da NIST SP 800-63A-4 e o que muda num fluxo só.
6 min de leitura
Produto e integração
Práticas de integração de uma API de verificação: webhooks, sandbox, OTP e o que olhar antes de ir para produção.
- artigos
- 77
- fontes citadas
- 291
Como guardar senha de usuário: hash lento, sal e pimenta
O que a OWASP e a NIST SP 800-63B-4 pedem para guardar senha: função de hash lenta, sal único, custo calibrado, pimenta fora do banco e um caminho para trocar o algoritmo depois.
6 min de leitura
JWT de acesso: o que validar antes de confiar
A lista do RFC 9068 para validar um token de acesso JWT, os ataques que cada checagem fecha pelo RFC 8725 e os erros que fazem um token de outro sistema passar no seu.
6 min de leitura
Refresh token: rotação e detecção de reuso
Como a rotação de refresh token do RFC 9700 transforma um token roubado em alarme, o que fazer quando o mesmo token volta duas vezes e quando o retry de rede não é ataque.
7 min de leitura
SMS e e-mail como segundo fator: o que a norma aceita
A NIST SP 800-63B-4 trata o SMS como autenticador restrito e não aceita o e-mail como fator fora de banda. O que isso muda no login, os requisitos do código e quando usar cada canal.
6 min de leitura
Câmera no navegador: o que o getUserMedia entrega à captura
O getUserMedia abre a câmera numa página web, mas só em contexto seguro, com permissão e com restrições que o navegador trata como preferência. Os erros que o padrão define e o que a captura de documento faz além dele.
6 min de leitura
Chave secreta de API no navegador: por que nunca no front-end
Tudo o que chega ao navegador pode ser lido por quem usa a página. Por que a chave secreta de uma API de verificação fica só no servidor, o que vai no lugar dela e o que fazer quando ela vaza.
5 min de leitura
Link de verificação por mensagem: o que o torna seguro
O link de verificação enviado por e-mail ou WhatsApp carrega um segredo. Onde ele vaza (log, Referer, histórico, prévia do aplicativo), o que a RFC 3986 diz do fragmento e o que a OWASP pede do token.
6 min de leitura
Contratos em lote | O hash preso no link e o aviso de cada etapa
Mandar cem contratos para assinatura não pode custar a prova de cada um. Por que o hash do documento entra no link na emissão, o que cada aviso diz e o que conferir quando o lote fecha.
6 min de leitura
Lote por planilha sem FTP nem e-mail | O arquivo que entra validado e a fórmula que volta na planilha
Mandar milhares de documentos para consulta não pede servidor de arquivos nem anexo. O que validar antes de cobrar e por que o CSV de resultado pode virar fórmula na planilha de quem abre.
8 min de leitura
O saldo que se prova | Conciliar por evento e por período até fechar com o extrato
Saldo de API pré-paga que não se reconstrói pelos lançamentos é opinião. Como casar o custo de cada evento com o extrato do período, pela mesma chave, sem duplicar na reimportação.
7 min de leitura
Playground sem conta | O que um sandbox público pode mostrar e por que ele precisa de teto
Rodar a API antes de criar conta encurta a avaliação, mas um endpoint aberto ao mundo é alvo. O que um sandbox público entrega, o que ele não pode fazer e como o teto deve responder.
7 min de leitura
Dígito verificador de CPF e CNPJ, o que a conta prova e o que ela não prova
Como os dígitos verificadores de CPF e de CNPJ são calculados, inclusive no CNPJ com letras, o que uma conta que fecha garante e onde ela para de ajudar.
7 min de leitura
Teto por chave de API | O limite que conta o gasto que chega depois
Teto de gasto que só olha a chamada deixa passar o débito que sai na decisão assíncrona. Por que limitar dinheiro e volume, por chave, e como a integração reage ao 429.
5 min de leitura
Webhook de atualização | Como testar o desfecho que muda depois
Uma verificação que termina em revisão e é decidida depois gera dois eventos. Como deduplicar pelo id, decidir pelo estado e provar a integração no sandbox sem esperar um caso real.
6 min de leitura
Janela prevista das fontes oficiais: avisar o cliente sem entregar o mapa
O que publicar quando uma fonte oficial anuncia manutenção programada, o que nunca publicar sobre como o seu sistema reage, e por que a janela tem de sair do ar sozinha.
6 min de leitura
Simular a política no próprio histórico, sem cobrar, sem consultar ninguém e sem abrir uma foto
Como testar uma mudança na regra de decisão da verificação sobre o que já foi decidido, o que dá para simular com honestidade e o que o placar não pode esconder.
6 min de leitura
Carga de webhook cifrada ponta a ponta: o que a assinatura não resolve
Assinar o webhook prova quem mandou e que ninguém mexeu. Não esconde o conteúdo de quem está no caminho. Como a cifra da carga com chave do cliente fecha essa última brecha.
6 min de leitura
Coleção de API importável: testar a integração no cliente HTTP sem expor a chave
O que uma coleção importável de API deve trazer, como ela deixa a chave fora do arquivo, por que gerá-la da especificação e um roteiro para a primeira chamada no sandbox.
6 min de leitura
Documentação de API para assistente de IA: llms.txt, Markdown e pacote por produto
Como preparar a documentação de uma API para o assistente de IA de quem integra: o llms.txt, a versão em Markdown de cada página, o anúncio por cabeçalho e o pacote por produto.
7 min de leitura
Funil de conversão por etapa: o número que o painel deve calcular por você
Um funil de verificação só serve se bater com a contagem bruta de sessões. Como a UNIFOKAL agrega a escada no servidor, o que cada etapa significa e o que fazer com o tempo de quem parou.
7 min de leitura
Onde a verificação aparece na página, e por que isso decide o funil
Embutido, botão flutuante ou aberto pelo seu botão: o lugar em que a verificação aparece muda quem chega até ela, e um degrau de funil separa quem desistiu de quem nunca viu a tela.
7 min de leitura
Origem da jornada no webhook: ligar a campanha ao desfecho da verificação
Como levar a origem de cada pessoa da campanha até o desfecho da verificação, para medir aprovação por canal sem tabela paralela e sem dado pessoal no rótulo.
7 min de leitura
Página de segurança do fornecedor: o que conferir antes de assinar
Arquivo de contato de segurança, cabeçalhos entregues, encarregado único e política baseada em arcabouço: o que conferir na página de segurança de um fornecedor, e como conferir.
8 min de leitura
Registro de requisições sem o corpo: o histórico de API que não vira banco de dado pessoal
Guardar a carga de cada chamada para o cliente inspecionar cria um segundo banco de CPFs. Como desenhar um registro de requisições só com metadado, e por que a ausência da coluna é a garantia.
7 min de leitura
Teto de gasto diário em uma API de verificação: avisar antes de cortar
Um orçamento por dia protege a conta de um flow mal configurado e de uma chave vazada. Como funciona o teto por organização e por chave, o aviso em 80% e o 429 com Retry-After.
7 min de leitura
Assinatura de mensagem HTTP: o que a RFC 9421 padroniza no webhook
Cada fornecedor inventa seu HMAC de webhook. A RFC 9421 padroniza o que é assinado, como se monta a base e o que o consumidor deve validar, na ordem certa.
8 min de leitura
Contrato de fornecedor de identidade: as cláusulas que doem
Guia de comprador para as cláusulas de um contrato de verificação de identidade que só aparecem tarde: responsabilidade solidária, cadeia de terceiros, fim de contrato com prova e SLA com consequência.
8 min de leitura
Limite de taxa em API: o que devolver e como reagir
Os dois lados do rate limit: que RFC define o 429, o que precisa vir no cabeçalho para o cliente saber quando voltar, e como fazer retry com recuo exponencial e aleatorização.
8 min de leitura
Prova de conceito de KYC: como desenhar uma POC que decide alguma coisa
Como montar uma POC de verificação de identidade com conjunto adverso definido antes, par de erros no critério de aceite e dado de teste com base legal.
8 min de leitura
Calcular o ROI de um controle antifraude sem enganar a si mesmo
O retorno de um controle antifraude tem três linhas: o custo do controle, a perda evitada e o custo do cliente bom barrado. A do meio é contrafactual, e este texto mostra como estimá-la.
8 min de leitura
Ler um SLA de 99,9%: janela, medição e o que o crédito não devolve
99,9% num mês de 30 dias são 43,2 minutos fora do ar; num ano de 365 dias, 8 horas e 45 minutos. O número só significa alguma coisa depois de quatro perguntas ao contrato.
8 min de leitura
Medir a acurácia de um OCR de documento: CER, acerto por campo e o que engana
Taxa de erro por caractere e acerto por campo medem coisas diferentes. Como cada uma é construída, por que um OCR com CER baixa erra justamente o número do documento e o que o dígito verificador resolve.
8 min de leitura
mTLS e assinatura de requisição: provando quem chama a API
Como o servidor prova quem está chamando: TLS mútuo pela RFC 8705, token preso ao certificado, assinatura de mensagem pela RFC 9421 e o buraco que o proxy que termina o TLS abre no meio.
7 min de leitura
O funil da verificação: medir onde o usuário desiste, etapa por etapa
Taxa por etapa, taxa acumulada, denominador certo e janela de abandono. Como instrumentar o funil de verificação de identidade para descobrir onde o usuário some, sem mentir na média.
8 min de leitura
Open Finance: o consentimento não substitui a verificação de identidade
As três etapas do compartilhamento, quem identifica e quem autentica, o que a norma mantém fora do escopo e o prazo de consentimento que deixou de valer em 2023.
8 min de leitura
Passkey e WebAuthn no cadastro: por que a chave não substitui o KYC
Uma asserção WebAuthn prova posse de uma chave ligada a uma conta, não identidade civil. O que a especificação do W3C e o NIST SP 800-63B dizem sobre o lugar da passkey no onboarding.
8 min de leitura
Preço por verificação: os modelos de cobrança de KYC e as pegadinhas da conta
O que conta como uma unidade cobrada, quais modelos de cobrança existem, a aritmética do custo por resultado útil e as obrigações de norma que trazem o volume de volta todo ano.
8 min de leitura
Taxa de aprovação de KYC: por que o número de dois fornecedores não se compara
A taxa de aprovação depende da população, do limiar e do que entra no denominador. O que o NIST mediu sobre isso e como montar uma comparação entre fornecedores que realmente vale.
8 min de leitura
TOTP no app autenticador: janela de tempo, desvio de relógio e segredo compartilhado
O que as RFCs 6238 e 4226 definem sobre passo de tempo, tolerância de relógio e limite de tentativas, e por que o TOTP tira o segundo fator da operadora sem resistir a phishing.
8 min de leitura
Validar assinatura digital ICP-Brasil: o carimbo visual não é a assinatura
O que o DOC-ICP-15.01 exige que o verificador tenha em mãos, por que a tarja azul no PDF não acrescenta segurança e o que o validador oficial do ITI responde e não responde.
7 min de leitura
O idioma do fluxo de verificação: o passo que a tradução esquece
Instrução que o usuário não entende vira erro de captura, chamado de suporte e abandono. O que o WCAG pede de idioma e por que a sessão congela a escolha.
6 min de leitura
Resolução CMN 4.893 e Resolução BCB 85: o dever de quem contrata verificação
O que as normas de segurança cibernética do sistema financeiro exigem ao contratar serviço relevante de dados e como isso aterrissa na due diligence de KYC.
7 min de leitura
Atendimento humano na verificação de identidade: a saída para quem trava
Como desenhar o botão que leva ao atendimento quem não consegue concluir a verificação, sem transformar esse canal em porta de exceção para o fraudador.
8 min de leitura
Chave própria no fornecedor (BYO-key): quando plugar a sua credencial compensa
Os três arranjos para consultar uma fonte externa paga: o fornecedor revende, você pluga a sua chave (BYO-key) ou integra direto. Comparação por preço, contrato, quota, LGPD e sublicenciamento.
8 min de leitura
Controle de acesso ao painel de KYC: convites, papéis e trilha de auditoria
Quem da sua equipe vê documento e selfie de cliente, com que papel e com que registro: o desenho de acesso nominal que passa em auditoria e as perguntas certas para o fornecedor.
6 min de leitura
CSP e Trusted Types na página de verificação: fechando o caminho do XSS
Um script injetado na tela que abre a câmera rouba imagem de documento, não senha. Como nonce, frame-ancestors, connect-src e Trusted Types fecham o caminho, e o que quebra no processo.
8 min de leitura
Exportação assíncrona: por que o arquivo grande não sai na hora
Pedir todos os dados e receber o download na hora só funciona com base pequena. O padrão 202, o timeout do proxy, memória em fluxo e o link expirável.
7 min de leitura
Janela anti-replay em webhook: o timestamp assinado e o relógio errado
Por que assinar só o corpo do webhook deixa a porta aberta para reenvio, como funciona a janela de tolerância e o que acontece quando o relógio do servidor desanda.
7 min de leitura
Lembrete de verificação abandonada, como recuperar sem virar spam
Quem parou no meio da verificação quase sempre teve motivo banal. As regras de canal, dose, saída e conteúdo do lembrete, e a base legal que sustenta o envio.
8 min de leitura
Log de auditoria imutável: como provar que o registro não foi alterado
Tabela append-only não resiste a quem tem a credencial do banco. As camadas que encarecem de verdade adulterar uma trilha de auditoria, do encadeamento por resumo à saída para fora do host.
8 min de leitura
MFA obrigatório no painel: como exigir segundo fator sem trancar a equipe
O laço de redirecionamento que trava contas sem fator cadastrado, a sequência de implantação por papel, os controles da recuperação assistida e o que medir na virada.
8 min de leitura
Multi-tenant e isolamento de dados: perguntas para seu fornecedor de KYC
Os modelos de isolamento entre clientes, onde o vazamento cross-tenant acontece de verdade e as perguntas objetivas para avaliar um fornecedor de KYC.
8 min de leitura
Restrição de IP por chave de API: o que ela protege e o que ela quebra
A allowlist de IP limita o estrago de uma credencial vazada, mas quebra em CGNAT, serverless e failover. O que ela cobre, onde falha e com o que combiná-la.
7 min de leitura
Rotação de chave de API e de segredo de webhook sem derrubar a integração
Trocar credencial só é indolor com uma janela em que as duas valem. A ordem do deploy, a telemetria que autoriza revogar e os gatilhos que obrigam a rotacionar.
7 min de leitura
Sandbox e produção separados: chaves, webhooks e storage por ambiente
A higiene de ambientes que evita crédito de teste em produção e dado real em teste: credencial que declara o ambiente, webhook segregado, storage separado e o corte do go-live.
6 min de leitura
Teste de carga em onboarding: dimensionando para o pico de marketing
Como dimensionar a verificação de identidade para picos de campanha: a conta da Lei de Little, o que testar de ponta a ponta no sandbox e como ler p95, p99 e ponto de saturação.
8 min de leitura
Teste de restauração de backup: o ensaio que ninguém faz até precisar
Backup que nunca foi restaurado é hipótese, não garantia. RPO e RTO como perguntas de desenho, o ensaio em ambiente isolado, o dado pessoal na cópia de teste e a ata que sobrevive à auditoria.
8 min de leitura
Versionamento de API: como avaliar a política de breaking changes de um fornecedor
Aprenda a separar breaking change real de evolução compatível e a avaliar changelog, prazo de depreciação, header Sunset e sandbox antes de fechar com um fornecedor de KYC.
7 min de leitura
Acessibilidade em verificação de identidade: o funil que exclui também reprova
A Lei Brasileira de Inclusão exige acessibilidade nos sites de empresas, e a captura de selfie e documento é a etapa que mais exclui. O que o WCAG 2.2 pede num fluxo de verificação.
6 min de leitura
Fila de revisão humana: quando a máquina não deve decidir sozinha
O que mandar para revisão humana num fluxo de verificação, como dimensionar fila e SLA, o contexto que o revisor precisa e o que a LGPD e a Circular BCB 3.978/2020 dizem sobre decisão automatizada.
6 min de leitura
Flash na prova de vida e segurança fotossensível
Liveness por flash de cores existe no mercado, e tela que pisca tem limite de segurança definido: o que diz o critério 2.3.1 do WCAG 2.2 e como fazer desafio ativo sem risco fotossensível.
6 min de leitura
Reconciliação de webhook, o plano para quando o evento não chega
Webhook duplica, atrasa e some. Deduplicação por identificador, decisão pelo estado e janela de reconciliação ativa formam o desenho de integração que sobrevive aos três modos de falha.
6 min de leitura
SPF, DKIM e DMARC, o e-mail de verificação que chega à caixa de entrada
Código por e-mail que cai em spam mata a conversão do onboarding. Como SPF, DKIM e DMARC autenticam o domínio remetente, e por que a política DMARC também protege o seu cliente de phishing em seu nome.
5 min de leitura
Latência de verificação: o que é síncrono, o que é assíncrono e por quê
Uma verificação de identidade dura mais que um request HTTP. Por que a decisão chega por webhook, o que o 202 significa, onde o polling e o SSE entram e quais latências medir de verdade.
5 min de leitura
Monitorar uma integração de KYC, as métricas que de fato importam
Aprovação, revisão, rejeição, latência p95, recaptura e erro de fonte externa. Como montar o painel que separa queda de conversão de aumento de fraude, com método de SLI e SLO.
7 min de leitura
Ingerir lista oficial sem quebrar: canário, encolhimento e o arquivo que era HTML
Dado público não é API. O desenho mínimo de um ingestor honesto de listas oficiais: pacote com data, latin1 contra UTF-8, membro certo do ZIP, canário de integridade e guarda de encolhimento.
8 min de leitura
Não encontrado não é não existe: como ler a resposta de uma consulta
Os quatro desfechos que uma integração de verificação colapsa em um booleano, o estrago de cada colapso e três decisões que caem da separação: cache por classe, base vencida e contrato de resposta auditável.
8 min de leitura
Construir versus comprar verificação de identidade: a conta completa
A conta honesta do build interno de verificação: modelos e a régua pública do NIST, dados de calibração sob a LGPD, operação contínua e custo de oportunidade, contra o preço por verificação de um fornecedor.
8 min de leitura
Fluxo de recaptura: transformar rejeição técnica em segunda chance
Nem toda falha de verificação é fraude, parte é foto ruim. Como desenhar a recaptura que recupera conversão sem virar porta de abuso, com as métricas no lugar certo.
5 min de leitura
Idempotência em APIs que movem dinheiro e decisão
Por que toda API que cobra, credita ou decide precisa de idempotência: o que a RFC 9110 define, como a chave de idempotência funciona e os detalhes que separam proteção real de decorativa.
5 min de leitura
Migrar de fornecedor de KYC sem parar o funil
Plano de corte para trocar de fornecedor de verificação sem parar o cadastro: inventário, retenção legal, rodagem paralela com homologação em sandbox e offboarding sem dado órfão.
6 min de leitura
Upload seguro de mídia em verificação: URL pré-assinada e limites reais
Como receber selfie e documento sem transformar o backend em depósito de mídia sensível: upload direto ao storage, política POST com limite de bytes e validação do que chega.
6 min de leitura
Widget ou API pura: escolhendo o modo de integração de KYC
Comparação honesta entre widget embutido e API pura para integrar verificação de identidade: esforço real, segurança de credenciais, CSP e quem absorve a manutenção ao longo dos anos.
6 min de leitura
OTP por e-mail e SMS, o que essa verificação prova de verdade
Código de uso único confirma posse de um canal, não identidade. O que o NIST SP 800-63B diz sobre OTP por SMS, onde o SIM swap entra, e como usar OTP no lugar certo do fluxo.
7 min de leitura
Sandbox antes de produção, como testar KYC sem dado real
Testar verificação de identidade com CPF e rosto de gente de verdade é risco jurídico e técnico. O que um sandbox precisa ter, por que determinismo importa e o que a LGPD diz sobre dado de teste.
5 min de leitura
Webhooks em KYC, integração segura para decisões que valem dinheiro
A decisão de uma verificação chega por webhook, e webhook mal integrado vira fraude ou perda de evento. Assinatura HMAC (RFC 2104), idempotência, retentativas e os erros clássicos.
5 min de leitura