Aller au contenu

Installer et configurer Zeta Test Management Web

Zeta Test Management Web fournit un accès par navigateur à des projets de test gérés centralement. L'application actuelle est basée sur ASP.NET Core et .NET 10. L'interface web et l'application Windows utilisent les mêmes projets et couvrent les tâches de domaine dans la gestion des tests. Les fonctions du système d'exploitation local utilisent des workflows adaptés au navigateur ou un pont local approuvé.

Pour un déploiement de production central, utilisez le paquet IIS zetatest-web.zip. La configuration web EXE séparée démarre une instance locale de démonstration ou un utilisateur unique avec Kestrel; ce n'est pas un remplacement pour une installation IIS sécurisée.

Ce guide couvre le choix du déploiement, IIS et HTTPS, les permissions les moins privilèges, la configuration, les mises à jour, la vérification et le retour.

Choisir le modèle de déploiement et préparer

Options de déploiement

  • Démo locale ou instance à un seul utilisateur : la configuration web EXE démarre l'application groupée localement par Kestrel. Utilisez-le pour l'évaluation ou un utilisateur de Windows, pas comme serveur de production central.
  • Déploiement de l'ISI central : extrait zetatest-web.zip sur un serveur Windows et exécute son dossier Website en tant qu'application IIS. C'est la voie de production documentée.
  • Proxy inversé & #160;: un proxy géré peut mettre fin à TLS et publier l'application. Valider l'envoi, les en-têtes de confiance, les redirections et le chemin HTTPS complet.

Préalables

  • une combinaison Windows Server et IIS approuvée pour la version Zeta Test Management prévue;
  • l'accès administratif au site de l'IIS, au pool de demandes, à la liaison et au certificat;
  • le bloc d'hébergement .NET 10 correspondant, y compris le module de base ASP.NET V2;
  • un nom DNS stable et un certificat TLS de confiance;
  • le stockage des projets et des bases de données sauvegardés en dehors du dossier de publication du site Web remplaçable;
  • une identité technique spécifique avec uniquement les droits de fichier et de base de données requis.

Définir la sauvegarde, restaurer, mettre à jour la fenêtre, le propriétaire de rrollback et un projet d'acceptation représentatif avant le premier déploiement.

Installer et configurer l'application IIS

  1. Installez IIS et le bloc d'hébergement .NET 10 qui correspond à la version. Redémarrer IIS ou le serveur lorsque l'installateur l'exige.
  2. Extraire zetatest-web.zip dans un dossier de mise en scène. Le chemin physique IIS pointera vers le dossier Website contenu.
  3. Créez un pool d'applications IIS dédié avec -No Managed Code, désactivez les applications 32 bits et assignez l'identité technique approuvée.
  4. Créer le site ou l'application IIS. Conserver le web.config fourni et sa configuration AspNetCoreModuleV2.
  5. Accorder l'accès au dossier du programme et le modifier uniquement pour l'accès au projet approuvé, au stockage utilisateur, à la pièce jointe et aux dossiers journaux. Accorder des droits minimaux sur les bases de données.
  6. Créez la liaison HTTPS pour le nom et le certificat DNS de production. HTTP ne devrait rester que lorsqu'un paramètre de redirection intentionnel est nécessaire.
  7. Configurez Config.json, appsettings.json et, seulement lorsque les chemins client et serveur diffèrent, foldermappings.json.
  8. Démarrez le pool d'applications et le site. Connectez-vous sur HTTPS et vérifiez la liste des projets, les autorisations et un workflow de test représentatif.

Limites de configuration importantes

Config.json contient des paramètres Zeta Test Management classiques tels que projectSearchFolderPaths séparé par un point-virgule. appsettings.json contrôle le comportement de base ASP.NET, y compris HTTPS, les cookies, l'enregistrement, la langue et les contrôles de zone web:

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

