Vai al contenuto

Installare e configurare Zeta Test Management Web

Zeta Test Management Web offre l'accesso del browser ai progetti di test gestiti centralmente. L'applicazione corrente si basa su ASP.NET Core e .NET 10. L'interfaccia web e l'applicazione Windows utilizzano gli stessi progetti e coprono le attività di dominio nella gestione dei test. Le funzioni del sistema operativo locale utilizzano flussi di lavoro adattati al browser o un Ponte locale approvato.

Per una distribuzione di produzione centrale, utilizzare il pacchetto IIS zetatest-web.zip. La configurazione web EXE separata avvia una demo locale o un'istanza utente singolo con Kestrel; non è un sostituto per un'installazione IIS protetta.

Questa guida copre la scelta di distribuzione, IIS e HTTPS, autorizzazioni meno-privilege, configurazione, aggiornamenti, verifica e rollback.

Scegliere il modello di distribuzione e preparare

Opzioni di distribuzione

  • Esempio locale di demo o singolo utente: la configurazione web EXE inizia l'applicazione in bundle localmente attraverso Kestrel. Utilizzare per la valutazione o un utente Windows individuale, non come server di produzione centrale.
  • Distribuzione di IIS centrale: estratto zetatest-web.zip su un server Windows ed eseguire la sua cartella Website come applicazione IIS. Questo è il percorso di produzione documentato.
  • Delegazione inversa: un proxy gestito può terminare TLS e pubblicare l'applicazione. Convalida inoltro, intestazioni attendibili, reindirizzamenti e il percorso HTTPS completo.

Prerequisiti

  • una combinazione di Windows Server e IIS approvata per il rilascio previsto di Zeta Test Management;
  • accesso amministrativo per il sito IIS, pool di applicazioni, binding e certificato;
  • il corrispondente .NET 10 Hosting Bundle, compreso ASP.NET Core Module V2;
  • un nome DNS stabile e certificato TLS di fiducia;
  • progetto di backup e archiviazione di database al di fuori della cartella di rilascio del sito sostituibile;
  • un'identità tecnica dedicata con solo i diritti di file e database richiesti.

Definire backup, ripristino, finestra di aggiornamento, proprietario rollback e un progetto di accettazione rappresentativa prima della prima distribuzione.

Installare e configurare l'applicazione IIS

  1. Installare IIS e il .NET 10 Hosting Bundle che corrisponde al rilascio. Riavviare IIS o il server quando l'installatore lo richiede.
  2. Estrarre zetatest-web.zip in una cartella di staging. Il percorso fisico di IIS porterà alla cartella Website contenuta.
  3. Creare un pool di applicazioni IIS dedicato con “No Managed Code”, disabilitare le applicazioni a 32 bit e assegnare l'identità tecnica approvata.
  4. Crea il sito o l'applicazione IIS. Mantenere la web.config fornita e la sua configurazione AspNetCoreModuleV2.
  5. Concedi di leggere ed eseguire l'accesso alla cartella del programma e solo l'accesso necessario modificare l'accesso al progetto approvato, la memorizzazione degli utenti, l'allegato e le cartelle di registro. Concedi diritti minimi di database.
  6. Creare il binding HTTPS per il nome e il certificato DNS di produzione. HTTP dovrebbe rimanere solo quando è necessario un endpoint reindirizzato intenzionale.
  7. Configurare Config.json, appsettings.json e, solo quando i percorsi client e server differiscono, foldermappings.json.
  8. Avviare il pool di applicazioni e il sito. Accedi tramite HTTPS e verifica l'elenco dei progetti, le autorizzazioni e un flusso di lavoro di prova rappresentativo.

Importanti confini di configurazione

Config.json contiene le classiche impostazioni Zeta Test Management come projectSearchFolderPaths semi-colon. appsettings.json controlla ASP.NET Comportamento core compreso HTTPS, cookie, registrazione, lingua e controlli di area web:

