Saltar a contenido

Instalar y configurar Zeta Test Management Web

Zeta Test Management Web proporciona acceso desde el navegador a proyectos de prueba gestionados centralmente. La aplicación actual se basa en ASP.NET Core y .NET 10. La interfaz web y la aplicación Windows usan los mismos proyectos y cubren las tareas del dominio en la gestión de pruebas. Las funciones locales del sistema operativo usan flujos de trabajo adaptados al navegador o un Local Bridge aprobado.

Para una implementación central de producción, use el paquete IIS zetatest-web.zip. La configuración separada del EXE web inicia una demo local o instancia de usuario único con Kestrel; no es un reemplazo para una instalación segura de IIS.

Esta guía cubre la elección de despliegue, IIS y HTTPS, permisos de mínimo privilegio, configuración, actualizaciones, verificación y reversión.

Elija el modelo de despliegue y prepare

Opciones de despliegue

  • Demostración local o instancia de usuario único: la instalación EXE web inicia la aplicación empaquetada localmente a través de Kestrel. Úsela para evaluación o un usuario Windows individual, no como servidor central de producción.
  • Despliegue central IIS: extraiga zetatest-web.zip en un Windows Server y ejecute su carpeta Website como una aplicación IIS. Este es el camino documentado para producción.
  • Proxy inverso: un proxy gestionado puede terminar TLS y publicar la aplicación. Valide el reenvío, encabezados confiables, redirecciones y la ruta HTTPS completa.

Prerrequisitos

  • una combinación de Windows Server e IIS aprobada para la versión prevista de Zeta Test Management;
  • acceso administrativo para el sitio IIS, grupo de aplicaciones, enlace y certificado;
  • el Hosting Bundle .NET 10 correspondiente, incluyendo ASP.NET Core Module V2;
  • un nombre DNS estable y certificado TLS confiable;
  • almacenamiento de proyecto y base de datos respaldados fuera de la carpeta reemplazable de la versión del sitio web;
  • una identidad técnica dedicada con solo los derechos de archivo y base de datos requeridos.

Defina respaldo, restauración, ventana de actualización, propietario de reversión y un proyecto representativo de aceptación antes del primer despliegue.

Instalar y configurar la aplicación IIS

  1. Instale IIS y el .NET 10 Hosting Bundle que coincida con la versión. Reinicie IIS o el servidor cuando el instalador lo requiera.
  2. Extraer zetatest-web.zip en una carpeta de preparación. La ruta física IIS apuntará a la carpeta Website contenida.
  3. Cree un grupo de aplicaciones IIS dedicado con “No Managed Code”, desactive aplicaciones de 32 bits y asigne la identidad técnica aprobada.
  4. Crear el sitio o aplicación IIS. Mantenga el web.config suministrado y su configuración AspNetCoreModuleV2.
  5. Conceda acceso de lectura y ejecución a la carpeta del programa y solo el acceso de modificación necesario a las carpetas aprobadas de proyecto, almacenamiento de usuario, archivo adjunto y registros. Conceda derechos mínimos en la base de datos.
  6. Cree el enlace HTTPS para el nombre DNS de producción y certificado. HTTP debe permanecer solo cuando se requiera un punto de redirección intencional.
  7. Configurar Config.json, appsettings.json y, solo cuando las rutas del cliente y servidor difieran, foldermappings.json.
  8. Inicie el grupo de aplicaciones y el sitio. Inicie sesión mediante HTTPS y verifique la lista de proyectos, permisos y un flujo de trabajo de prueba representativo.

Límites importantes de configuración

Config.json contiene configuraciones clásicas de Zeta Test Management como projectSearchFolderPaths separados por punto y coma. appsettings.json controla el comportamiento de ASP.NET Core incluyendo HTTPS, cookies, registro, idioma y controles del área web:

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

Estos valores son ejemplos y deben coincidir con la topología de despliegue. Trate serviceApiKey y cualquier otra clave como un secreto. Los archivos del proyecto, configuración, copias de seguridad y registros nunca deben exponerse como archivos estáticos de sitio web. IIS URL Rewrite no es un requisito previo de Zeta Test Management a menos que su propia configuración de redirección o proxy lo requiera.

Protección contra intentos repetidos de inicio de sesión

Esta protección requiere una versión actualizada del servidor web que la incluya. Solo la configuración no puede añadirla a instalaciones antiguas.

El inicio de sesión con contraseña para administración del servidor y proyectos limita fallos repetidos por cuenta e independientemente por dirección IP. Se permiten cinco intentos fallidos sin demora; el sexto fallo inicia una espera de dos segundos. Fallos adicionales la aumentan a cuatro, ocho segundos y así sucesivamente, hasta cinco minutos. Un inicio de sesión exitoso solo borra el contador de la cuenta. Los límites de IP permanecen para que una cuenta válida no pueda restablecerlos.

Durante una espera, el formulario muestra un mensaje y devuelve HTTP 429 con Retry-After. Incluso una contraseña correcta solo puede verificarse nuevamente después de que expire la espera. Las cuentas no se deshabilitan permanentemente. Los contadores expiran después de 30 minutos sin un intento admitido; las solicitudes rechazadas no extienden la espera. Cada IP también permite como máximo 30 intentos admitidos por 60 segundos, con retrasos crecientes tras el vigésimo fallo. Considere estos límites compartidos cuando muchos usuarios comparten una dirección pública.

Configurar AppSettings.LoginProtection en 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 reserva para una comprobación de contraseña no terminada. Se rechazan comprobaciones concurrentes de la misma cuenta; una reserva dejada por un proceso caído se cuenta como intento fallido tras expirar. MaxEntries limita las entradas almacenadas de cuenta e IP juntas. La retención debe cubrir el retraso máximo, ventana IP y duración de la reserva. Se rechazan configuraciones inválidas. Reinicie la aplicación web tras cambiar la configuración.

