操作方法：将 HAR 调试文件提交至 Esri 支持服务以进行故障排除和检查

描述

捕获客户端计算机和服务器计算机（例如用户计算机和 ArcGIS Online 服务器）之间通信的调试文件可能是解决 Esri 支持案例的重要信息来源。 虽然首选通过屏幕共享和电话解决与基于 Web 的 Esri 应用程序和服务相关的问题，但 Esri 支持服务认识到在某些复杂或紧急的情况下，分析师可能需要要求用户提供这些调试文件以进行故障排除。 可以使用 web 浏览器中的开发人员工具 (DevTools) 或通过 web 捕获程序（例如 Telrik 的 Fiddler）将这些调试文件捕获为 HAR 文件。

尽管调试文件对于快速解决问题至关重要，但请务必注意，这些文件也可能包含敏感信息，包括但不限于：

• ArcGIS 授权令牌
• 敏感 URL 查询参数
• 请求正文中的敏感信息（用户名和密码）
• 请求正文中的敏感信息（其他查询参数）
• 响应正文中的敏感信息
• Cookie 详细信息

Esri 非常重视客户数据的安全和隐私，因此非常关注与共享调试文件相关的潜在安全和隐私问题。 为限制这些风险，Esri 建议在与 Esri 支持服务共享客户端调试文件之前“清理”这些文件（请参阅以下说明）。

如果忽略此通知，Esri 不承担任何责任，并且 Esri 无法代表客户清理调试文件。 虽然根据策略，Esri 支持服务将使用安全环境来测试客户数据和审查客户端调试文件，但该环境必然无法完全隔离，并且可以访问：

• ArcGIS Online
• Esri 托管文件传输服务（用于下载客户提供的数据集的只读 FTP）
• Esri 支持服务案例附件（用于下载客户提供的数据集的只读 FTP）

拒绝访问所有其他主机。

发送到支持服务的所有文件将在 90 天内删除。

如果对调试文件的内容或 Esri 客户提供的客户端追踪清理程序有疑问，Esri 建议客户选择不与 Esri 支持服务共享调试文件，并与支持分析师合作通过其他方法解决问题。

解决方案或解决方法

在浏览器中捕获调试文件 (HAR)

以下说明适用于使用常用浏览器捕获调试文件的情况。 在每种情况下，需注意仅捕获在有问题的步骤中发生的流量，以限制捕获不必要的安全信息、减小文件大小，并从故障排除分析中过滤掉不相关的流量。

Google Chrome

1. 打开 Google Chrome 并转至出现问题的页面。 执行过程中导致问题的步骤之前的所有步骤。
2. 在浏览器中，单击右上角的垂直省略号按钮 ()，在下拉菜单中单击更多工具，然后单击开发者工具。
3. 要取消停靠 DevTools 窗格，请单击 DevTools 窗格上的垂直省略号按钮 ()，然后在停靠边部分中选择第一个选项以取消停靠到单独的窗口 ()。
4. 选择网络选项卡。
5. 找到位于左上角的圆形的记录按钮 () 并确保其为红色。 如果为灰色，请单击以开始记录
6. 选择保留日志复选框。
7. 单击“清除”按钮 () 以清除网络面板中的所有当前网络请求。
8. 打开 DevTools，在记录请求的同时重现问题。
9. 重现问题后，在 Chrome 中，单击“导出 HAR”向下箭头 () 下载并将文件保存到计算机。

有关使用 Google Chrome 捕获 HAR 的详细信息，请参阅 Google Developers 网站上的打开 Chrome DevTools。

Microsoft Edge (Chromium)

1. 打开 Microsoft Edge 并转至出现问题的页面。 执行过程中导致问题的步骤之前的所有步骤。
2. 在浏览器中，单击右上角的水平省略号按钮 ()，在下拉菜单中单击更多工具，然后单击开发者工具。
3. 要取消停靠 DevTools 窗格，请单击 DevTools 窗格上的垂直省略号按钮 ()，然后在停靠边部分中选择第一个选项以取消停靠到单独的窗口 ()。
4. 选择网络选项卡。
5. 找到位于选项卡左上角的记录按钮 () 并确保其为红色。 如果为灰色，请单击以开始记录
6. 选择保留日志复选框。
7. 单击“清除”按钮 () 以清除网络面板中的所有当前网络请求。
8. 打开 DevTools，在记录请求的同时重现问题。
9. 重现问题后，在 Edge 中，单击“导出 HAR”向下箭头 () 进行下载。 然后将文件保存到您的计算机。

