AppScan Presence 故障诊断

针对使用 AppScan Presence 时发现的错误的故障诊断任务。

启动错误

错误 原因 解决方案
此 AppScan Presence 安装的另一个实例已在运行。 AppScan Presence 的实例已在同一目录中运行。
  • Windows：打开任务管理器，然后查找运行 Presence.exe 的进程。
  • Linux：在命令行中输入 ps aux，然后查找名为 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 进程在最后几分钟被中止，并且服务器错误地认为 Presence 仍然在线。
 避免在两个目录或计算机上安装 AppScan Presence 的相同实例。

如果您停止了 AppScan Presence 进程，然后又重新启动了此进程，请等待 5 分钟，然后重试。

连接错误

运行 AppScan Presence 的计算机必须与端口 443 上的以下地址建立连接：如果需要代理以访问这些地址，请确保在位于 AppScan Presence 目录的 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>
随后出现以下某种信息：
  • 警告：已收到无效的 HTTP 响应
  • 警告：已收到 HTTP 响应状态：<HTTP error status>
  • 警告：失败并出现以下错误：<error message>
 运行 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 日志并联系支持中心。