Documentação Akrus · v1 em prévia
Proteja credenciais e os dados consultados.
Mantenha as chamadas no servidor, separe os produtores e registre diagnósticos sem expor segredos.
Nesta página
Ciclo de vida da credencial
Armazenamento
- Guarde a chave em um gerenciador de segredos ou configuração privada do servidor.
- Não use variáveis públicas do frontend, URLs, aplicativos distribuídos ou repositórios para armazená-la.
- Restrinja o acesso às pessoas e processos responsáveis pela integração.
Uso
- Envie Authorization somente por HTTPS para a origem autorizada.
- Não deixe usuários escolherem livremente a URL que receberá a credencial.
- Oculte cabeçalhos sensíveis nos logs, ferramentas de rastreamento e tickets.
Isolamento entre produtores
Cada credencial está vinculada a um produtor. Uma aplicação que atende várias contas precisa guardar cada conexão separadamente e autorizar o acesso aos dados também no próprio sistema. Alterar uma query string não muda o produtor da consulta.
Separe caches, checkpoints e registros pela conta conectada. A resposta da API usa Cache-Control: no-store; não a coloque em cache público ou CDN compartilhada. Se mantiver uma cópia privada, implemente controle de acesso e atualização.
As coleções não retornam identidade de compradores, mas ainda contêm informações comerciais do produtor. Restrinja exportações e evite registrar o corpo completo de respostas quando rota, status e código forem suficientes para o diagnóstico.
Se uma credencial for exposta
Interrompa a exposição
Remova o segredo dos locais acessíveis e suspenda os processos envolvidos. Apagar um commit ou log não invalida uma chave já copiada.
Solicite revogação
Acione a administração da Akrus para revogar a credencial. Não envie o segredo no pedido de suporte.
Substitua a conexão
Solicite uma nova credencial com os escopos necessários e atualize os processos autorizados.
Valide e registre
Confira uma leitura com a nova chave, confirme a revogação da anterior e documente o período e os sistemas afetados.
O que registrar no seu sistema
| Registrar | Não incluir |
|---|---|
| Horário com fuso e duração da chamada | Authorization ou segredo da credencial. |
| Método, caminho, status HTTP e error.code | URLs contendo credenciais ou parâmetros sensíveis. |
| Identificador interno da execução e conta autorizada | Dados de outras contas ou corpos completos sem necessidade. |
| Número de tentativas e estado do checkpoint | Capturas de configuração que mostrem segredos. |
Políticas e acesso
Desenvolvedores
Autenticação
Bearer token, escopos e revogação de credenciais.
Confiança e transparência
Segurança
Proteção da conta, canais oficiais e relato de vulnerabilidades.
Confiança e transparência
Privacidade
Tratamento de dados e contato de privacidade.
Referência conferida em 8 de outubro de 2026. Relatar uma dúvida na documentação.