AppScan Presence 故障诊断

针对在 AppScan 360° 环境中使用 AppScan Presence 时所发现错误的故障诊断任务

启动错误

错误 原因 解决方案
AppScan Presence 安装的另一个实例已在运行。 AppScan Presence 的实例已在同一目录中运行。
  • Windows:打开任务管理器,然后查找运行 Presence.exe 的进程。
  • Linux:在命令行中输入 ps aux,然后查找名为 Presence 的进程。

密钥错误

当您在 AppScan 360° 中创建新 Presence 时,系统将生成一个名为 presence.key 的唯一文件,并将其包含在所下载的 ZIP 文件中。此密钥用于向您的本地 AppScan 360° 实例标识该 Presence。

在大多数情况下,可以通过 AppScan 360° Web 控制台生成一个新密钥并将其放置在 Presence 目录中来解决密钥问题。

错误 原因 解决方案
Presence 密钥已到期。 该密钥已达到其有效期限,或者为此实例生成了新密钥。 通过 AppScan 360° 控制台更新 Presence 密钥文件并将其放入目录中。
找不到 Presence 密钥。 目录中缺少 presence.key 文件。 AppScan 360° 服务器下载该密钥并将其放置在 Presence 文件夹中。
Presence 密钥无效。 presence.key 文件已损坏或属于不同的 AppScan 360° 环境。 AppScan 360° 网站生成并下载有效的密钥文件。
Presence 已删除。 已从 AppScan 360° 控制台中删除 Presence 条目。 创建并下载一个新的 AppScan Presence。
Presence 密钥已在使用中。 密钥文件一次只能由一个实例使用。 确保 Presence 未在其他地方运行。如果进程已中止,请等待 5 分钟,直到 AppScan 360° 服务器发送超时心跳信号后再进行重新启动。

连接错误

运行 AppScan Presence 的计算机必须能够通过端口 443(或您所配置的定制端口)与您的 AppScan 360° 服务器 URL(例如,https://appscan360.yourdomain.com)建立稳定的连接。

如果需要代理才能访问 AppScan 360° 服务器,请在 appsettings.json 文件的 OutgoingProxyEndpoint 部分中对其进行配置。

错误 原因 解决方案
未能连接到内部代理... Presence 无法访问您指定的出站代理。 appsettings.json 中的 OutgoingProxyEndpoint 下验证代理主机/端口设置。
无法通过出站代理服务器进行认证。 代理的凭证不正确。 更新 appsettings.jsonOutgoingProxyEndpoint 部分中的用户名和密码
连接服务器时出错。 Presence 无法访问 AppScan 360° 本地服务器。

1.验证是否可从计算机访问您的 AppScan 360° URL。

2.确保内部防火墙允许流量到达 AppScan 360° 主机。

3.检查是否存在可能干扰自签名证书的 SSL 检查工具。

隧道启动错误

确保 Presence 计算机可以直接通过网络访问正在测试的应用程序。

错误 原因 解决方案
未能连接到内部代理... Presence 无法访问用于和目标应用程序进行通信的代理。 验证 appsettings.jsonInternalProxyEndpoint 部分中的设置。
警告:已收到无效的 HTTP 响应/状态... Presence 访问了起始 URL,但应用程序返回了错误。 验证运行 Presence 的计算机是否拥有访问目标网站的许可权。检查本地 WAF 或 IP 白名单。
未能启动隧道客户机。 未能初始化专用站点扫描进程。 参阅安装目录中的 Presence 日志,并联系您的内部 AppScan 360° 管理员。

其他错误

错误 原因 解决方案
未能更新所需组件。 Presence 无法从 AppScan 360° 服务器下载更新。 确保用户帐户对 Presence 目录和系统 Temp 文件夹具有写入许可权。