Oculte segredos antes de gravar logs

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Grave nos logs um registro de diagnóstico restrito a uma allowlist, em vez das requisições brutas de ferramentas, e verifique a ocultação em cada destino de saída.

Monte um registro seguro

Prefira uma allowlist com campos como operation, status, duration e correlation_id. Não serialize a requisição inteira para tentar remover os segredos depois. A OWASP inclui tokens de acesso, senhas e connection strings entre os dados que não devem ser registrados diretamente em log.

Procedimento na fronteira

Remova cabeçalhos de autorização, cookies, parâmetros de query que carreguem credenciais e campos aninhados sensíveis antes que o registro chegue a um logger, a um formatador de exceções ou a um exportador de telemetria. Limite o tamanho das strings e neutralize caracteres de controle quando o formato do log exigir. Por padrão, evite registrar corpos de requisição ou de resposta.

Teste com um segredo canário

Use um marcador sintético, nunca uma credencial real. Passe-o por fixtures de requisição bem-sucedida, falha de validação, timeout e exceção não tratada. Capture os logs da aplicação, a saída de debug do transporte e a telemetria. Verifique por meio de asserções que o marcador não aparece em nenhuma saída, inclusive em mensagens de erro aninhadas.

Tratamento de falhas e limites

Se uma credencial real foi registrada, interrompa a exposição e siga o procedimento de rotação e de resposta a incidentes definido pelo responsável pela credencial. Ocultar os registros futuros não elimina as cópias anteriores. Aplicar hash a um segredo de baixa entropia não o anonimiza necessariamente. A ocultação reduz a exposição, mas controles de acesso e limites de retenção continuam necessários para os demais dados de diagnóstico.

Escopo e base

Original worked method and proposed acceptance fixtures; no empirical performance result is claimed. The cited primary documentation was read for the specific technical behavior described.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.