Przejdź do treści

Zainstaluj i skonfiguruj Zeta Test Management Web

Zeta Test Management Web zapewnia dostęp przeglądarki do centralnie zarządzanych projektów testowych. Bieżąca aplikacja oparta jest na ASP.NET Core i .NET 10. Interfejs internetowy i aplikacja Windows wykorzystują te same projekty i obejmują zadania domeny w zarządzaniu testami. Lokalne funkcje systemu operacyjnego korzystają z dostosowanych do przeglądarki przepływów roboczych lub zatwierdzonego mostka lokalnego.

W celu centralnego wdrożenia produkcji należy skorzystać z pakietu IIS zetatest-web.zip. Oddzielna konfiguracja WWW EXE uruchamia lokalne demo lub instancję jednego użytkownika z Kestrel; nie jest to zamiennik zabezpieczonej instalacji IIS.

Niniejszy przewodnik obejmuje wybór wdrożeniowy, IIS i HTTPS, prawa dostępu do najmniejszych uprawnień, konfigurację, aktualizacje, weryfikację i cofnięcie.

Wybierz model wdrożeniowy i przygotować

Opcje wdrożenia

  • Lokalne demo lub instancja pojedynczego użytkownika: konfiguracja web EXE uruchamia aplikację dołączoną lokalnie przez Kestrel. Użyj go do oceny lub użytkownika systemu Windows, nie jako centralnego serwera produkcji.
  • Wdrożenie centralnego systemu IIS: ekstrakt zetatest-web.zip na serwerze Windows i uruchom jego folder Website jako aplikację IIS. To udokumentowana ścieżka produkcji.
  • Proxy odwrotne: zarządzany proxy może zakończyć TLS i opublikować aplikację. Potwierdź przekazywanie, zaufane nagłówki, przekierowanie i pełną ścieżkę HTTPS.

Warunki wstępne

  • kombinację Windows Server i IIS zatwierdzoną dla zamierzonego wydania Zeta Test Management;
  • dostęp administracyjny do strony IIS, puli wniosków, wiążącego i certyfikowanego;
  • dopasowanie .NET 10 Hosting Bundle, w tym ASP.NET Core Module V2;
  • stabilna nazwa DNS i zaufany certyfikat TLS;
  • tworzenie kopii zapasowych projektu i przechowywanie bazy danych poza folderem wymiennych wersji stron internetowych;
  • dedykowana tożsamość techniczna, która obejmuje wyłącznie wymagane prawa do pliku i bazy danych.

Zdefiniuj kopię zapasową, przywróć, uaktualnij okno, właściciela rollback i reprezentatywny projekt akceptacji przed pierwszym wdrożeniem.

Zainstaluj i skonfiguruj aplikację IIS

  1. Zainstaluj IIS i .NET 10 Hosting Bundle, które pasuje do wydania. Przywróć IIS lub serwer, gdy instalator tego wymaga.
  2. Wyciągnij zetatest-web.zip do folderu z inskrypcją. Ścieżka fizyczna IIS wskaże na folder Website.
  3. Utwórz specjalną pulę aplikacji IIS z "No Managed Code", wyłączyć 32- bitowe aplikacje i przypisać zatwierdzoną tożsamość techniczną.
  4. Utwórz stronę lub aplikację IIS. Należy zachować dostarczony web.config i jego konfigurację AspNetCoreModuleV2.
  5. Dotacja odczytywać i wykonywać dostęp do folderu programu i tylko niezbędne modyfikacje dostępu do zatwierdzonego projektu, użytkownik-przechowywanie, załącznik i log folderów. Przyznaj minimalne prawa do bazy danych.
  6. Utwórz powiązanie HTTPS dla nazwy i certyfikatu DNS produkcji. HTTP powinno pozostać tylko wtedy, gdy wymagany jest celowy punkt końcowy przekierowania.
  7. Konfiguracja Config.json, appsettings.json i tylko wtedy, gdy ścieżki klienta i serwera różnią się, foldermappings.json.
  8. Uruchom pulę aplikacji i stronę. Zaloguj się przez HTTPS i zweryfikuj listę projektów, uprawnienia i jeden reprezentatywny przepływ testowy.

Ważne granice konfiguracji

Config.json zawiera klasyczne ustawienia Zeta Test Management, takie jak oddzielone średnikiem projectSearchFolderPaths. appsettings.json kontroluje zachowanie ASP.NET Core, w tym HTTPS, cookies, logowanie, język i obszar WWW:

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