{
  "AppSettings": {
    "UseHttpsRedirection": true,
    "AllowInsecureCookies": false,
    "ExperimentalWebAreas": {
      "Enabled": true,
      "DisabledAreas": []
    }
  }
}

Questi valori sono esempi e devono corrispondere alla topologia di distribuzione. Tratta serviceApiKey e ogni altra chiave come un segreto. I file di progetto, la configurazione, i backup e i log non devono mai essere esposti come file del sito statico. La riscrittura dell'URL di IIS non è un prerequisito Zeta Test Management a meno che la vostra configurazione redirect o proxy non lo richieda.

Protezione contro ripetuti tentativi di firma

Questa protezione richiede una creazione di server web aggiornata che lo include. La configurazione da sola non può aggiungerla alle installazioni più vecchie.

Password sign-in per l'amministrazione del server e i progetti limitano i guasti ripetuti per account e indipendentemente per indirizzo IP. Cinque tentativi falliti sono consentiti senza un ritardo; il sesto fallimento inizia un'attesa di due secondi. Ulteriori fallimenti aumentano a quattro, otto secondi e così via, fino a cinque minuti. Il successo del sign-in cancella solo il contatore del conto. I limiti IP rimangono in vigore in modo che un account valido non possa ripristinarli.

Durante un'attesa, il modulo visualizza un messaggio e restituisce HTTP 429 con Retry-After. Anche una password corretta può essere controllata solo dopo la scadenza dell'attesa. I conti non sono definitivamente disabilitati. I contatori scadono dopo 30 minuti senza un tentativo ammesso; le richieste rifiutate non estendono l'attesa. Ogni IP permette anche di effettuare al massimo 30 tentativi ammessi per 60 secondi, con un aumento dei ritardi IP dopo il ventesimo fallimento. Considerare questi limiti condivisi quando molti utenti condividono un indirizzo pubblico.

Configurare AppSettings.LoginProtection in 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 la prenotazione per un controllo password incompiuto. I controlli correnti dello stesso account vengono respinti; una prenotazione lasciata da un processo crashato viene contata come un tentativo fallito dopo la sua scadenza. MaxEntries limita l'account memorizzato e le voci IP insieme. La conservazione deve coprire il ritardo massimo, la finestra IP e la durata della prenotazione. Le impostazioni non valide sono respinte. Riavviare l'applicazione web dopo la modifica della configurazione.

I contatori persistono nella sottocartella LoginProtection della directory di dati dell'amministrazione privata. AppSettings.LoginProtectionStateDirectory può sovrascrivere questo con un percorso assoluto al di fuori del webroot. Tutti i lavoratori di un'installazione devono condividere la stessa directory durevole e avere il permesso di modifica. Gli identificatori archiviati sono valori derivati, non nomi utente di testo chiaro o indirizzi IP. Non eliminare questo stato durante gli aggiornamenti. Se la directory di dati dell'amministrazione è all'interno della directory dell'applicazione, configurare un percorso di stato durevole separato prima di sostituire quella directory. Un negozio non disponibile, completo o danneggiato restituisce HTTP 503 piuttosto che consentire un controllo password non protetto; controllare lo spazio del disco, le autorizzazioni e il registro del server.

La persistenza dei file è destinata ai lavoratori nello stesso server. I server web multipli richiedono un limite condiviso aggiuntivo a un servizio a monte affidabile. Dietro un proxy inverso, la configurazione di hosting deve fornire l'IP client reale attraverso un percorso affidabile. Le intestazioni arbitrarie X-Forwarded-For non sono accettate come prova di identità.

Questa protezione copre i moduli di password del browser dell'applicazione. Mano di token di Windows-to-web una volta, una demo e progetti senza password configurati esplicitamente senza gestione dell'utente non acquisiscono un prompt di password extra. Le chiavi API e i fornitori di identità esterni hanno confini di sicurezza separati. Il Throttling non sostituisce HTTPS, password forti o accesso protetto al server.

Aggiornamento, verifica e riavvolgi

