安装和配置 Zeta Test Management 网页¶
Zeta Test Management Web提供浏览器访问中央管理的测试项目. 目前应用基于ASP.NET Core和.NET 10. 网页界面和Windows应用程序使用相同的项目,并覆盖测试管理中的域任务. 本地操作系统功能使用浏览器调整后的工作流程或经批准的本地桥.
为中央生产部署,使用国际信息系统软件包 zetatest-web.zip. 单独的web EXE设置开始一个本地演示或与 Kestrel 的单一用户实例;它不是安全 IIS 安装的替代.
本指南涵盖部署选择,IIS和HTTPS,最小优先权限,配置,更新,验证和回滚.
选择部署模式并准备¶
部署备选方案¶
- 本地演示或单一用户实例 : 网络 EXE 设置通过 Kestrel 本地启动捆绑的应用程序 。 用于评价或单个Windows用户,而不是作为中央制作服务器.
- 中央国际情报处部署: 提取
zetatest-web.zip在 Windows 服务器上运行Website文件夹作为 IIS 应用程序。 这是有文件记载的制作路径. - 反转代理 : 管理中的代理可以终止 TLS 并发布应用程序。 验证转发,信任信头,重定向和完整的HTTPS路径.
先决条件¶
- a 已核准用于预定的Windows服务器和IS组合 Zeta Test Management 释放;
- 行政访问IIS网站、应用程序库、装订和证书;
- a. 匹配的.NET 10主机包,包括ASP.NET核心模块V2;
- 稳定的 DNS 名称和信任的 TLS 证书;
- 在可替换的网站发布文件夹外备份项目和数据库存储;
- 专门技术身份,仅具有所需的文件和数据库权利。
在第一次部署前定义备份,恢复,更新窗口,回滚所有者和代表性验收项目.
安装和配置 IIS 应用程序¶
- 安装 IIS 和 .NET 10 主机套装,与发行匹配 。 安装者需要时重新启动 IIS 或服务器.
- 摘录
zetatest-web.zip进入一个中转文件夹。 IIS 物理路径将指向包含的Website文件夹。 - 创建一个带有“无管理代码”的专用 IIS 应用程序池,禁用32位应用程序,并指定已核准的技术身份。
- 创建 IIS 站点或应用程序 。 保持供给
web.config财务报告和已审计财务报表AspNetCoreModuleV2配置。 - Grant读取并执行程序文件夹的访问权限,并且仅对已核准的项目,用户存储,附件和日志文件夹进行必要的修改访问. 授予数据库最低权利。
- 创建用于生产 DNS 名称和证书的 HTTPS 绑定 。 只有在需要有意改变方向的终点时,才应继续使用高技术方案。
- 配置
Config.json,appsettings.json只有在客户端和服务器路径不同时,foldermappings.json. - 启动应用程序池和网站。 在 HTTPS 上签名, 并验证项目列表、 权限和一个有代表性的测试工作流程 。
重要配置边界¶
Config.json 包含经典 Zeta Test Management 诸如分号分隔的设置 projectSearchFolderPaths. appsettings.json 控制 ASP.NET 核心行为,包括 HTTPS, cookie, 日志, 语言和网络区域控制 :
{
"AppSettings": {
"UseHttpsRedirection": true,
"AllowInsecureCookies": false,
"ExperimentalWebAreas": {
"Enabled": true,
"DisabledAreas": []
}
}
}
这些值是实例,必须与部署地形相符。 处理 serviceApiKey 和所有其它的钥匙 作为一个秘密。 项目文件,配置,备份和日志绝不能作为静态网站文件曝光. IIS URL 重写不是 Zeta Test Management 除非您自己的重定向或代理配置需要它。
防止重复的签名企图¶
这种保护需要更新的网络服务器构建,包括它. 仅凭配置无法添加到旧的安装中 。
用于服务器管理和项目的密码签入限制每个账户和每个IP地址的独立重复失败. 五次失败的尝试是允许的,不得拖延;第六次失败开始两秒钟的等待. 进一步的失败将它增加到4,8秒等,最长可达5分钟. 成功登录只清除账号计数器 。 IP限制仍然有效,所以一个有效的账户无法重置它们.
等待时,表单显示信件并返回 HTTP 429 与 Retry-After。 。 。 。 甚至正确的密码只能在等待期满后再次检查. 账户不是永久禁用。 柜台在30分钟后失效,没有经过承认的尝试;被拒绝的请求不会延长等待时间. 每个IP也允许每60秒最多30次被承认的尝试,20次失败后IP的延迟会增加. 当许多用户共享一个公共地址时,考虑这些共享限制.
配置 AppSettings.LoginProtection 输入 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 限制对未完成密码检查的保留。 同一账户同时进行的检查被拒绝;一个崩溃过程留下的保留在到期后被算作失败尝试. MaxEntries 将存储的账户和IP条目限制在一起。 保留必须涵盖最大延迟、IP窗口和保留寿命。 无效的设置被拒绝 。 更改配置后重新启动网络应用程序 。
柜台上一直有 LoginProtection 私有管理数据目录的子文件夹。 AppSettings.LoginProtectionStateDirectory 可以在网根顶外设置绝对路径来覆盖它。 一个装置的所有工人必须共享相同的耐用目录并获得修改许可. 存储的标识符是衍生值,而不是清晰的文本用户名或IP地址. 更新时不要删除此状态 。 如果管理数据目录位于应用程序目录内,则在替换该目录前配置单独的持久状态路径. 一个不可用,完整或损坏的商店返回HTTP 503,而不是允许进行无保护的密码检查;检查磁盘空间,权限和服务器日志.
文件持久性用于同一服务器上的工人。 多个网络服务器需要在可信赖的上游服务中增加一个共享限制. 在反向代理背后,主机配置必须通过可信任的路径提供真正的客户端IP. 任意 X-Forwarded-For 信头不被接受为身份证明.
这个保护覆盖了应用程序的浏览器密码表. Windows to-web 一次性代码交接,一个明确配置的无密码演示,没有用户管理的项目不会获得额外的密码提示. API密钥和外部身份提供商有单独的安全边界. Throttling不取代HTTPS,强密码或受保护的服务器访问.
更新、核实和滚回¶
将每个网页更新作为可控服务器更改 :
- 备份项目,数据库,网站配置和所需的日志. 记录当前产品版本和活跃的网站路径.
- 提取新
zetatest-web.zip输入一个并行的释放文件夹。 - 将新的默认配置与当前环境进行比较。 有意合并所需值; 不复制旧的
Config.json,appsettings.json,foldermappings*.json或 减 减web.config盲目地说. - 停止应用程序池, 将 IIS 物理路径切换为新路径
Website文件夹,然后重新启动池。 - 校验 HTTPS, 签入, 项目列表, 角色, 文件和数据库访问, 一个典型的测试运行和预定的网络工作空间 。 审查Windows事件日志并启用应用程序日志.
对于回滚,停止集合,恢复之前的网站路径,当数据迁移需要时,相应的项目和数据库备份. 保留上一个发布文件夹,直到商定的接受期结束.
正常的网页区域默认在版本6中启用. 历史名称 ExperimentalWebAreas 设置可以禁用单个区域;其名称并不意味着所有新增的工作空间都是预览功能。 AI需要单独的配置和批准.
对于浏览器工作流程,请继续 在网络应用程序中使用 Zeta 测试管理。 。 。 。 关于连接器和MCP设置,参见 一体化和自动化.
内部行政数据库和自动转换¶
网络应用程序使用 SQLite(ztm.sqlite用于其内部管理数据,包括服务器设置,用户映射和AI/CI管理数据. 项目数据库继续使用VistaDB或Microsoft SQL Server;此操作不转换它们.
第一个开头是已有的 ztm.sdf中,服务自动转换管理数据库。 停止所有较旧的网页/后端进程先访问同一服务器数据目录. 计划一个维护窗口,并备份完整的服务器数据目录,包括配置和密钥. 转换需要为备份和新数据库增加空闲空间。
服务备份已有文件,复制并验证数据,然后才激活SQLite. 在成功之前,它不接受正常要求。 SQL Compact 源代码被保护, 不被进一步写入; 在操作中不要移除此保护 。 保留 ztm.sdf, ztm.sdf.pre-sqlite.bak 和激活记录 ztm.sqlite.activation 与 SQLite 数据库。 配置目录通过 alternativeServerCentralDataStorageFolderPath 必须存在且可写; 失败不会回到另一个目录中的空数据库。
如果转换失败, 启动仍然被阻断 。 检查服务器日志,可用空间,写入权限和剩余旧进程. 纠正问题后,重新启动服务;它自动恢复控制下的转换过程. 切勿通过删除转换记录或创建空文件来绕过缺失或损坏的已完成的数据库 。
原生的SQLite库包含在网络包中. 将完整包用于预期架构,而不是复制单个的DLL. SQL Compact 库仍需要导入旧的行政数据库;没有计划单独安装一个手动的SQLite. 网页服务器仍然需要Windows;修改此数据库不会引入Linux支持.
将管理数据库保存在网络服务器的本地磁盘上. 后退与服务停止,包括同伴文件和密钥. 为了回归旧软件,停止服务并恢复一致的备份. 在转换后保存的 SQLite 中的更改在旧的 SQL 压缩备份中不存在.