Ces valeurs sont des exemples et doivent correspondre à la topologie du déploiement. Traitez serviceApiKey et toutes les autres clés comme un secret. Les fichiers de projet, la configuration, les sauvegardes et les journaux ne doivent jamais être exposés comme des fichiers statiques du site Web. La réécriture d'URL IIS n'est pas une condition préalable Zeta Test Management à moins que votre propre redirection ou configuration proxy ne l'exige.

Protection contre les tentatives répétées d ' identification

Cette protection nécessite une mise à jour du serveur web qui l'inclut. La configuration ne peut à elle seule l'ajouter aux anciennes installations.

L'inscription du mot de passe pour l'administration du serveur et les projets limite les défaillances répétées par compte et indépendamment par adresse IP. Cinq tentatives ratées sont autorisées sans délai; la sixième échoue commence une attente de deux secondes. D'autres échecs l'augmentent à quatre, huit secondes et ainsi de suite, jusqu'à cinq minutes. La réussite de l'inscription ne permet d'obtenir que le compteur de compte. Des limites IP restent en place afin qu'un compte valide ne puisse pas les réinitialiser.

Pendant une attente, le formulaire affiche un message et retourne HTTP 429 avec Retry-After. Même un mot de passe correct ne peut être vérifié à nouveau qu'après l'expiration de l'attente. Les comptes ne sont pas désactivés de façon permanente. Les compteurs expirent après 30 minutes sans tentative admise; les demandes rejetées ne prolongent pas l'attente. Chaque PI permet également au plus 30 tentatives admises par 60 secondes, avec des retards de PI croissants après le vingtième échec. Considérez ces limites partagées lorsque de nombreux utilisateurs partagent une seule adresse publique.

Configurez AppSettings.LoginProtection dans 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 limite la réservation pour une vérification de mot de passe inachevée. Les vérifications simultanées du même compte sont rejetées; une réservation laissée par un processus écrasé est comptée comme une tentative ratée après son expiration. MaxEntries limite les entrées de compte et d'IP stockées ensemble. La conservation doit couvrir le délai maximal, la fenêtre IP et la durée de vie de la réservation. Les paramètres non valides sont rejetés. Redémarrez l'application web après avoir changé de configuration.

Les compteurs persistent dans le sous-dossier LoginProtection du répertoire de données de l'administration privée. AppSettings.LoginProtectionStateDirectory peut surcharger cela avec un chemin absolu en dehors du webroot. Tous les travailleurs d'une installation doivent partager le même répertoire durable et avoir une autorisation de modification. Les identifiants stockés sont des valeurs dérivées, et non des noms d'utilisateur ou des adresses IP clairs. Ne pas supprimer cet état lors des mises à jour. Si le répertoire de données d'administration se trouve à l'intérieur du répertoire d'application, configurez un chemin d'état durable séparé avant de remplacer ce répertoire. Une boutique indisponible, pleine ou corrompue retourne HTTP 503 plutôt que de permettre une vérification non protégée du mot de passe; vérifiez l'espace disque, les permissions et le journal du serveur.

La persistance du fichier est destinée aux travailleurs sur le même serveur. Plusieurs serveurs Web nécessitent une limite partagée supplémentaire à un service en amont de confiance. Derrière un proxy inversé, la configuration d'hébergement doit fournir l'IP réel du client via un chemin de confiance. Les en-têtes arbitraires X-Forwarded-For ne sont pas acceptés comme preuve d'identité.

Cette protection couvre les formulaires de mot de passe du navigateur de l'application. Une démo et des projets sans mot de passe explicitement configurés sans la gestion de l'utilisateur n'ont pas d'invite de mot de passe supplémentaire. Les clés API et les fournisseurs d'identité externes ont des frontières de sécurité distinctes. Le throttling ne remplace pas HTTPS, les mots de passe forts ou l'accès protégé au serveur.

Mettre à jour, vérifier et revenir en arrière