Trattare ogni aggiornamento web come cambiamento di server controllato:

  1. Recuperare progetti, database, configurazione del sito web e registri richiesti. Registra la versione attuale del prodotto e il percorso attivo del sito web.
  2. Estrarre il nuovo zetatest-web.zip in una cartella di rilascio parallela.
  3. Confrontare la nuova configurazione predefinita con l'ambiente corrente. Unire i valori richiesti deliberatamente; non copiare il vecchio Config.json, appsettings.json, foldermappings*.json o web.config ciecamente.
  4. Fermare il pool di applicazioni, passare il percorso fisico IIS alla nuova cartella Website e riavviare la piscina.
  5. Verificare HTTPS, sign-in, elenco progetti, ruoli, file e accesso al database, un tipico test eseguito e gli spazi di lavoro web previsti. Verifica il registro eventi di Windows e i registri delle applicazioni abilitati.

Per il rollback, arrestare la piscina, ripristinare il percorso del sito precedente e, quando una migrazione di dati lo richiede, il progetto corrispondente e il backup del database. Mantenere la cartella di rilascio precedente fino al termine del periodo di accettazione concordato.

Le aree web regolari sono abilitate per impostazione predefinita nella versione 6. L'impostazione storicamente denominata ExperimentalWebAreas può disabilitare le singole aree; il suo nome non implica che tutti gli spazi di lavoro aggiuntivi siano funzioni di anteprima. AI richiede configurazione e approvazione separate.

Per i flussi di lavoro del browser, continuare con Utilizzare Zeta Test Management nell'applicazione web. Per il connettore e la configurazione MCP, vedere Integrazioni e automazione.

Base dati di amministrazione interna e conversione automatica

L'applicazione web utilizza SQLite (ztm.sqlite) per i suoi dati di amministrazione interna, comprese le impostazioni del server, le mappe degli utenti e i dati di amministrazione AI/CI. I database dei progetti continuano a utilizzare VistaDB o Microsoft SQL Server; questa operazione non li converte.

Al primo avviamento con un ztm.sdf esistente, il servizio converte automaticamente il database di amministrazione. Interrompere tutti i vecchi processi di web/backend accedendo prima alla stessa directory dati del server. Pianificare una finestra di manutenzione e eseguire il backup della directory dati server completa, inclusa la configurazione e le chiavi. La conversione richiede spazio libero aggiuntivo per il backup e il nuovo database.

Il servizio è in grado di eseguire il backup del file esistente, le copie e la verifica dei dati, e solo successivamente attiva SQLite. Non accetta richieste normali fino a quando questo non avrà successo. La sorgente SQL Compact è protetta contro ulteriori scritture; non rimuovere questa protezione durante il funzionamento. Tenere ztm.sdf, ztm.sdf.pre-sqlite.bak e il record di attivazione ztm.sqlite.activation con il database SQLite. La directory configurata tramite alternativeServerCentralDataStorageFolderPath deve esistere ed essere scrivibile; un guasto non rientra in un database vuoto in un'altra directory.

Se la conversione fallisce, l'avvio rimane bloccato. Controllare i registri del server, lo spazio disponibile, scrivere le autorizzazioni e i processi precedenti rimanenti. Dopo aver corretto il problema, riavviare il servizio; riprende automaticamente il processo di conversione controllato. Non bypassare un database completato mancante o danneggiato eliminando i record di conversione o creando un file vuoto.

Le librerie di SQLite native sono incluse nel pacchetto web. Utilizzare il pacchetto completo per l'architettura prevista piuttosto che copiare le singole DLL. Le librerie SQL Compact sono ancora necessarie per importare database di amministrazione vecchia; un'installazione SQLite manuale separata non è destinata. Il server web richiede ancora Windows; la modifica di questo database non introduce il supporto Linux.

Mantenere il database di amministrazione su un disco locale del server web. Torna su con il servizio interrotto, inclusi i file e le chiavi dei compagni. Per tornare al software più vecchio, interrompere il servizio e ripristinare un backup coerente. Le modifiche salvate in SQLite dopo la conversione non sono presenti nel vecchio backup SQL Compact.