Instalar e configurar a Web Zeta Test Management¶
Zeta Test Management Web fornece acesso ao navegador para projetos de teste gerenciados centralmente. O aplicativo atual é baseado em ASP.NET Core e .NET 10. A interface web e o aplicativo Windows usam os mesmos projetos e cobrem as tarefas de domínio no gerenciamento de testes. As funções do sistema operacional local usam fluxos de trabalho adaptados ao navegador ou uma Ponte Local aprovada.
Para uma implantação de produção central, use o pacote IIS zetatest-web.zip. A configuração separada do EXE Web inicia uma demonstração local ou uma instância de usuário único com o Kestrel; não é uma substituição para uma instalação IIS segura.
Este guia abrange a escolha de implantação, IIS e HTTPS, permissões de menor privilégio, configuração, atualizações, verificação e rollback.
Escolha o modelo de implantação e prepare-se¶
Opções de implantação¶
- Exemplo local de demonstração ou instância de usuário único: a configuração do EXE Web inicia o aplicativo empacotado localmente através do Kestrel. Use-o para avaliação ou um usuário individual do Windows, não como servidor central de produção.
- Implementação do IIS central: extrair
zetatest-web.zipem um servidor Windows e executar sua pastaWebsitecomo uma aplicação IIS. Este é o caminho de produção documentado. - Proxy inverso: um proxy gerenciado pode terminar TLS e publicar o aplicativo. Validar encaminhamento, cabeçalhos confiáveis, redirecionamentos e o caminho HTTPS completo.
Pré-requisitos¶
- uma combinação Windows Server e IIS aprovada para a versão Zeta Test Management prevista;
- Acesso administrativo ao sítio IIS, conjunto de pedidos, vinculação e certificado;
- o pacote de hospedagem .NET 10 correspondente, incluindo o módulo principal V2 da ASP.NET;
- Um nome DNS estável e um certificado TLS de confiança;
- Projeto de backup e armazenamento de banco de dados fora da pasta de lançamento do site substituível;
- Uma identidade técnica dedicada com apenas os direitos de arquivo e banco de dados necessários.
Defina backup, restauração, atualização da janela, proprietário do rollback e um projeto de aceitação representativo antes da primeira implantação.
Instalar e configurar a aplicação IIS¶
- Instale o IIS e o .NET 10 Hosting Bundle que combina com o lançamento. Reinicie o IIS ou o servidor quando o instalador precisar dele.
- Extrair
zetatest-web.zipem uma pasta de encenação. O caminho físico do IIS apontará para a pastaWebsitecontida. - Crie um pool de aplicativos IIS dedicado com "No Managed Code", desative aplicativos de 32 bits e atribua a identidade técnica aprovada.
- Crie o site ou aplicativo IIS. Mantenha o
web.configfornecido e sua configuraçãoAspNetCoreModuleV2. - Conceda ler e executar o acesso à pasta do programa e apenas o necessário modificar o acesso a projetos aprovados, armazenamento de usuários, anexos e pastas de log. Conceda direitos mínimos à base de dados.
- Crie a vinculação HTTPS para o nome e certificado DNS de produção. HTTP deve permanecer somente quando um ponto final de redirecionamento intencional é necessário.
- Configure
Config.json,appsettings.jsone, somente quando os caminhos do cliente e do servidor diferem,foldermappings.json. - Inicie o pool de aplicativos e local. Acesse o HTTPS e verifique a lista de projetos, permissões e um fluxo de trabalho de teste representativo.
Limites de configuração importantes¶
Config.json contém configurações Zeta Test Management clássicas, tais como projectSearchFolderPaths separado por ponto e vírgula. O appsettings.json controla o comportamento do núcleo ASP.NET, incluindo HTTPS, cookies, controles de registro, idioma e área web:
{
"AppSettings": {
"UseHttpsRedirection": true,
"AllowInsecureCookies": false,
"ExperimentalWebAreas": {
"Enabled": true,
"DisabledAreas": []
}
}
}
Esses valores são exemplos e devem corresponder à topologia de implantação. Trate o serviceApiKey e todas as outras chaves como um segredo. Arquivos de projeto, configuração, backups e logs nunca devem ser expostos como arquivos de site estáticos. A reescrita de URL do IIS não é um pré-requisito Zeta Test Management a menos que seu próprio redirecionamento ou configuração proxy o exija.
Proteção contra repetidas tentativas de entrada de sinal¶
Esta proteção requer uma compilação atualizada do servidor web que a inclua. A configuração sozinho não pode adicioná- la às instalações mais antigas.
O login de senha para administração de servidores e projetos limita falhas repetidas por conta e independentemente por endereço IP. Cinco tentativas falhadas são permitidas sem um atraso; a sexta falha inicia uma espera de dois segundos. Falhas adicionais aumentam para quatro, oito segundos e assim por diante, até cinco minutos. O acesso bem-sucedido limpa apenas o contador de contas. Os limites de IP permanecem em vigor para que uma conta válida não possa redefini-los.
Durante uma espera, o formulário exibe uma mensagem e retorna HTTP 429 com Retry-After. Mesmo uma senha correta só pode ser verificada novamente após a espera expirar. As contas não estão permanentemente desactivadas. Os contadores expiram após 30 minutos sem uma tentativa admitida; os pedidos rejeitados não prolongam a espera. Cada IP também permite, no máximo, 30 tentativas admitidas por 60 segundos, com atrasos de IP crescentes após a falha do vigésimo. Considere esses limites compartilhados quando muitos usuários compartilham um endereço público.
Configurar o AppSettings.LoginProtection no appsettings.json:
{
"AppSettings": {
"LoginProtection": {
"Enabled": true,
"FreeAttempts": 5,
"IpFreeAttempts": 20,
"BaseDelaySeconds": 2,
"MaxDelaySeconds": 300,
"EntryExpirationMinutes": 30,
"IpPermitLimit": 30,
"IpWindowSeconds": 60,
"MaxEntries": 10000,
"InFlightSeconds": 120
}
}
}
InFlightSeconds limita a reserva para uma verificação de senha inacabada. Verificações simultâneas da mesma conta são rejeitadas; uma reserva deixada por um processo travado é contada como uma tentativa falhada depois que ela expirar. Os limites MaxEntries armazenaram contas e entradas IP juntas. A retenção deve cobrir o atraso máximo, a janela IP e a duração da reserva. As configurações inválidas são rejeitadas. Reinicie o aplicativo web após alterar a configuração.
Os contadores persistem na subpasta LoginProtection do diretório de dados da administração privada. AppSettings.LoginProtectionStateDirectory pode sobrepor isso com um caminho absoluto fora do webroot. Todos os trabalhadores de uma instalação devem compartilhar o mesmo diretório durável e ter permissão de modificação. Identificadores armazenados são valores derivados, não nomes de usuário de texto claro ou endereços IP. Não apagar este estado durante as actualizações. Se o diretório de dados de administração estiver dentro do diretório da aplicação, configure um caminho de estado durável separado antes de substituir esse diretório. Uma loja indisponível, cheia ou corrompida devolve HTTP 503 em vez de permitir uma verificação de senha desprotegida; verifique espaço em disco, permissões e o registro do servidor.
A persistência do arquivo é destinada aos trabalhadores no mesmo servidor. Vários servidores web exigem um limite adicional compartilhado em um serviço de upstream confiável. Por trás de um proxy reverso, a configuração do hosting deve fornecer o IP real do cliente através de um caminho confiável. Os cabeçalhos Arbitrários X-Forwarded-For não são aceitos como prova de identidade.
Esta proteção cobre os formulários de senha do navegador da aplicação. A entrega do token do Windows-to-web uma vez, uma demonstração explicitamente configurada sem senha e projetos sem gerenciamento de usuário não adquirem um prompt de senha extra. Chaves de API e provedores de identidade externa têm limites de segurança separados. O Throttling não substitui HTTPS, senhas fortes ou acesso protegido ao servidor.
Atualizar, verificar e voltar¶
Trate cada atualização da web como uma alteração controlada do servidor:
- Faça backup de projetos, bases de dados, configuração do site e registros necessários. Grave a versão atual do produto e o caminho ativo do site.
- Extraia o novo
zetatest-web.zipem uma pasta de lançamento paralela. - Compare a nova configuração padrão com o ambiente atual. Mesclar os valores necessários deliberadamente; não copiar o antigo
Config.json,appsettings.json,foldermappings*.jsonouweb.configcegamente. - Pare o pool de aplicativos, mude o caminho físico do IIS para a nova pasta
Websitee reinicie o pool. - Verifique HTTPS, login, lista de projetos, funções, acesso a arquivos e bancos de dados, uma execução de teste típica e os espaços de trabalho web pretendidos. Revise o registro de eventos do Windows e os logs de aplicativos habilitados.
Para o rollback, pare o pool, restaure o caminho anterior do site e, quando uma migração de dados requer isso, o projeto correspondente e backup do banco de dados. Mantenha a pasta de lançamento anterior até que o período de aceitação acordado tenha terminado.
Áreas web regulares estão habilitadas por padrão na versão 6. A configuração historicamente chamada ExperimentalWebAreas pode desativar áreas individuais; seu nome não implica que todos os espaços de trabalho adicionais são recursos de visualização. A IA requer configuração e aprovação separadas.
Para fluxos de trabalho do navegador, continue com Usar o Zeta Test Management na aplicação Web. Para a configuração do conector e MCP, consulte Integração e automação.
Base de dados da administração interna e conversão automática¶
A aplicação web usa SQLite (ztm.sqlite) para seus dados internos de administração, incluindo configurações de servidor, mapeamentos de usuários e dados de administração de IA/CI. Os bancos de dados do projeto continuam a usar VistaDB ou Microsoft SQL Server; esta operação não os converte.
No primeiro começo com um ztm.sdf existente, o serviço converte o banco de dados de administração automaticamente. Pare todos os processos web/backend mais antigos acessando o mesmo diretório de dados do servidor primeiro. Agende uma janela de manutenção e faça backup do diretório completo de dados do servidor, incluindo configuração e chaves. A conversão requer espaço livre adicional para o backup e o novo banco de dados.
O serviço faz backup do arquivo existente, copia e verifica os dados, e só então ativa o SQLite. Não aceita pedidos normais até que isso seja bem sucedido. A fonte SQL Compact está protegida contra gravação adicional; não remova esta proteção durante a operação. Mantenha ztm.sdf, ztm.sdf.pre-sqlite.bak e o registro de ativação ztm.sqlite.activation com o banco de dados SQLite. A pasta configurada através do alternativeServerCentralDataStorageFolderPath deve existir e ser escrita; uma falha não cai de volta para um banco de dados vazio em outro diretório.
Se a conversão falhar, a inicialização permanece bloqueada. Verifique os registros do servidor, espaço disponível, permissões de escrita e processos antigos restantes. Depois de corrigir o problema, reinicie o serviço; ele retoma o processo de conversão controlado automaticamente. Não ignorar um banco de dados incompleto ou danificado, apagando registros de conversão ou criando um arquivo vazio.
Bibliotecas SQLite nativas estão incluídas no pacote web. Use o pacote completo para a arquitetura pretendida em vez de copiar DLLs individuais. As bibliotecas SQL Compact ainda são necessárias para importar bancos de dados de administração mais antigos; uma instalação manual separada do SQLite não se destina. O servidor web ainda requer Windows; mudar este banco de dados não introduz o suporte Linux.
Mantenha a base de dados de administração num disco local do servidor web. Faça backup com o serviço parado, incluindo arquivos e chaves acompanhantes. Para retornar ao software mais antigo, pare o serviço e restaure um backup consistente. Alterações salvas no SQLite após a conversão não estão presentes no backup antigo do SQL Compact.