Credenciais de teste e segredos em testes automatizados de navegador
By Mirko Peters · · Updated
Segredos em testes automatizados de navegador vazam por meio do código, dos traces, dos vídeos e dos logs. Aprenda a manter senhas fora do repositório, limitar o escopo das contas de teste e limpar os artefatos.
Automatically translated with AI from the original post. Read the English original
Segredos em testes automatizados de navegador são senhas, tokens, chaves de API e cookies de sessão de que seus testes precisam para fazer login, e eles vazam em mais lugares do que a maioria das equipes imagina. Lidar bem com eles é uma parte básica da automação de testes e da automação de navegador em geral. Este guia é para engenheiros de automação de testes que escrevem ou mantêm testes de navegador para testes ponta a ponta que fazem login em sistemas reais. Você verá onde os segredos vazam, como mantê-los fora do código e dos repositórios, como configurar contas de teste com acesso limitado, como reutilizar o estado de login com segurança e como lidar com a autenticação multifator. Um exemplo prático, com números fictícios, mostra uma auditoria rápida.
Pontos-chave
- Segredos em testes de navegador vazam em mais lugares do que o próprio código de teste: traces, capturas de tela, vídeos, logs do console, arquivos HAR e o estado de login salvo podem conter tokens ou senhas.
- Nunca escreva senhas diretamente nos arquivos de teste. Carregue-as de variáveis de ambiente localmente e do cofre de segredos da plataforma de CI nos pipelines.
- Um arquivo de estado do navegador salvo pode conter cookies de sessão ativos que permitem que alguém se passe pela conta de teste, então mantenha-o fora de todos os repositórios.
- Use contas de teste dedicadas: uma por função e, para execuções paralelas que alteram dados compartilhados, uma por worker, cada uma com apenas o acesso de que seus testes precisam.
- Limpe os artefatos antes que saiam do executor, restrinja quem pode ler os relatórios e mantenha atalhos de login exclusivos de teste fora da produção.
Onde os segredos em testes automatizados de navegador vazam
O vazamento óbvio é uma senha digitada em um dos seus scripts de teste. Os vazamentos menos óbvios são os arquivos que uma execução de testes produz. O artigo da Currents sobre como evitar vazamento de dados no Playwright lista os riscos, e eles se aplicam a outras ferramentas que registram execuções de forma semelhante:
- Traces. Um trace pode conter cabeçalhos de autorização brutos, tokens de portador, valores de cookies, snapshots de página e dados pessoais vistos no tráfego de rede. O artigo classifica os traces como o risco mais crítico.
- Capturas de tela. Um valor pode ficar visível enquanto um teste o digita, ou um token pode aparecer em uma notificação.
- Vídeos. Um vídeo grava a tela inteira durante todo o teste, incluindo senhas preenchidas automaticamente e tokens exibidos em páginas de administração.
- Logs do console e anexos. A saída do console se repete a cada nova tentativa, e as respostas de API anexadas podem conter tokens ou dados pessoais.
- Saída do relator e das etapas. Se o nome de uma etapa incluir um valor de ambiente, ele aparece nos logs de CI e nos relatórios HTML.
- Arquivos HAR. Essas gravações de rede guardam cabeçalhos e corpos de requisições e respostas, que podem incluir credenciais.
- Estado de login salvo. Um arquivo de estado guarda cookies e tokens de sessão ativos, e pode acabar no Git se ninguém o ignorar.
O artigo também alerta que a máscara de segredos do CI cobre apenas a saída dos logs e não detecta valores codificados, truncados ou unidos a outros textos. A máscara é uma rede de proteção, não uma solução.
Mantenha as senhas fora do código e do repositório
O guia da TestDino sobre autenticação no Playwright é direto: nunca escreva senhas diretamente nos arquivos de teste. Seu conselho para execuções em CI está alinhado com a prática comum em outros frameworks:
- Use variáveis de ambiente. Localmente, guarde as senhas em um arquivo de ambiente excluído do controle de versão. No CI, use o gerenciamento de segredos do seu provedor e leia os valores do ambiente do processo.
- Ignore o arquivo. Adicione os padrões do arquivo de ambiente à sua lista de itens ignorados antes do primeiro commit, e faça commit apenas de um arquivo de modelo que liste os nomes das variáveis.
- Deixe o pipeline prevalecer. A Currents recomenda configurar o carregador de ambiente para que os valores injetados pelo CI tenham precedência sobre os valores de um arquivo local.
- Use um gerenciador de segredos em equipes maiores. Estas boas práticas de segurança escalam bem, e a Currents cita os segredos nativos do CI e gerenciadores externos como Vault, AWS Secrets Manager e Google Cloud Secret Manager. Ela também recomenda tokens de curta duração por meio de identidade de carga de trabalho e permissões dos runners restritas apenas aos caminhos de segredos que a execução precisa.
- Mantenha os nomes das etapas estáticos. Não escreva um segredo no título de uma etapa. Use um rótulo fixo.
Se um segredo já foi enviado ao repositório, trate-o como exposto. Troque-o e, em seguida, limpe o histórico. Excluir o arquivo em um commit posterior não o remove do histórico.
Use contas de teste dedicadas com privilégio mínimo
Uma conta de teste é uma conta real, e merece o mesmo cuidado que qualquer outra. Quando você automatiza o login, também automatiza o acesso a um sistema real, portanto valide o que cada conta pode acessar, em cada ambiente de teste. O princípio do privilégio mínimo se aplica: conceda a cada conta apenas o acesso de que seus testes precisam e nada além disso.
- Nunca use uma conta pessoal. Um login dedicado pode ser desativado, rotacionado ou auditado sem afetar o acesso de uma pessoa.
- Uma conta por função. Se os testes verificam o que um administrador e um usuário comum podem ver, cada função precisa de sua própria conta. A TestDino lista isso como requisito para testes com múltiplas funções.
- Uma conta por worker paralelo, quando os testes alteram dados compartilhados. A documentação do Playwright sobre login descreve isso: uma única conta compartilhada só funciona se os testes puderem ser executados ao mesmo tempo sem afetar uns aos outros. Caso contrário, cada worker paralelo precisa de sua própria conta. A TestDino descreve a seleção da conta pelo índice do worker.
- Mantenha o acesso à produção restrito. Se algum teste acessar um sistema em produção, o login deve ser isolado e não deve conseguir acessar faturamento nem dados de clientes.
- Defina um responsável e uma data de expiração. Registre quem é o responsável por cada conta e quando suas senhas são revisadas. Este é um conselho nosso, não um ponto das fontes.
Logins que ninguém possui sobrevivem aos testes para os quais foram criados, e continuam válidos muito tempo depois.
Reutilize o estado de login sem expô-lo
Dados de teste e estado de login são coisas diferentes, mas ambos precisam de proteção. Fazer login pela tela em cada teste é lento, e torna cada teste automatizado dependente do fluxo de login. A documentação do Playwright sobre autenticação descreve um padrão comum: uma etapa de configuração faz login uma única vez e grava o estado do navegador em um arquivo, e os testes then começam a partir desse estado. A documentação também traz as regras de segurança:
- Crie uma pasta para os arquivos de estado e adicione-a ao seu arquivo de itens ignorados. A documentação recomenda exatamente isso.
- Trate o arquivo como uma credencial. Um aviso de perigo diz que ele pode conter cookies e cabeçalhos sensíveis que poderiam ser usados para se passar por você ou pela sua conta de teste, e a documentação desencoraja fortemente o envio desses arquivos para repositórios privados ou públicos.
- Exclua o estado armazenado quando ele expirar, ou grave-o na pasta de saída se ele não precisar persistir entre execuções.
- Quando a aplicação oferecer login por API, isso pode ser mais fácil e rápido do que controlar a interface, e o estado resultante é salvo da mesma forma.
A Currents acrescenta uma etapa de limpeza: limpe os cookies no teardown do fixture de login e restrinja quem pode ler os artefatos do CI.
Autenticação multifator e atalhos exclusivos para testes
A autenticação multifator dificulta a automação, e esse é justamente o objetivo. O TestDino sugere opções para contas de teste. Para códigos de um aplicativo autenticador, gere o código no script de configuração com uma biblioteca. Para códigos enviados por SMS ou e-mail, desative a autenticação multifator para as contas de teste no ambiente de staging ou use uma rota exclusiva para testes.
Uma rota de bypass exclusiva para testes é um risco real. O TestDino afirma que ela deve ser condicionada a uma verificação de variável de ambiente e nunca implantada em produção. Trate qualquer atalho que ignore o login como um recurso de segurança que precisa de revisão própria.
Escolha cenários de teste que exijam um login real
Nem todo caso de teste precisa de um login ao vivo. Como parte da sua estratégia de testes, sugerimos manter um ou dois cenários de ponta a ponta que acessem a página de login real em um navegador de verdade, e deixar os demais testes funcionais partirem de um estado salvo ou de um login feito por meio de APIs, como nos testes de API. Isso limita a frequência com que segredos são digitados, acelera a execução dos testes e ainda cobre o fluxo de autenticação.
Concentre as etapas de login em um único lugar, como uma classe de page object ou um fixture compartilhado, para que uma mudança na página de login ou na forma como os segredos são lidos afete apenas um script de automação. Se você copiar as etapas de login para dentro de cada teste, isso se torna uma fonte comum de vazamentos e aumenta a probabilidade de um teste instável quando a página mudar.
Mantenha os testes manuais e exploratórios das telas de login em contas que a automação não utiliza, porque logins compartilhados causam bloqueios de conta e trilhas de auditoria pouco claras. Acrescente uma pequena verificação de testes de segurança na mesma execução paralela, por exemplo uma busca por tokens nos relatórios. Qualquer que seja a ferramenta de automação escolhida, as regras para segredos não mudam.
Exemplo: uma auditoria de 30 minutos
Os números são fictícios.
Uma equipe executa 90 testes de navegador como parte de seus testes de regressão e verifica o repositório de testes em busca de segredos. A auditoria leva 30 minutos e encontra cinco problemas:
- Duas senhas escritas em um arquivo auxiliar de testes.
- Uma pasta com arquivos de estado de login salvos que não está na lista de itens ignorados.
- Uma configuração de rastreamento que registra todos os testes, e artefatos de relatório que todos os funcionários podem abrir.
- Uma conta usada pelos 8 workers paralelos, o que faz dois testes falharem aleatoriamente.
- A conta pessoal de um ex-testador, ainda usada por um teste.
As correções levam um dia. As senhas são movidas para o armazenamento de segredos do CI, e os valores antigos são alterados. A pasta de estado é ignorada e removida do histórico. Os rastreamentos são mantidos apenas para os testes que falharam, e o acesso aos relatórios é restrito ao grupo de QA. Cada worker paralelo recebe a própria conta, e as falhas aleatórias param. A conta pessoal é substituída por uma conta dedicada, com um responsável definido. A equipe agenda a mesma auditoria a cada trimestre.
Erros comuns
- Codificar uma senha "só por enquanto". Ela permanece no histórico para sempre.
- Versionar o estado de login salvo. O arquivo funciona como uma senha para a conta.
- Confiar no mascaramento de logs do CI. Ele não detecta valores codificados ou parciais e não faz nada em relação a rastreamentos ou vídeos.
- Registrar tudo. Vídeos, rastreamentos completos e relatórios abertos espalham segredos para mais pessoas.
- Compartilhar um único login entre workers paralelos. Isso causa tanto falhas aleatórias quanto trilhas de auditoria pouco claras.
- Esquecer rotas de bypass exclusivas para testes em produção. Condicione-as e revise-as.
Como o software pode ajudar
Comece pelo armazenamento de segredos da sua plataforma de CI e, se o seu repositório oferecer, pela verificação de segredos. Um gerenciador de segredos também pode criptografar os valores armazenados, e ajuda quando várias equipes compartilham logins, pois centraliza o controle de acesso, a rotação e o registro de auditoria. As configurações do seu framework de testes controlam o que é registrado, e um pequeno script pode remover cabeçalhos sensíveis dos artefatos. Escolha ferramentas de teste automatizado que se encaixem na sua configuração de CI e teste a limpeza em uma execução de amostra antes de depender dela. As mesmas regras valem para Selenium, Cypress, Playwright ou uma suíte de testes em Python, e tanto para testes de interface quanto para testes de API que chamam a aplicação web.
Próximo passo
Abra hoje o seu repositório de testes, procure por senhas, tokens e arquivos de estado salvos e mova cada segredo encontrado para o armazenamento de segredos do CI. Depois disso, revise como os seus testes registram rastreamentos e vídeos, para que os segredos em testes automatizados de navegador deixem de se espalhar pelos seus relatórios.