Traiter chaque mise à jour Web comme un changement de serveur contrôlé:

  1. Sauvegarder les projets, les bases de données, la configuration du site Web et les journaux requis. Enregistrez la version actuelle du produit et le chemin actif du site Web.
  2. Extraire le nouveau zetatest-web.zip dans un dossier de publication parallèle.
  3. Comparer la nouvelle configuration par défaut avec l'environnement actuel. Fusionner délibérément les valeurs requises; ne pas copier les anciens Config.json, appsettings.json, foldermappings*.json ou web.config aveuglément.
  4. Arrêtez le pool d'applications, changez le chemin physique IIS vers le nouveau dossier Website et redémarrez le pool.
  5. Vérifier HTTPS, connexion, liste de projets, rôles, accès aux fichiers et aux bases de données, un essai typique et les espaces de travail Web prévus. Examinez le journal des événements de Windows et activez les journaux d'application.

Pour le retour en arrière, arrêtez le pool, restaurez le chemin précédent du site Web et, lorsqu'une migration de données l'exige, la sauvegarde du projet et de la base de données correspondante. Conserver le dossier de publication précédent jusqu'à ce que la période d'acceptation convenue soit terminée.

Les zones web régulières sont activées par défaut dans la version 6. Le paramètre historiquement nommé ExperimentalWebAreas peut désactiver des zones individuelles ; son nom n'implique pas que tous les espaces de travail supplémentaires sont des fonctionnalités d'aperçu. L'IA nécessite une configuration et une approbation distinctes.

Pour les workflows de navigateur, continuez avec Utiliser Zeta Test Management dans l'application web. Pour la configuration du connecteur et du MCP, voir Intégrations et automatisation.

Base de données sur l'administration interne et conversion automatique

L'application Web utilise SQLite (ztm.sqlite) pour ses données d'administration interne, y compris les paramètres du serveur, les mappages utilisateurs et les données d'administration AI/CI. Les bases de données de projets continuent d'utiliser VistaDB ou Microsoft SQL Server ; cette opération ne les convertit pas.

Au premier démarrage avec un ztm.sdf existant, le service convertit automatiquement la base de données d'administration. Arrêtez tous les anciens processus web/backend qui accèdent d'abord au même répertoire de données du serveur. Planifiez une fenêtre de maintenance et sauvegardez le répertoire complet des données du serveur, y compris la configuration et les clés. La conversion nécessite un espace libre supplémentaire pour la sauvegarde et la nouvelle base de données.

Le service sauvegarde le fichier existant, copie et vérifie les données, et seulement ensuite active SQLite. Il n'accepte pas les demandes normales tant que cela n'a pas abouti. La source SQL Compact est protégée contre d'autres écritures ; ne supprimez pas cette protection pendant le fonctionnement. Gardez ztm.sdf, ztm.sdf.pre-sqlite.bak et l'enregistrement d'activation ztm.sqlite.activation avec la base de données SQLite. Le répertoire configuré par alternativeServerCentralDataStorageFolderPath doit exister et être enregistrable; un échec ne revient pas à une base de données vide dans un autre répertoire.

Si la conversion échoue, le démarrage reste bloqué. Vérifiez les journaux de serveur, l'espace disponible, les permissions d'écriture et les processus anciens restants. Après avoir corrigé le problème, redémarrez le service ; il reprend automatiquement le processus de conversion contrôlé. Ne contournez pas une base de données manquante ou endommagée en supprimant les enregistrements de conversion ou en créant un fichier vide.

Les bibliothèques SQLite natives sont incluses dans le paquet web. Utilisez le paquet complet pour l'architecture prévue plutôt que de copier les DLL individuelles. Les bibliothèques SQL Compact sont toujours tenues d'importer des bases de données d'administration plus anciennes; une installation SQLite manuelle séparée n'est pas prévue. Le serveur web nécessite toujours Windows ; modifier cette base de données n'introduise pas le support Linux.

Conservez la base de données d'administration sur un disque local du serveur Web. Sauvegardez-le avec le service arrêté, y compris les fichiers et les clés d'accompagnement. Pour revenir à l'ancien logiciel, arrêtez le service et restaurez une sauvegarde cohérente. Les modifications enregistrées dans SQLite après conversion ne sont pas présentes dans l'ancienne sauvegarde SQL Compact.