API Key e CPF são duas superfícies de risco
A API de CPF recebe dados pessoais e exige uma credencial para consulta. Se sua chave estiver em JavaScript no navegador, ela será visível. Se você registrar URLs de GET em access logs, o CPF poderá ser armazenado sem necessidade. Use HTTPS, mas lembre-se: criptografia em trânsito não impede que servidores e ferramentas internas gravem URL e cabeçalhos.
A API documenta X-API-KEY, Bearer e autenticação por query string. Prefira o header no servidor. Evite colocar tokens em ?token= ou ?api_key=, porque valores de URL podem circular por logs, ferramentas de depuração e relatórios.
Onde armazenar a API Key
- Use variável de ambiente ou gerenciador de segredos.
- Não inclua credenciais no Git, exemplos públicos ou arquivos
.envcompartilhados. - Restrinja permissões e documente processo de rotação e revogação.
- Separe acesso a produção de testes quando o fornecedor disponibilizar essa possibilidade.
- Evite exibir headers de autenticação em páginas de diagnóstico.
// Código exclusivamente de backend.
const chave = process.env.APICPF_KEY;
if (!chave) throw new Error("Credencial não configurada");
const response = await fetch(
"https://api.apicpf.dev/consulta?cpf=52998224725",
{ headers: { "X-API-KEY": chave } }
);
O CPF usado acima é o exemplo da documentação. Em produção, o valor da query deve ser tratado como dado pessoal e não deve aparecer em logs de aplicação ou proxy quando for possível redigir esse campo.
Quais logs manter
Registre eventos de operação, não conteúdo cadastral. Um evento seguro pode conter somente operation, status, duration_ms e request_id. Não salve o JSON completo de nome, mae e data_nascimento só para investigar latência.
{ "operation": "consulta_cpf", "status": 200, "duration_ms": 180, "request_id": "req_demo_17" }
Valores ilustrativos; não são dados reais de desempenho.
Checklist de proteção no backend
- Exija usuário autenticado e autorização para iniciar consultas.
- Normalize o CPF e avalie necessidade e base legal antes de enviá-lo.
- Defina controle de requisições no seu próprio endpoint.
- Configure redaction de query strings sensíveis, headers e payloads nas ferramentas de observabilidade.
- Determine retenção mínima, acesso aos dados e descarte.
- Revogue a API Key se houver exposição e investigue uso indevido.
Consulte o guia sobre privacidade e LGPD e a documentação para opções de autenticação.
Perguntas frequentes
HTTPS impede vazamentos de dados nos logs?
Não. O tráfego é descriptografado no destino e ainda pode aparecer em registros internos, se você não configurá-los.
Posso usar Next.js com API Key protegida?
Sim, desde que a consulta aconteça em componente ou rota server-side e a chave não seja exposta ao browser. Veja o tutorial Next.js.
