# 单点登录、聊天应用与连接器

此类别中的每个代码：其含义、最常见的原因、应如何处理以及由谁处理。

[全部错误代码](https://www.azothos.ai/zh/docs/errors)

### `sso_oidc_unavailable`

- **含义**: 无法连接此地址的身份提供商，因此单点登录无法开始或完成。
- **最常见的原因**: 该提供商出现故障，或其地址已更改。
- **如何处理**: 请稍后重试。如果仍然失败，请由所有者或管理员在“设置 › 访问”中检查身份提供商。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_domain_unverified`

- **含义**: 对于工作区尚未证明拥有的域，无法要求单点登录。
- **最常见的原因**: 该域的 DNS TXT 记录尚未验证。
- **如何处理**: 请将“设置 › 访问”中显示的 TXT 记录添加到该域的 DNS，完成验证，然后再要求单点登录。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_provider_required`

- **含义**: 在工作区未启用任何身份提供商时，无法要求单点登录。
- **最常见的原因**: 尚未配置提供商，或已配置的提供商被关闭。
- **如何处理**: 请在“设置 › 访问”中配置身份提供商，用它测试一次登录，然后再要求单点登录。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_type_change`

- **含义**: 此工作区已有 SAML 身份提供商：无法在其旁边再保存 OIDC 提供商。
- **最常见的原因**: 在未先移除 SAML 提供商的情况下从 SAML 切换到 OIDC。
- **如何处理**: 请在“设置 › 访问”中移除 SAML 提供商，然后配置 OIDC。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `oidc_client_secret_required`

- **含义**: OIDC 身份提供商需要连同其客户端密钥一起保存。
- **最常见的原因**: 为新提供商保存时客户端密钥留空。
- **如何处理**: 请粘贴身份提供商为此应用提供的客户端密钥，然后保存。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `oidc_issuer_invalid`

- **含义**: 该签发者不是身份提供商可用的公共 https 地址，因此未保存该提供商。
- **最常见的原因**: 拼写错误、http 地址，或地址中带有查询参数、片段或凭据。
- **如何处理**: 请完全按照身份提供商公布的方式输入签发者（https，不带查询参数），然后保存。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `oidc_issuer_multi_tenant`

- **含义**: 此签发者服务于众多组织，因此不能用于一个工作区成员的登录。
- **最常见的原因**: 使用了共享的 Microsoft Entra 地址（common 或 organizations），而不是您自己租户的地址。
- **如何处理**: 请使用您自己租户的签发者地址（含租户 ID），然后保存。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `oidc_discovery_failed`

- **含义**: 无法读取身份提供商的发现文档，因此未保存该提供商。
- **最常见的原因**: 签发者地址错误，或 Azoth 无法连接该提供商。
- **如何处理**: 请检查签发者地址以及其 /.well-known/openid-configuration 是否有响应，然后重新保存。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `oidc_discovery_mismatch`

- **含义**: 身份提供商的发现文档指明了另一个签发者，或缺少某个端点，因此未保存该提供商。
- **最常见的原因**: 输入的签发者路径或结尾与提供商自身的不同。
- **如何处理**: 请完全按照其发现文档中的写法输入签发者，然后保存。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_too_many_attempts`

- **含义**: 一分钟内来自此网络地址的单点登录返回次数过多，因此本次登录未完成。
- **最常见的原因**: 反复尝试登录，或许多人在同一网络地址后同时登录。
- **如何处理**: 请等待一分钟，然后重新开始登录。
- **由谁处理**: 工作区的任何成员

### `sso_attempt_expired`

- **含义**: 从身份提供商返回的登录并非此浏览器发起的，或耗时过长，因此未打开任何会话。
- **最常见的原因**: 在身份提供商处停留过久、在另一个浏览器或标签页中发起了登录，或返回链接被第二次打开。
- **如何处理**: 请在同一浏览器中从登录页面重新开始登录，并尽快完成。
- **由谁处理**: 工作区的任何成员

### `sso_idp_refused`

- **含义**: 身份提供商返回时未让此人登录，因此未打开任何会话。
- **最常见的原因**: 登录被取消或同意被拒绝，或该账户在身份提供商处无权使用 Azoth 应用。
- **如何处理**: 请让您的身份提供商管理员为您的账户开通 Azoth 应用的访问权限，然后重新登录。
- **由谁处理**: 工作区的所有者或管理员

### `sso_provider_unavailable`

- **含义**: 工作区的单点登录已不可用，因此登录无法完成。
- **最常见的原因**: 在登录过程中，其身份提供商被关闭或删除，或工作区的套餐不再包含单点登录。
- **如何处理**: 由所有者或管理员在“设置 › 访问”中检查单点登录，并在“设置 › 组织”中检查套餐。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_provider_misconfigured`

- **含义**: 工作区身份提供商的设置无法用于登录，因此未打开任何会话。
- **最常见的原因**: Azoth 已不再接受的签发者（共享的 Microsoft 租户、非公共 https 地址），或发现文档指明的签发者与已保存的不同。
- **如何处理**: 由所有者或管理员在“设置 › 访问”中更正身份提供商（签发者须与提供商公布的完全一致，使用您自己的租户），然后重新登录。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_token_exchange_failed`

- **含义**: 身份提供商拒绝为 Azoth 完成登录，因此未打开任何会话。
- **最常见的原因**: 身份提供商处的客户端密钥已更改或过期、客户端 ID 不匹配，或 Azoth 的重定向地址未在其处注册。
- **如何处理**: 由所有者或管理员在“设置 › 访问”中检查客户端 ID 和密钥，并确认其中显示的重定向地址已在身份提供商处注册。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_id_token_invalid`

- **含义**: 无法验证提供商发送的身份，因此未打开任何会话。
- **最常见的原因**: 令牌使用 Azoth 不接受的算法或提供商未公布的密钥签名、为其他应用签发，或已过期。
- **如何处理**: 由所有者或管理员在“设置 › 访问”中检查身份提供商的令牌签名（RS256、PS256 或 ES256）和客户端 ID。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_email_domain_mismatch`

- **含义**: 身份提供商使用工作区已验证域名之外的邮箱地址（或没有邮箱地址）为此人登录，因此未打开任何会话。
- **最常见的原因**: 账户邮箱属于其他域名（子域名也算其他域名），或提供商未提供邮箱地址。
- **如何处理**: 请使用您组织的账户登录；由管理员让身份提供商提供已验证域名内的邮箱地址。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_email_unverified`

- **含义**: 身份提供商未确认已验证该邮箱地址，因此未打开任何会话。
- **最常见的原因**: 没有 email_verified 声明；在 Microsoft Entra ID 上未添加可选声明 xms_edov；在 Google 上，账户不属于 Workspace 域名。
- **如何处理**: 由管理员让身份提供商确认该邮箱地址（Microsoft Entra ID：添加可选声明 xms_edov），然后您重新登录。
- **由谁处理**: 工作区的所有者或管理员

### `dns_lookup_failed`

- **含义**: 无法读取该域的 DNS，因此无法检查其所有权。
- **最常见的原因**: DNS 短暂故障，或该域不存在。
- **如何处理**: 请一分钟后重新验证该域。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `record_not_found`

- **含义**: 在该域的 DNS 中未找到证明该域的 TXT 记录。
- **最常见的原因**: 尚未添加该记录，或尚不可见：DNS 更改需要一段时间才能生效。
- **如何处理**: 请将“设置 › 访问”中显示的 TXT 记录添加到该域的 DNS，稍后再重新验证。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `domain_already_verified`

- **含义**: 另一个 Azoth 工作区已证明此域：一个域只能登录到一个工作区。
- **最常见的原因**: 另一个工作区（无论是否属于您的组织）先证明了该域。
- **如何处理**: 请使用持有该域的工作区；如果该域属于您，请联系支持。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `domain_changed`

- **含义**: 单点登录的域在验证过程中发生了变化，因此未记录任何内容。
- **最常见的原因**: 两人同时在编辑单点登录。
- **如何处理**: 请重新加载“设置 › 访问”，然后重新验证该域。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `sso_provider_update_failed`

- **含义**: 该域已证明，但向登录服务注册该域失败。
- **最常见的原因**: 登录服务出现短暂故障。
- **如何处理**: 请稍后重新验证该域。
- **由谁处理**: Azoth，或此部署的运营方

### `sso_provider_delete_failed`

- **含义**: 登录服务未移除该工作区的 SAML 身份提供商，因此 Azoth 也未移除任何内容：单点登录保持原样。
- **最常见的原因**: 登录服务出现短暂故障。
- **如何处理**: 登录服务未移除该身份提供商，因此未移除任何内容。请稍后重试。
- **由谁处理**: Azoth，或此部署的运营方

### `link_expired`

- **含义**: 此用于关联您聊天账户的链接已过期。
- **最常见的原因**: 链接打开得太晚，或已被使用。
- **如何处理**: 请向 Azoth 应用索取新链接（在 Slack 中输入 /azoth link，在 Teams 中输入 link），并立即打开。
- **由谁处理**: 工作区的任何成员

### `not_installed`

- **含义**: 此 Slack 工作区或 Teams 机器人未连接到 Azoth。
- **最常见的原因**: 该应用已被移除，或从未连接到此部署。
- **如何处理**: 请由所有者或管理员在“设置 › 集成与告警”中连接该应用，然后向应用索取新链接。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=integrations)

### `chat_identity_mismatch`

- **含义**: 此聊天账户不属于您：其平台为它保存的邮箱不是您 Azoth 账户的邮箱，因此未关联任何内容。
- **最常见的原因**: 在登录了另一个 Azoth 账户时打开了链接，或打开了他人的链接。
- **如何处理**: 请在登录了与该聊天账户邮箱相同的 Azoth 账户后打开链接：只有账户本人才能关联。
- **由谁处理**: 工作区的任何成员

### `chat_identity_unverified`

- **含义**: 聊天平台未提供此账户的邮箱，因此 Azoth 无法判断其归属：未关联任何内容。
- **最常见的原因**: Slack 连接时未获得读取成员邮箱的权限，或这是 Teams 来宾账户。
- **如何处理**: 对于 Slack，请由所有者或管理员在“设置 › 集成与告警”中重新连接该应用，然后重试。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=integrations)

### `chat_identity_unavailable`

- **含义**: 聊天平台无法说明此账户属于谁，因此未关联任何内容。
- **最常见的原因**: Slack 或 Microsoft 出现短暂故障。
- **如何处理**: 请稍后重新打开链接，再试一次。
- **由谁处理**: Azoth，或此部署的运营方

### `teams_secret_required`

- **含义**: Teams 机器人需要连同其客户端密钥一起保存。
- **最常见的原因**: 客户端密钥留空。
- **如何处理**: 请从 Microsoft Entra 粘贴该机器人的客户端密钥，然后保存。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=integrations)

### `teams_credentials_invalid`

- **含义**: Microsoft 拒绝了这些凭据，因此未保存该机器人。
- **最常见的原因**: 应用 ID、租户 ID 或客户端密钥有误，或密钥已过期。
- **如何处理**: 请在 Microsoft Entra 中检查应用 ID、租户 ID 和客户端密钥，然后重新保存。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=integrations)

### `teams_app_taken`

- **含义**: 此 Teams 机器人已连接到另一个 Azoth 工作区。
- **最常见的原因**: 同一个应用 ID 被用于两个工作区。
- **如何处理**: 请为此工作区使用单独的机器人，或先将该机器人与另一个工作区断开。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=integrations)

### `connector_not_available`

- **含义**: 此工作区的套餐不包含连接助手（Claude、ChatGPT）。
- **最常见的原因**: 该工作区所用套餐不含已连接的助手。
- **如何处理**: 请升级到包含已连接助手的套餐（设置 › 组织），然后重新连接助手。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=billing)

### `connectors_disabled`

- **含义**: 工作区的所有者或管理员已关闭已连接的助手。
- **最常见的原因**: 已连接的助手在“设置 › 访问”中处于关闭状态。
- **如何处理**: 请让所有者或管理员在“设置 › 访问”中开启已连接的助手。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=access)

### `missing_token`

- **含义**: 调用连接器端点时没有提供访问令牌。
- **最常见的原因**: 助手尚未连接到 Azoth，或是手动发起的调用。
- **如何处理**: 请在助手自身的设置中将其连接到 Azoth：它会登录并获得令牌。
- **由谁处理**: 调用方代码的开发者

### `invalid_token`

- **含义**: 调用连接器端点时使用的访问令牌不被接受：已过期、已撤销、格式错误或为其他地址签发。
- **最常见的原因**: 该连接已被本人移除、令牌已到期，或部署的地址已更改。
- **如何处理**: 请在助手自身的设置中重新将其连接到 Azoth：它的访问令牌已过期或已被撤销。
- **由谁处理**: 调用方代码的开发者

### `insufficient_scope`

- **含义**: 该访问令牌不具备连接器所需的读取权限。
- **最常见的原因**: 授予连接时未包含对工作区的读取权限。
- **如何处理**: 请在助手自身的设置中重新将其连接到 Azoth，并授予它读取工作区的权限。
- **由谁处理**: 调用方代码的开发者

### `missing_client`

- **含义**: 连接请求未指明任何客户端，因此无法连接该助手。
- **最常见的原因**: 指向同意页面的链接不完整。
- **如何处理**: 请在助手的设置中重新开始连接。
- **由谁处理**: 调用方代码的开发者

### `unknown_client`

- **含义**: 连接请求指明了一个 Azoth 不认识的助手。
- **最常见的原因**: 该助手从未在此部署注册，或其注册已被删除。
- **如何处理**: 请在助手的设置中重新开始连接，以便它重新注册。
- **由谁处理**: 调用方代码的开发者

### `invalid_redirect_uri`

- **含义**: 连接请求的返回地址不是该助手声明过的地址，因此 Azoth 不会向那里发送任何内容。
- **最常见的原因**: 链接被修改，或助手的返回地址已更改。
- **如何处理**: 请在助手的设置中重新开始连接。
- **由谁处理**: 调用方代码的开发者

### `connector_not_installed`

- **含义**: 此工作区和环境未安装 Inventory Object 连接器，因此未保存任何内容。
- **最常见的原因**: 该批次所指环境从未安装过该连接器，或连接器已被暂停。
- **如何处理**: 请为此环境安装连接器（连接器），或将该批次发送到已安装连接器的环境。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/connectors)

### `connector_revoked`

- **含义**: 此连接器已被卸载，因此无法批准：卸载永远不会被撤销。
- **最常见的原因**: 所有者或管理员已将其卸载——在批准之前，或在针对它的双人审批请求等待期间。
- **如何处理**: 请重新安装该连接器：它将作为一次新的安装从头开始；如果此工作区要求审批，则需等待审批。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/connectors)

### `connector_governance_failed`

- **含义**: 测试导入期间连接器的治理检查失败，因此未保存测试行。
- **最常见的原因**: 连接器配置有问题，或数据库出现短暂故障。
- **如何处理**: 请稍后重新运行测试。如果仍然失败，请联系支持团队：服务器日志会写明原因。
- **由谁处理**: Azoth，或此部署的运营方

### `repository_not_found`

- **含义**: 此工作区的 GitHub 连接中没有使用此 ID 的代码仓库。
- **最常见的原因**: GitHub 应用已无法访问该仓库，或使用了另一个工作区的 ID。
- **如何处理**: 请在“设置 › 集成与告警”中重新加载仓库，然后从中选择一个。
- **由谁处理**: 工作区的所有者或管理员 · [打开相关页面](https://www.azothos.ai/dashboard/settings?section=integrations)