有关详细信息，请参阅 Microsoft Docs 网站“网络分析参考”页面上的将所有网络请求保存到 HAR 文件。

Mozilla Firefox

1. 打开 Mozilla Firefox 并转至出现问题的页面。 执行过程中导致问题的步骤之前的所有步骤。
2. 在浏览器中，单击右上角的汉堡菜单按钮 ()，在下拉菜单中单击更多工具，然后从二级下拉菜单中选择 Web 开发者工具。
3. 要取消停靠 DevTools 窗格，请单击 DevTools 窗格上的垂直省略号按钮 ()，然后选择单独窗口选项。
4. 选择顶部的网络选项卡，将其打开。
5. 在选项卡的左上角找到圆形的“播放/暂停”按钮，并确保其显示了暂停选项 ()。如果您看到的是播放按钮 ()，请单击以开始记录。
6. 单击面板右上角的齿轮按钮 ()，然后单击保留日志选项以将其选中。
7. 打开“开发者工具”，在记录请求的同时重现问题。
8. 在 Firefox 中重现问题后，左键单击任何请求并选择全部另存为 HAR，然后将文件保存到您的计算机。

捕获其他程序的调试文件 (.HAR)

Esri 技术支持使用 Telrik Fiddler Classic 捕获在浏览器外部发生的流量，例如在对 ArcGIS Pro 进行故障排除时。 与基于浏览器的捕获相似，需注意仅捕获在有问题的步骤中发生的流量。

要使用 Fiddler Classic 捕获 .HAR 文件，需要执行以下操作：

1. 下载 Fiddler Classic
2. 按照操作方法：使用 Fiddler 捕获 https 连接并解密 https 流量中描述的步骤 1 到 8 进行操作，在保存文件之前停止操作。
3. 捕获流量后，打开文件下拉菜单 > 导出会话 > 所有会话。
4. 在弹出的下拉列表中，选择 HTTPArchive v1.2，然后单击下一步。
5. 保存文件。

清理 HTTP Archive (.HAR) 文件

捕获 HAR 文件后，需要使用 Notepad、Notepad++ 或 Sublime Text 等文本编辑器对其进行检查，并完成以下步骤移除所有敏感信息。

1. 在文本编辑器中打开 HAR 文件，右键单击该文件，选择打开方式，然后选择文本编辑器应用程序。
2. 使用文本编辑器的“查找和替换”工具来识别和替换 HAR 文件中捕获的所有敏感信息。 其中包括：
   • 用户名
   • 密码
   • API 密钥 - 这些是由字母、数字和符号组成的长字符串，用于访问自定义应用程序，与以下内容类似：

   AAPK5f9f39a988764653b27dd7d01fa14d35kfSLvKsiJoeoXX2oFBXE_021u_apQt1eAssZEfnmcri1hUhBmHEyxoOXJhaW9xgie

   • 授权令牌 - 这些是由字母、数字和符号组成的长字符串，类似于 API 密钥，可在任何基于 Web 的 Esri 应用程序中使用以验证用户。 令牌与以下内容类似：

    VBQlHZ__ONCdOUPteoQPfEEPYTyrfy3XugMasrGO90rUmGiMa_tzvjfksFsZ57MtTE1gywBYtVhrldIKuPPu7MFt4u6ukauvDtH4r2kZePZtgbCFomXc0ThIuwF9cPK6LNTFOJ3Q850ilLO2zP6kzmaY0cfnsJBMcoPmFH9BOLamDQFig3628HwU53xis4gIiEJNkWhnI3ynb

   • • 搜索任何“generateToken”调用并将其删除。
   • 任何其他敏感信息（例如，如果数据包含具有医疗患者身份信息的字段，您可能希望搜索并移除该信息）。如果您对数据是否包含敏感信息有任何疑问，请联系您组织中的数据方案所有者，并与他们共同审查数据分类。 Esri 无法就每个客户组织认为敏感的内容提供指导。

3. 保存已编辑的 HAR 文件，并移除敏感信息。
4. 向 Esri 支持服务提供您的 HAR 和书面通知：
   • 已查看这些说明
   • 并在向 Esri 支持服务提供客户端调试存档之前已对其进行清理。

如果无法采取适当的步骤来专门清理令牌的 HAR 文件，请从网络流量捕获时间起等待 30 分钟后再通过支持案例共享该文件。

• 这是为了确保所有令牌都已过期，无法用于未经授权的访问或授权行为。

如果您对此有任何疑问，请随时与支持服务分析师进行探讨。