
O scanner gritou 2858 vezes — quatro eram verdade
Dois mil oitocentos e cinquenta e oito problemas
Rodei o analisador estático no repositório do TatuEngine e ele devolveu 2858 ocorrências de severidade alta. Nenhum projeto tem 2858 problemas de segurança. Um número desse tamanho não descreve um sistema inseguro — descreve um relatório que ninguém vai ler.
E é aí que começa o dano. Um relatório com 2858 linhas tem o mesmo efeito prático de um relatório vazio: ele treina quem lê a ignorá-lo. A próxima execução vai devolver um número grande de novo, e a única política que sobrevive a isso é “a gente olha depois”. Depois nunca chega.
As ferramentas que uso neste projeto ficam na loja de skills — a primeira é grátis.
Quase tudo era a mesma linha
O detalhe que muda o diagnóstico: os 2858 vinham de um único identificador de regra, e essa regra disparava sobre a instrução assert do Python. Não é um problema de segurança. É um aviso de que assert pode ser removido quando o interpretador roda com otimização — irrelevante em código de teste, onde a asserção é o próprio objetivo da linha.
Todo o código de teste do projeto usa assert como mecanismo de verificação. O scanner lia cada ocorrência como uma vulnerabilidade independente: mesma causa, mesma decisão, repetida 2858 vezes.
A triagem certa não é corrigir 2858 linhas nem marcar 2858 nosec no código. É dizer uma vez que aquele diretório é código de teste e que assert ali é a ferramenta correta. Uma decisão, aplicada na configuração da varredura, elimina o ruído inteiro — e o que aparece depois dela é o sinal: quatro achados de severidade alta.
Os quatro que sobreviveram
Quatro é um número que se lê. E quatro achados de verdade pedem quatro decisões de verdade — o que exige olhar cada um.
O primeiro era o uso de md5 como checksum. O scanner classifica qualquer chamada a md5 como primitiva criptográfica quebrada, o que é correto em geral e errado neste caso: ali o hash verifica se o dado que voltou de uma descompressão é byte a byte igual ao que entrou. Não protege nada de ninguém, não autentica ninguém. É um teste de integridade, e para isso md5 basta.
Existem dois jeitos de silenciar esse achado. O primeiro é o atalho: desligar a regra naquele ponto, sem explicação, e seguir. O segundo é declarar a intenção no código:
# hash aqui compara byte a byte o roundtrip: integridade, nao autenticacao
h1 = hashlib.md5(dados, usedforsecurity=False).hexdigest()
h2 = hashlib.md5(volta, usedforsecurity=False).hexdigest()
O parâmetro não cala o scanner — ele responde a pergunta que o scanner estava fazendo. usedforsecurity=False é uma afirmação verificável sobre o uso, não um silêncio. Quem revisa depois sabe por que aquilo está ali e pode discordar. Um nosec não deixa nada para discordar.
O segundo achado era mais sério, e é o tipo que passa despercebido porque funciona nos casos fáceis. Um script de comparação chamava um utilitário externo montando a linha de comando com interpolação de string, e o nome do arquivo vinha do argumento da linha de comando. Com um nome comum, o comando roda. Com um nome que contém um ponto e vírgula, o shell encerra o primeiro comando e começa outro — e o outro é escolhido por quem passou o nome.
# antes: o nome do arquivo entrava na string que o shell interpreta
print(os.popen(f"gzip -9 -c {args.arquivo} | wc -c").read().strip())
# depois: o binario recebe o argumento como lista, sem shell no meio
_gz = subprocess.run(["gzip", "-9", "-c", args.arquivo],
capture_output=True, check=False).stdout
A diferença não é de estilo, é de superfície. Na segunda forma não existe string de comando para interpretar, então não existe injeção possível. O script continua medindo a mesma coisa e passa a ser imune à classe inteira de defeito. O commit 83fca7a fechou as duas correções junto com os outros dois achados menores, e o contador do scanner desceu de 2858 para zero de severidade alta.
O mesmo md5, dois problemas diferentes
Tem uma parte dessa história que só faz sentido depois de ver os dois lados.
No dia anterior, o mesmo md5 já tinha quebrado de outro jeito. Em um ambiente com o modo FIPS habilitado, a chamada padrão levanta exceção em vez de calcular o hash. O script morria antes de comparar coisa nenhuma — ou seja, a verificação de roundtrip que ele deveria fazer nunca acontecia, e o sintoma era um erro de biblioteca que não falava nada sobre o dado estar íntegro ou não.
A correção foi a mesma linha, usedforsecurity=False, e por um motivo diferente: declarar que o hash não é criptografia resolve tanto a objeção do modo FIPS quanto a do scanner. Dois problemas de origens distintas, um único ponto de decisão que os explica. Não foi coincidência — foi o diagnóstico certo sobre o que aquele hash estava fazendo ali.
O que isso muda
A mudança prática não é “o projeto ficou seguro”. Isso seria uma afirmação sem prova. A mudança é que o relatório do scanner passou a ser legível, e um relatório legível pode servir de gate. Enquanto o número era 2858, ninguém podia reprovar uma entrega por causa dele: o número nunca chegava a zero e a diferença entre uma regressão e o ruído de sempre era invisível.
Tem também um efeito sobre como as ferramentas são construídas. O filtro por exclusão — um diretório, uma regra, um identificador — é menos satisfatório de escrever que uma correção no código, e é a decisão correta em muitos casos. O critério é sempre a causa: se a mesma causa produz N achados, corrigir N vezes é errado, e o custo real está em separar uma coisa da outra.
E fica uma lição que vale fora da segurança: um instrumento que devolve sinal demais não está protegendo nada. Ele só desloca o trabalho para quem não tem tempo de fazer a triagem, e o resultado previsível é que a triagem nunca acontece.
Próximo passo
O filtro de ruído hoje é uma exclusão aplicada na linha de comando. O passo seguinte é transformá-lo em configuração versionada, para que o mesmo recorte valha em qualquer máquina e a diferença entre achado novo e ruído conhecido apareça sozinha.
Leia também
Mesmo projeto, mesma trilha — as histórias se conectam.
Próximo passo
Se isto te serviu, tem mais: escrevo sobre o mesmo assunto nos outros projetos, e a loja tem as ferramentas que eu uso aqui.
Anotado — aviso quando sair artigo novo.
Sem spam, descadastro de um clique. Também estou aqui: Loja de skills · Portfólio