Los contadores persisten en la subcarpeta LoginProtection del directorio privado de datos de administración. AppSettings.LoginProtectionStateDirectory puede sobrescribir esto con una ruta absoluta fuera del webroot. Todos los trabajadores de una instalación deben compartir el mismo directorio duradero y tener permiso de modificación. Los identificadores almacenados son valores derivados, no nombres de usuario o direcciones IP en texto claro. No elimine este estado durante las actualizaciones. Si el directorio de datos de administración está dentro del directorio de la aplicación, configure una ruta de estado duradera separada antes de reemplazar ese directorio. Un almacén no disponible, lleno o corrupto devuelve HTTP 503 en lugar de permitir una comprobación de contraseña sin protección; verifique espacio en disco, permisos y el registro del servidor.

La persistencia de archivos está destinada a trabajadores en el mismo servidor. Múltiples servidores web requieren un límite compartido adicional en un servicio ascendente confiable. Detrás de un proxy inverso, la configuración de alojamiento debe proporcionar la IP real del cliente a través de una ruta confiable. No se aceptan encabezados arbitrarios X-Forwarded-For como prueba de identidad.

Esta protección cubre los formularios de contraseña del navegador de la aplicación. La transferencia de token único de Windows a web, una demostración sin contraseña configurada explícitamente y proyectos sin gestión de usuarios no requieren un aviso adicional de contraseña. Las claves API y proveedores externos de identidad tienen límites de seguridad separados. La limitación no reemplaza HTTPS, contraseñas fuertes ni acceso protegido al servidor.

Actualizar, verificar y revertir

Considere cada actualización web como un cambio controlado del servidor:

  1. Haga una copia de seguridad de proyectos, bases de datos, configuración del sitio web y registros requeridos. Registre la versión actual del producto y la ruta activa del sitio web.
  2. Extraer el nuevo zetatest-web.zip en una carpeta de liberación paralela.
  3. Compare la nueva configuración predeterminada con el entorno actual. Combine deliberadamente los valores requeridos; no copie ciegamente valores antiguos Config.json, appsettings.json, foldermappings*.json o web.config.
  4. Detenga el grupo de aplicaciones, cambie la ruta física de IIS a la nueva carpeta Website y reinicie el grupo.
  5. Verifique HTTPS, inicio de sesión, lista de proyectos, roles, acceso a archivos y base de datos, una ejecución típica de prueba y los espacios de trabajo web previstos. Revise el registro de eventos de Windows y los registros de aplicación habilitados.

Para revertir, detenga el grupo, restaure la ruta anterior del sitio web y, cuando una migración de datos lo requiera, la copia de seguridad correspondiente del proyecto y la base de datos. Mantenga la carpeta de la versión anterior hasta que finalice el período de aceptación acordado.

Las áreas web regulares están habilitadas por defecto en la versión 6. La configuración históricamente llamada ExperimentalWebAreas puede deshabilitar áreas individuales; su nombre no implica que todos los espacios de trabajo adicionales sean funciones en vista previa. La IA requiere configuración y aprobación separadas.

Para flujos de trabajo en navegador, continúe con Utilice Zeta Test Management en la aplicación web. Para la configuración del conector y MCP, vea Integraciones y automatización.

Base de datos interna de administración y conversión automática interna

La aplicación web usa SQLite (ztm.sqlite) para sus datos internos de administración, incluyendo configuraciones del servidor, asignaciones de usuarios y datos de administración AI/CI. Las bases de datos de proyectos continúan usando VistaDB o Microsoft SQL Server; esta operación no las convierte.

En el primer inicio con un ztm.sdf existente, el servicio convierte automáticamente la base de datos de administración. Primero detenga todos los procesos web/backend antiguos que accedan al mismo directorio de datos del servidor. Programe una ventana de mantenimiento y haga una copia de seguridad completa del directorio de datos del servidor, incluyendo configuración y claves. La conversión requiere espacio libre adicional para la copia de seguridad y la nueva base de datos.

El servicio realiza una copia de seguridad del archivo existente, copia y verifica los datos, y solo entonces activa SQLite. No acepta solicitudes normales hasta que esto tenga éxito. La fuente SQL Compact está protegida contra más escrituras; no elimine esta protección durante la operación. Mantenga ztm.sdf, ztm.sdf.pre-sqlite.bak y el registro de activación ztm.sqlite.activation con la base de datos SQLite. El directorio configurado mediante alternativeServerCentralDataStorageFolderPath debe existir y ser escribible; un fallo no recurre a una base de datos vacía en otro directorio.

Si la conversión falla, el inicio permanece bloqueado. Verifique los registros del servidor, el espacio disponible, los permisos de escritura y los procesos antiguos restantes. Después de corregir el problema, reinicie el servicio; este reanudará automáticamente el proceso de conversión controlada. No omita una base de datos completada faltante o dañada eliminando registros de conversión o creando un archivo vacío.

Las bibliotecas nativas de SQLite están incluidas en el paquete web. Utilice el paquete completo para la arquitectura prevista en lugar de copiar DLL individuales. Las bibliotecas SQL Compact siguen siendo necesarias para importar bases de datos de administración antiguas; no se contempla una instalación manual separada de SQLite. El servidor web sigue requiriendo Windows; cambiar esta base de datos no introduce soporte para Linux.

Mantenga la base de datos de administración en un disco local del servidor web. Realice copias de seguridad con el servicio detenido, incluyendo archivos y claves complementarias. Para volver a versiones anteriores del software, detenga el servicio y restaure una copia de seguridad consistente. Los cambios guardados en SQLite después de la conversión no están presentes en la copia de seguridad antigua de SQL Compact.