本文提供了 API 应用连接器错误消息的列表，以及针对每个错误的解决方法建议。
常见错误消息和解决方法
尝试使用 API 应用连接器连接云应用后，可以在应用连接器对话框中看到应用连接器错误。
注意
如果连接器遇到故障或断开连接，将生成系统警报。 若要恢复正常操作并保持连接，请在连接器页上重新连接连接器。
| 错误消息 | 相关应用 | 说明 | 解决方法 |
|---|---|---|---|
| HttpRequestFailure： 服务器返回： 500 内部服务器错误 | 所有应用 | 应用中出现错误。 | 检查应用的状态 |
| 服务超时 | 所有应用 | 检测到 Defender for Cloud Apps 与应用之间的连接已超时。 这可能是由于应用存在问题。 | 请稍后重试。 |
| 获取事件：请求失败，状态代码为 402。 需要付款。 审计日志授权验证失败 | Atlassian | Atlassian 订阅未包含监控事件所需的“Atlassian Access”计划。 | 请在 Atlassian 订阅上启用“Atlassian Access”计划。 |
| 空指针异常 | AWS | 内部错误 | 联系支持人员 |
| AuthFatalFailureException： com.box.boxjavalibv2.exceptions.BoxServerException： {“error”：“invalid_grant”，“error_description”：“无效刷新令牌”} | Box | Box 的刷新令牌无效 | 按照过程再次将 Box 连接到Defender for Cloud Apps。 |
| BoxRestException：无法分析响应。 | Box | 内部错误 | 再次单击“立即测试”链接以测试与 Box 的连接。 |
| ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {“错误”:"invalid_grant","error_description":“刷新令牌无效”}' | Box | Box 的刷新令牌无效 | 按照过程再次将 Box 连接到Defender for Cloud Apps。 |
| BoxServerException：用户无法在没有企业的情况下访问此功能 | Box | Box 帐户不是企业帐户。 | 将 Box 许可证升级到 Box 的企业版，然后按照过程再次将 Box 连接到 Defender for Cloud Apps。 |
| BoxServerException：未授权 - 无法对此服务授权 | Box | Box 管理员删除了 Box 中的Defender for Cloud Apps应用程序。 | 按照过程再次将 Box 连接到Defender for Cloud Apps。 |
| HttpRequestFailure: 服务器返回: 401 未授权 | Exchange 在线版 | 用户或密码不正确 | 确保用户名和密码正确无误，然后按照过程再次将Exchange Online连接到Defender for Cloud Apps。 |
| HttpRequestFailure: 服务器返回: 404 未找到 | Exchange 在线版 | 您用于登录 Exchange Online 的用户帐户在 Exchange Online 中没有主邮箱（例如，该用户不存在于 Microsoft Entra ID 中，或者该用户虽存在于 Microsoft Entra ID 中，但没有 Exchange Online 许可证）。 | 按照过程，使用新的管理员帐户再次将Exchange Online连接到Defender for Cloud Apps。 |
| GoogleJsonResponseException：401 未获授权 | Google Workspace | 拒绝访问。 你无权读取活动记录。 登录 Google Workspace 的用户必须是管理员用户。 | 按照过程使用管理员帐户再次将 Google Workspace 连接到Defender for Cloud Apps。 |
| GoogleJsonResponseException： 403 禁止访问 | Google Workspace | ||
| 运行 Google 工作区 API 时出现问题。 | 如果刚刚部署了适用于 Google 工作区的 Defender for Cloud Apps 应用连接器，检查以下内容：如果单击了“无限制”，请确保你的 Google 工作区帐户确实不受限制。 如果不是，请再次运行应用连接器，并取消选择无限制帐户的选项。 检查在安装过程中定义的作用域是否正确。 如果这不是一次新的部署，且你看到了此错误，则可能是你已达到今天的 API 限额，Google Workspace 事件将在明天重新续订。 | ||
| TokenResponseException：400 错误的请求 | Google Workspace | 与 Google Workspace 的连接未完成或已过期。 | 按照过程再次将 Google Workspace 连接到Defender for Cloud Apps。 |
| HttpRequestFailure: 服务器返回: 401 未授权 | Okta | Okta 令牌无效。 | 按照过程再次将 Okta 连接到Defender for Cloud Apps。 |
| IOException： | Okta | 内部错误 | 联系支持人员 |
| HttpRequestFailure: 服务器返回: 404 未找到 | Okta | 内部错误 | 联系支持人员 |
| HttpRequestFailure：服务器返回：400 错误请求：{"error":{"code":"AF20012","message":"指定的租户 ID（Tenant_ID 填写于此）在系统中配置不正确。"} | Microsoft 365 | 未找到已分配的 Microsoft 365 许可证。 | 将至少一个 Microsoft 365 许可证分配给租户。 |
| Microsoft.Office.Compliance.Audit.DataServiceException: Tenant 998cea7e-35cd-46a5-ab3c-8ec88a45d7d5 不存在或 {"error":"code":"AF20023","message":"该订阅已被禁用。"} | Microsoft 365 | Microsoft 365 中未启用审核日志 | 在 Microsoft 365 中启用审核日志记录。 了解更多 |
| HttpRequestFailure: 服务器返回: 401 未授权 | Microsoft 365 | 内部问题 | 再次单击“立即测试”链接 |
| TokenRefreshException： {“error”：“invalid_grant”，“error_description”：“AADSTS70002：验证凭据时出错。 AADSTS70008：提供的授权代码或刷新令牌已过期。 为此用户和资源发送新的交互式授权请求。 | Microsoft 365 | 令牌已过期 | 按照过程再次将 Microsoft 365 连接到Defender for Cloud Apps。 |
| SocketTimeoutException: 读取超时 | Microsoft 365 | 内部错误 | 再次单击“立即测试”链接 |
| 空指针异常 | Microsoft 365 | 内部错误 | 联系支持人员 |
| IgniteException | Microsoft 365 | 域或用户无效 | 重置设置并按照过程再次将 Microsoft 365 连接到Defender for Cloud Apps。 |
| ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {“错误”:"invalid_grant","error_description":"AADSTS70002: 验证凭据时出错。 AADSTS70008：提供的授权代码或刷新令牌已过期。 为此用户和资源发送新的交互式授权请求。 | Microsoft 365 | 域或用户无效 | 重置设置并按照过程再次将 Microsoft 365 连接到Defender for Cloud Apps。 |
| HttpRequestFailure: 服务器返回: 400 错误的请求 | Microsoft 365 | 内部错误 | 几分钟后再次单击“立即测试”链接，如果它不起作用，请按照过程再次将 Microsoft 365 连接到Defender for Cloud Apps。 |
| SocketTimeoutException: 读取超时 | Salesforce | 内部错误 | 再次单击“立即测试”链接以测试与 Salesforce 的连接。 |
| HttpRequestFailure: 服务器返回: 400 错误的请求 | Salesforce | 与 Salesforce 的连接未完成或已过期。 | 按照过程再次将 Salesforce 连接到 Defender for Cloud Apps。 |
获取权限：NoHttpResponseException：*******.salesforce.com:443 无法响应 |
Salesforce | 客户 ENV 的 IP 限制。 | 在 Salesforce 门户中，在 设置>会话设置 下，清除 将会话锁定到其发起时使用的 IP 地址 复选框。 |
| 团队未获授权 | Slack | 未启用 Slack 发现 API。 | 请联系 Slack 支持部门并要求启用发现 API。 |
| RuntimeException: com.adallom.adalib.httputils.exceptions.HttpRequestFailure: 服务器返回: 403 禁止访问 | ServiceNow | 权限不正确 | 按照过程使用管理员帐户再次将ServiceNow连接到Defender for Cloud Apps。 |
| 计划不支持你尝试执行的操作 | Smartsheet | Smartsheet 计划不正确，需要 Platinum 套餐企业许可证 | 升级 Smartsheet 许可证。 |
| 获取事件：{“code”：403，“serverResponse” 获取用户：{“代码”：403，“serverResponse” … "body":"{"error":"权限被拒绝"}" |
Workday | 访问审核日志和/或用户终结点的权限不足 | 验证所有权限是否已到位。 了解更多 |
| “代码”：400，“serverResponse” … “正文”:“{“错误”:“invalid_grant”} |
Workday | 身份验证问题 | 用于设置实例的帐户可能被锁定或禁用。 若要验证，请查看 Workday 帐户并选择“ 查看登录历史记录”。 你可能会在报告中看到一条身份验证失败消息，指出系统帐户已禁用。 了解更多 |
| “code”：401，“serverResponse”： … “正文”:“{“错误”:“invalid_grant”}” |
Workday | 客户端令牌有效性问题 | OAuth 2.0 REST API 客户端令牌无效。 令牌可能已过期，也可能不正确。 生成另一个令牌并将其分配给连接的实例。 了解更多 |
| 获取用户：成功 获取事件：请求失败，状态代码为 403 | Zendesk | 配置集成的 Zendesk 用户不再是 Zendesk 管理员，或者你的 Zendesk 许可证不受支持。 | 将配置该连接器的 Zendesk 用户升级为管理员（可在 Zendesk 管理门户中操作），或查看此处，确认您的 Zendesk 许可证是否受支持。 |
排查连接应用后活动缺失的问题
如果在连接应用后未显示预期活动，请使用以下检查来确定数据应位于何处以及是否需要其他配置。
1.确认连接器是否正常 验证应用连接器是否已成功连接，并且没有配置警告或权限问题。
2. 检查引入延迟预期 某些连接器在活动出现之前具有预期的延迟。 在将缺失活动视为问题之前，验证连接器是否有记录的引入延迟。
3. 确认连接器是否支持活动引入 检查连接器是否支持活动集合。 有关每个连接器支持的活动的列表，请参阅 连接应用以获取可见性和控制。
4. 查看特定于连接器的活动选项 对于支持可选活动类型的连接器，请确认已启用所需的选项。 例如，如果要调查登录活动，请验证连接器是否已配置为收集相关的登录数据。
5. 验证作用域内部署设置 如果启用了范围部署，请确认执行活动的帐户包含在当前作用域内的部署规则中。 由排除的用户、组或应用生成的活动不会被引入系统。 此外，验证是否在连接的应用程序中正确匹配帐户标识符，尤其是在使用不同的标识符格式时。
6. 验证预期的日志记录图面 根据活动类型，检查事件是否出现在下表中列出的相应源中。
| 事件 | 来源 |
|---|---|
| Defender for Cloud Apps策略管理更改 | Microsoft Defender for Cloud Apps活动日志 |
| Microsoft Entra登录事件 | Microsoft Entra登录日志 |
| 身份相关调查数据 | 高级搜寻标识表 |
7. 在得出结论数据缺失之前应用筛选器 使用筛选器，例如：
- 时间范围
- 用户或管理员
- 活动类型
- 应用或工作负载
8. 检查已知范围限制 某些活动可能未在每个日志记录图面中完全表示。 如果某一来源中缺少某个事件，请确认该活动是否在另一来源中有可用记录。
重要
缺少活动并不总是表示连接器失败。 首先确认该活动是否应出现在 Defender for Cloud Apps、Microsoft Entra 日志、Microsoft 365 审核日志或高级搜寻中。
进一步调查
在以下情况下进一步调查：
- 连接器显示正常状态，但任何支持的日志记录图面中都没有显示预期数据。
- 所需的活动选项已启用，但经过合理的验证时间后，仍未出现该事件。
- 同一活动类型在多次检查中始终不可用。
后续步骤
如果你遇到任何问题，我们随时为你提供帮助。 若要获取有关产品问题的帮助或支持，请 开具支持票证。