Wartości te są przykładami i muszą odpowiadać topologii rozmieszczenia. Traktuj serviceApiKey i każdy inny klucz jako tajemnicę. Pliki projektu, konfiguracja, kopie zapasowe i dzienniki nie mogą być nigdy ujawniane jako statyczne pliki strony internetowej. IIS URL Rewrite nie jest warunkiem wstępnym Zeta Test Management, chyba że wymaga tego twoja własna konfiguracja przekierowania lub proxy.

Ochrona przed powtarzającymi się próbami sygnalizacji

Ochrona ta wymaga zaktualizowanej budowy serwera WWW, która zawiera ją. Sama konfiguracja nie może go dodać do starszych instalacji.

Hasło logowanie dla administracji serwerem i projektów ogranicza powtarzające się błędy na koncie i niezależnie na adres IP. Pięć nieudanych prób jest dozwolonych bez zwłoki; szósta porażka rozpoczyna dwusekundowe oczekiwanie. Kolejne niepowodzenia zwiększają go do czterech, ośmiu sekund i tak dalej, do pięciu minut. Udany znak w oczyszcza tylko licznik konta. Limity IP pozostają na miejscu, tak aby ważne konto nie mogło ich zresetować.

Podczas oczekiwania, formularz wyświetla wiadomość i zwraca HTTP 429 za pomocą Retry-After. Nawet poprawne hasło może być ponownie sprawdzone dopiero po wygaśnięciu oczekiwania. Konta nie są trwale wyłączone. Liczenia wygasają po 30 minutach bez zaakceptowanej próby; odrzucone wnioski nie przedłużają oczekiwania. Każdy IP pozwala również na co najwyżej 30 przyjętych prób na 60 sekund, przy czym po dwudziestym niepowodzeniu wzrasta opóźnienie IP. Rozważyć te wspólne limity, gdy wielu użytkowników ma jeden adres publiczny.

Konfiguracja AppSettings.LoginProtection w 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 ogranicza rezerwację do niedokończonego sprawdzania hasła. Równoczesne kontrole tego samego konta są odrzucane; rezerwacja pozostawiona przez rozbity proces jest liczona jako nieudana próba po jej wygaśnięciu. MaxEntries ogranicza przechowywane konto i wpisy IP razem. Zatrzymanie musi obejmować maksymalne opóźnienie, okno IP i okres ważności rezerwacji. Nieprawidłowe ustawienia są odrzucane. Po zmianie konfiguracji ponownie uruchom aplikację WWW.

Licznik utrzymuje się w podfolderze LoginProtection katalogu danych administracji prywatnej. AppSettings.LoginProtectionStateDirectory może to obejść z bezwzględną ścieżką poza Webroot. Wszyscy pracownicy jednej instalacji muszą mieć ten sam trwały katalog i mieć pozwolenie na modyfikację. Złożone identyfikatory to wartości pochodne, a nie jasne nazwy użytkownika tekstu lub adresy IP. Nie usuwaj tego stanu podczas aktualizacji. Jeżeli katalog danych administracyjnych znajduje się w katalogu aplikacji, skonfigurować oddzielną ścieżkę stanu trwałego przed zastąpieniem tego katalogu. Niedostępny, pełny lub uszkodzony sklep zwraca HTTP 503 zamiast pozwalać na niechronione sprawdzenie hasła; sprawdź miejsce na dysku, uprawnienia i dziennik serwera.

Utrzymywanie plików jest przeznaczone dla pracowników na tym samym serwerze. Wiele serwerów internetowych wymaga dodatkowego limitu dzielonego w zaufanej usłudze wyższego szczebla. Za odwrotnym proxy, konfiguracja hostingowa musi zapewnić prawdziwe IP klienta poprzez zaufaną ścieżkę. Arbitralne nagłówki X-Forwarded-For nie są akceptowane jako dowód tożsamości.

Ochrona ta obejmuje formularze hasła przeglądarki aplikacji. Windows- to- web one- time token handoff, wyraźnie skonfigurowane demo bez hasła i projekty bez zarządzania użytkownikiem nie uzyskują dodatkowego hasła. Klucze API i zewnętrznych dostawców tożsamości mają odrębne granice bezpieczeństwa. Throttling nie zastępuje HTTPS, silnych haseł ani chronionego dostępu do serwera.

Aktualizacja, weryfikacja i obrót wstecz

