Cases / Hardening do SSO

Hardening do SSO — Modernização de Segurança

Atualizar dependência num serviço de autenticação é mudança em que "subiu sem erro" não prova nada: o que quebra é silencioso e só aparece quando alguém não consegue entrar. O case mostra como esse risco foi medido antes de ser assumido.

FunçãoDesenvolvedor (projeto autoral)
PeríodoOut 2026
SituaçãoConcluído, em produção
Screenshot ampliado — Hardening do SSO

O problema

O serviço de autenticação acumulava dependências fixadas com vulnerabilidades conhecidas: 27 identificadores em 5 pacotes, dos quais 17 na própria biblioteca que valida os tokens do serviço. Atualizar dependências num serviço de autenticação é o tipo de mudança em que "subiu sem erro" não significa nada: uma mudança silenciosa de comportamento no hash de senha ou na validação de token não aparece em log, aparece quando alguém não consegue entrar. Não havia verificação automática de dependências no CI, nem atualização automatizada, e a suíte de testes nunca exercitava o servidor HTTP real: ela conversava com a aplicação em processo.

Decisões técnicas

  • Travar o comportamento antes de mudá-lo: antes de tocar numa versão, testes fixaram o comportamento atual — um texto cifrado gerado na versão antiga precisava continuar decifrando, um token com algoritmo nulo precisava continuar sendo recusado, um payload adulterado com assinatura antiga também. Esses testes passam nas duas versões, e é essa coincidência que prova que o upgrade não mudou nada. Teste escrito depois da mudança só confirma a mudança.
  • Prever antes de medir: para cada pacote, o changelog foi lido e o que se esperava quebrar foi registrado por escrito antes de rodar. Uma das previsões falhou, e essa foi a mais útil: a mudança documentada não teve o efeito que o texto sugeria. Sem a previsão registrada, o resultado teria passado como "nada mudou, ótimo".
  • Bytes não são caracteres: a nova versão da biblioteca de hash passou a recusar senhas acima de 72 bytes, onde a anterior truncava em silêncio. A validação do sistema limitava 72 caracteres. Em português, 72 caracteres acentuados passam de 90 bytes: usuários com senha longa criada antes simplesmente deixariam de conseguir entrar, sem erro visível para eles e sem nada no monitoramento. A correção é assimétrica de propósito: definir senha passou a recusar acima de 72 bytes, e o login continua truncando como antes, para não trancar ninguém que já está dentro. Quem define uma senha hoje nunca cria o problema; quem já tinha não é punido por ele.
  • Transformar disciplina em automação: o que depende de alguém lembrar não acontece. Entrou um job de segurança bloqueante no CI, com verificação de vulnerabilidades e varredura de segredos, atualização automática de dependências e permissões mínimas por job. O gate falha em vulnerabilidade nova, que é o ponto: ele protege o futuro, não limpa o passado.
  • Testar o servidor, não só a aplicação: a suíte nunca subia o servidor real, então o comportamento atrás de proxy (resolução do IP do cliente, limite de requisições, encerramento gracioso) não tinha cobertura nenhuma. Foram acrescentados testes que constroem a imagem, sobem o container e verificam esse comportamento, incluindo um caso de controle que prova que o teste consegue falhar.
  • Verificar em produção: a mudança não termina com o CI verde. Só foi dada por concluída quando os dois caminhos de envio de e-mail chegaram de verdade, o login com segundo fator funcionou, uma sessão aberta antes do deploy continuou válida e o formulário recusou entrada maliciosa com o código certo.

Resultado

27 identificadores de vulnerabilidade resolvidos, 11 atualizações de dependência integradas (incluindo duas trocas de versão principal) e a suíte de testes de 249 para 305, com 97% de cobertura. O CI ganhou um portão de segurança bloqueante, e a verificação foi feita ponta a ponta em produção. O defeito de codificação foi corrigido antes da atualização que o teria disparado: nenhum usuário chegou a ser afetado.

Todo o trabalho seguiu o padrão de especificação do projeto: spec numerada, requisitos em EARS e critério de aceite executável, com comando e saída esperada em vez de prosa. A execução foi feita por um agente de IA sob níveis explícitos de autorização, com parada obrigatória antes de qualquer commit, push ou alteração em produção. As decisões acima não vieram do agente: vieram de ler changelog, medir e decidir o que travar antes de mudar.