AppScan Presence 故障诊断
针对使用 AppScan Presence 时发现的错误的故障诊断任务。
启动错误
错误 | 原因 | 解决方案 |
---|---|---|
此 AppScan Presence 安装的另一个实例已在运行。 | AppScan Presence 的实例已在同一目录中运行。 |
|
密钥错误
创建新 Presence 时,将创建一个名为 presence.key
的唯一文件,并将其放置在下载的 ZIP
文件中。此密钥用于识别 Presence。
在大多数情况下,可以通过 AppScan on Cloud 网站生成一个新密钥并将其放置在 Presence 目录中来解决密钥问题。如果这不起作用,则创建一个新的 AppScan Presence。
错误 | 原因 | 解决方案 |
---|---|---|
Presence 密钥已到期。请更新密钥文件并将其放置在 AppScan Presence 目录中。 | AppScan Presence 密钥在一定时间后或在为此 Presence 实例创建新密钥时到期。 | 更新 Presence 密钥文件,并将其放置在 Presence 目录中,或者创建并下载新 Presence。 |
找不到 Presence 密钥。请验证密钥文件是否位于 AppScan Presence 目录中,或从“HCL AppScan on Cloud”网站下载新密钥文件。 | 在 AppScan Presence 目录中未找到 presence.key 文件。 |
更新 AppScan Presence 密钥文件,并将其放置在 AppScan Presence 目录中,或者创建并下载新 AppScan Presence。 |
Presence 密钥无效。请从“HCL AppScan on Cloud”网站下载有效密钥文件并将其放置在 AppScan Presence 目录中。 | AppScan Presence 目录中的 presence.key 文件无效。 |
更新 AppScan Presence 密钥文件,并将其放置在 AppScan Presence 目录中,或者创建并下载新 AppScan Presence。 |
Presence 已从“HCL AppScan on Cloud”网站中删除。请创建一个新的 Presence(下载并安装)。 | AppScan Presence 已删除。 | 创建并下载一个新的 AppScan Presence。 |
Presence 密钥已在使用中。请从“HCL AppScan on Cloud”网站生成一个新的密钥文件或者退出当前正在使用此密钥的 AppScan Presence 实例。 | 密钥文件一次只能由一个 AppScan Presence 实例使用。导致此错误的两个常见原因是:
|
避免在两个目录或计算机上安装 AppScan Presence 的相同实例。 如果您停止了 AppScan Presence 进程,然后又重新启动了此进程,请等待 5 分钟,然后重试。 |
连接错误
运行 AppScan Presence 的计算机必须与端口 443 上的以下地址建立连接:
cloud.appscan.com
- 系统要求中列出的 IP 地址
OutgoingProxyEndpoint
部分中的 appsettings.json
文件中配置此代理(请参阅 配置 HCL AppScan 流量记录器)。AppScan Presence 使用临时的自签名 SSL/TLS 证书。确认您公司的网关不会干扰 SSL/TLS 连接,从而阻止其连接到服务器。
错误 | 原因 | 解决方案 |
---|---|---|
未能连接到内部代理 (<host:port>),具有以下错误:<error message> | AppScan Presence 无法连接到出站代理服务器。 | 验证是否在“OutgoingProxyEndpoint”部分的 appsettings.json 文件中正确配置了出站代理主机和端口。 |
无法通过出站代理服务器进行认证。请在 appsettings.json 中配置出站代理用户名和密码。 | AppScan Presence 使用位于 AppScan Presence 目录下的 appsettings.json 文件定义的出站代理进行认证失败。 | 验证是否在“OutgoingProxyEndpoint”部分的 appsettings.json 文件中正确配置了出站代理凭证。 |
连接服务器时出错。如果问题持续存在,请验证您是否具有能正常工作的因特网连接。如果需要代理,请在 inappsettings.json 中配置此代理,然后重新启动 AppScan Presence。 | AppScan Presence 无法连接到网址为 https://cloud.appscan.com 的 AppScan on Cloud 服务器 |
验证地址 cloud.appscan.com 可以从本机访问,没有被公司的防火墙阻止,并且防火墙没有干扰来自服务器的 SSL 流量。 如果需要代理,请确保在 AppScan Presence 目录的 appsettings.json 文件的“OutgoingProxyEndpoint”部分中正确配置此代理。 |
隧道启动错误
- Web 应用程序扫描:确保计算机可以访问经过测试的服务器。
错误 | 原因 | 解决方案 |
---|---|---|
未能连接到内部代理 (<host:port>),具有以下错误:<error message> | AppScan Presence 无法连接到在 appsettings.json 文件中配置的内部代理。 | 验证是否在 appsettings.json 文件的“InternalProxyEndpoint”部分中正确配置了内部代理主机和端口,并且当前计算机是否有权访问此代理服务器。 |
检查起始 URL:<starting point URL> 随后出现以下某种信息:
|
运行 Web 应用程序扫描时,AppScan Presence 会尝试访问应用程序的起始 URL,以确保计算机可以访问正在测试的网站。这些警告表明此测试失败,但是扫描仍将开始。 | 如果扫描失败,请验证运行 AppScan Presence 的计算机是否有权访问正在测试的网站。如果需要代理,请在 AppScan Presence 目录下的 appsettings.json 文件的“InternalProxyEndpoint”部分中配置此代理。 |
未能启动隧道客户机 | AppScan Presence 未能启动专用站点扫描进程。 | 请查阅 AppScan Presence 日志并联系支持中心。 |
隧道连接错误
开始扫描时,AppScan Presence 将在自身与扫描代理程序之间创建一条新“隧道”。这条隧道用于将扫描代理程序或移动测试设备连接到后端服务器。隧道需要访问系统要求中列出的 IP 地址。
隧道使用临时的自签名 SSL/TLS 证书。确认您公司的网关不会干扰 SSL/TLS 连接,从而阻止 AppScan Presence 连接到服务器。
错误 | 原因 | 解决方案 |
---|---|---|
未能连接到内部代理 | 隧道无法连接到在 appsettings.json 文件中配置的内部代理。 | 验证是否在 appsettings.json 文件的“内部代理设置”部分中正确配置了内部代理主机和端口,并且当前计算机是否有权访问此代理服务器。 |
未能连接到出站代理 | 隧道无法连接到在 appsettings.json 文件中配置的出站代理。 | 验证是否在 appsettings.json 文件的“OutgoingProxyEndpoint”部分中正确配置了出站代理主机和端口,并且当前计算机是否有权访问此代理服务器。 |
未能连接到扫描代理程序 | 隧道无法连接到远程扫描代理程序。 | 验证系统要求中列出的 IP 地址是否是开放性地址。 如果需要代理,请确保在 AppScan Presence 目录的 appsettings.json 文件的“OutgoingProxyEndpoint”部分中正确配置此代理 |
连接到扫描代理程序时遇到 SSL 错误 | 由于 Presence 与代理程序之间的 SSL 握手错误,导致与扫描代理程序的连接失败。 | 验证将本机连接到因特网的网关没有以任何方式篡改 SSL/TLS 握手。AppScan Presence 使用一组临时的自签名 SSL/TLS 证书,随每次扫描而更改,而对其进行篡改将导致连接失败。 |
其他错误
错误 | 原因 | 解决方案 |
---|---|---|
未能更新所需的组件 <component name>。请查阅 AppScan Presence 日志。 | AppScan Presence 无法下载并安装指定组件的更新。 | 确保运行 AppScan Presence 的用户帐户拥有对 AppScan Presence 目录以及系统的临时目录的写入许可权。如果问题仍然存在,请查阅 AppScan Presence 日志并联系支持中心。 |