Traktuj każdą aktualizację WWW jako kontrolowaną zmianę serwera:

  1. Backup projektów, baz danych, konfiguracji strony internetowej i wymagane dzienniki. Zapis aktualnej wersji produktu i aktywnej ścieżki strony internetowej.
  2. Wyciągnij nowy zetatest-web.zip do równoległego folderu.
  3. Porównaj nową konfigurację domyślną z aktualnym środowiskiem. Połącz wymagane wartości celowo; nie kopiuj starych Config.json, appsettings.json, foldermappings*.json lub web.config na ślepo.
  4. Zatrzymaj pulę aplikacji, przełącz ścieżkę fizyczną IIS do nowego folderu Website i uruchom ponownie pulę.
  5. Weryfikacja HTTPS, logowania, listy projektów, ról, dostępu do plików i baz danych, jednego typowego testu i planowanych przestrzeni roboczych. Przegląd dziennika zdarzeń Windows i włączone dzienniki aplikacji.

W przypadku cofania, zatrzymaj pulę, przywróć poprzednią ścieżkę strony internetowej, a gdy wymaga tego migracja danych, odpowiednie tworzenie kopii zapasowych projektu i bazy danych. Zachować poprzedni folder wydania do czasu zakończenia uzgodnionego okresu akceptacji.

Regularne obszary internetowe są domyślnie włączone w wersji 6. Historycznie nazywane ustawienie ExperimentalWebAreas może wyłączyć poszczególne obszary; jego nazwa nie oznacza, że wszystkie dodatkowe miejsca pracy są funkcjami podglądu. AI wymaga oddzielnej konfiguracji i zatwierdzenia.

W przypadku przepływów roboczych przeglądarki, kontynuuj Użyj Zeta Test Management w aplikacji internetowej. Złącze i konfiguracja MCP patrz Integracje i automatyzacja.

Baza danych administracji wewnętrznej i automatyczna konwersja

Aplikacja internetowa wykorzystuje SQLite (ztm.sqlite) do uzyskiwania wewnętrznych danych administracyjnych, w tym ustawień serwerów, mapowań użytkowników oraz danych administracyjnych AI / CI. Bazy danych projektu nadal korzystają z VistaDB lub Microsoft SQL Server; ta operacja ich nie konwertuje.

Na pierwszym starcie z istniejącym ztm.sdf, usługa automatycznie konwertuje administracyjną bazę danych. Zatrzymać wszystkie starsze procesy web / backend dostępu do tego samego katalogu danych serwera najpierw. Zaplanuj okno obsługi technicznej i kopię zapasową kompletnego katalogu danych serwera, w tym konfiguracji i kluczy. Konwersja wymaga dodatkowej wolnej przestrzeni dla kopii zapasowej i nowej bazy danych.

Usługa backup istniejący plik, kopiuje i weryfikuje dane, a dopiero potem aktywuje SQLite. Nie akceptuje normalnych wniosków, dopóki nie uda się to osiągnąć. Źródło SQL Compact jest chronione przed dalszymi pisami; nie usuwaj tej ochrony podczas pracy. Zachowaj ztm.sdf, ztm.sdf.pre-sqlite.bak i zapis aktywacji ztm.sqlite.activation z bazą danych SQLite. Katalog skonfigurowany przez alternativeServerCentralDataStorageFolderPath musi istnieć i być zapisywalny; awaria nie wraca do pustej bazy danych w innym katalogu.

Jeśli przemiana się nie powiedzie, startup pozostaje zablokowany. Sprawdź dzienniki serwerów, dostępną przestrzeń, pisz uprawnienia i pozostałe procesy starsze. Po skorygowaniu problemu, ponownie uruchom usługę; automatycznie wznawia kontrolowany proces konwersji. Nie pomijaj brakującej lub uszkodzonej bazy danych poprzez usunięcie rekordów konwersji lub utworzenie pustego pliku.

Biblioteki Native SQLite są zawarte w pakiecie internetowym. Użyj kompletnego pakietu dla zamierzonej architektury zamiast kopiowania indywidualnych DLL. Biblioteki SQL Compact są nadal wymagane do importowania starszych baz danych administracyjnych; nie jest przeznaczona oddzielna instalacja ręczna SQLite. Serwer WWW nadal wymaga systemu Windows; zmiana tej bazy danych nie wprowadza wsparcia Linuksa.

Przechowywanie bazy danych administracji na lokalnym dysku serwera WWW. Back it up with the service stopped, including command files and keys. Aby powrócić do starszego oprogramowania, zatrzymać usługę i przywrócić spójne kopie zapasowe. Zmiany zapisane w SQLite po konwersji nie są obecne w starej kopii zapasowej SQL Compact.