错误代码
单点登录、聊天应用与连接器
此类别中的每个代码:其含义、最常见的原因、应如何处理以及由谁处理。
sso_domain_unverified
- 含义
- 对于工作区尚未证明拥有的域,无法要求单点登录。
- 最常见的原因
- 该域的 DNS TXT 记录尚未验证。
- 如何处理
- 请将“设置 › 访问”中显示的 TXT 记录添加到该域的 DNS,完成验证,然后再要求单点登录。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
sso_provider_required
- 含义
- 在工作区未启用任何身份提供商时,无法要求单点登录。
- 最常见的原因
- 尚未配置提供商,或已配置的提供商被关闭。
- 如何处理
- 请在“设置 › 访问”中配置身份提供商,用它测试一次登录,然后再要求单点登录。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
sso_type_change
- 含义
- 此工作区已有 SAML 身份提供商:无法在其旁边再保存 OIDC 提供商。
- 最常见的原因
- 在未先移除 SAML 提供商的情况下从 SAML 切换到 OIDC。
- 如何处理
- 请在“设置 › 访问”中移除 SAML 提供商,然后配置 OIDC。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
oidc_client_secret_required
- 含义
- OIDC 身份提供商需要连同其客户端密钥一起保存。
- 最常见的原因
- 为新提供商保存时客户端密钥留空。
- 如何处理
- 请粘贴身份提供商为此应用提供的客户端密钥,然后保存。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
oidc_issuer_invalid
- 含义
- 该签发者不是身份提供商可用的公共 https 地址,因此未保存该提供商。
- 最常见的原因
- 拼写错误、http 地址,或地址中带有查询参数、片段或凭据。
- 如何处理
- 请完全按照身份提供商公布的方式输入签发者(https,不带查询参数),然后保存。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
oidc_issuer_multi_tenant
- 含义
- 此签发者服务于众多组织,因此不能用于一个工作区成员的登录。
- 最常见的原因
- 使用了共享的 Microsoft Entra 地址(common 或 organizations),而不是您自己租户的地址。
- 如何处理
- 请使用您自己租户的签发者地址(含租户 ID),然后保存。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
oidc_discovery_failed
- 含义
- 无法读取身份提供商的发现文档,因此未保存该提供商。
- 最常见的原因
- 签发者地址错误,或 Azoth 无法连接该提供商。
- 如何处理
- 请检查签发者地址以及其 /.well-known/openid-configuration 是否有响应,然后重新保存。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
oidc_discovery_mismatch
- 含义
- 身份提供商的发现文档指明了另一个签发者,或缺少某个端点,因此未保存该提供商。
- 最常见的原因
- 输入的签发者路径或结尾与提供商自身的不同。
- 如何处理
- 请完全按照其发现文档中的写法输入签发者,然后保存。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
sso_too_many_attempts
- 含义
- 一分钟内来自此网络地址的单点登录返回次数过多,因此本次登录未完成。
- 最常见的原因
- 反复尝试登录,或许多人在同一网络地址后同时登录。
- 如何处理
- 请等待一分钟,然后重新开始登录。
- 由谁处理
- 工作区的任何成员
sso_attempt_expired
- 含义
- 从身份提供商返回的登录并非此浏览器发起的,或耗时过长,因此未打开任何会话。
- 最常见的原因
- 在身份提供商处停留过久、在另一个浏览器或标签页中发起了登录,或返回链接被第二次打开。
- 如何处理
- 请在同一浏览器中从登录页面重新开始登录,并尽快完成。
- 由谁处理
- 工作区的任何成员
sso_idp_refused
- 含义
- 身份提供商返回时未让此人登录,因此未打开任何会话。
- 最常见的原因
- 登录被取消或同意被拒绝,或该账户在身份提供商处无权使用 Azoth 应用。
- 如何处理
- 请让您的身份提供商管理员为您的账户开通 Azoth 应用的访问权限,然后重新登录。
- 由谁处理
- 工作区的所有者或管理员
sso_provider_misconfigured
- 含义
- 工作区身份提供商的设置无法用于登录,因此未打开任何会话。
- 最常见的原因
- Azoth 已不再接受的签发者(共享的 Microsoft 租户、非公共 https 地址),或发现文档指明的签发者与已保存的不同。
- 如何处理
- 由所有者或管理员在“设置 › 访问”中更正身份提供商(签发者须与提供商公布的完全一致,使用您自己的租户),然后重新登录。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
sso_token_exchange_failed
- 含义
- 身份提供商拒绝为 Azoth 完成登录,因此未打开任何会话。
- 最常见的原因
- 身份提供商处的客户端密钥已更改或过期、客户端 ID 不匹配,或 Azoth 的重定向地址未在其处注册。
- 如何处理
- 由所有者或管理员在“设置 › 访问”中检查客户端 ID 和密钥,并确认其中显示的重定向地址已在身份提供商处注册。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
sso_id_token_invalid
- 含义
- 无法验证提供商发送的身份,因此未打开任何会话。
- 最常见的原因
- 令牌使用 Azoth 不接受的算法或提供商未公布的密钥签名、为其他应用签发,或已过期。
- 如何处理
- 由所有者或管理员在“设置 › 访问”中检查身份提供商的令牌签名(RS256、PS256 或 ES256)和客户端 ID。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
sso_email_domain_mismatch
- 含义
- 身份提供商使用工作区已验证域名之外的邮箱地址(或没有邮箱地址)为此人登录,因此未打开任何会话。
- 最常见的原因
- 账户邮箱属于其他域名(子域名也算其他域名),或提供商未提供邮箱地址。
- 如何处理
- 请使用您组织的账户登录;由管理员让身份提供商提供已验证域名内的邮箱地址。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
sso_email_unverified
- 含义
- 身份提供商未确认已验证该邮箱地址,因此未打开任何会话。
- 最常见的原因
- 没有 email_verified 声明;在 Microsoft Entra ID 上未添加可选声明 xms_edov;在 Google 上,账户不属于 Workspace 域名。
- 如何处理
- 由管理员让身份提供商确认该邮箱地址(Microsoft Entra ID:添加可选声明 xms_edov),然后您重新登录。
- 由谁处理
- 工作区的所有者或管理员
dns_lookup_failed
- 含义
- 无法读取该域的 DNS,因此无法检查其所有权。
- 最常见的原因
- DNS 短暂故障,或该域不存在。
- 如何处理
- 请一分钟后重新验证该域。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
record_not_found
- 含义
- 在该域的 DNS 中未找到证明该域的 TXT 记录。
- 最常见的原因
- 尚未添加该记录,或尚不可见:DNS 更改需要一段时间才能生效。
- 如何处理
- 请将“设置 › 访问”中显示的 TXT 记录添加到该域的 DNS,稍后再重新验证。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
domain_already_verified
- 含义
- 另一个 Azoth 工作区已证明此域:一个域只能登录到一个工作区。
- 最常见的原因
- 另一个工作区(无论是否属于您的组织)先证明了该域。
- 如何处理
- 请使用持有该域的工作区;如果该域属于您,请联系支持。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
domain_changed
- 含义
- 单点登录的域在验证过程中发生了变化,因此未记录任何内容。
- 最常见的原因
- 两人同时在编辑单点登录。
- 如何处理
- 请重新加载“设置 › 访问”,然后重新验证该域。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
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。
- 最常见的原因
- 该应用已被移除,或从未连接到此部署。
- 如何处理
- 请由所有者或管理员在“设置 › 集成与告警”中连接该应用,然后向应用索取新链接。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
chat_identity_mismatch
- 含义
- 此聊天账户不属于您:其平台为它保存的邮箱不是您 Azoth 账户的邮箱,因此未关联任何内容。
- 最常见的原因
- 在登录了另一个 Azoth 账户时打开了链接,或打开了他人的链接。
- 如何处理
- 请在登录了与该聊天账户邮箱相同的 Azoth 账户后打开链接:只有账户本人才能关联。
- 由谁处理
- 工作区的任何成员
chat_identity_unverified
- 含义
- 聊天平台未提供此账户的邮箱,因此 Azoth 无法判断其归属:未关联任何内容。
- 最常见的原因
- Slack 连接时未获得读取成员邮箱的权限,或这是 Teams 来宾账户。
- 如何处理
- 对于 Slack,请由所有者或管理员在“设置 › 集成与告警”中重新连接该应用,然后重试。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
teams_secret_required
- 含义
- Teams 机器人需要连同其客户端密钥一起保存。
- 最常见的原因
- 客户端密钥留空。
- 如何处理
- 请从 Microsoft Entra 粘贴该机器人的客户端密钥,然后保存。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
teams_credentials_invalid
- 含义
- Microsoft 拒绝了这些凭据,因此未保存该机器人。
- 最常见的原因
- 应用 ID、租户 ID 或客户端密钥有误,或密钥已过期。
- 如何处理
- 请在 Microsoft Entra 中检查应用 ID、租户 ID 和客户端密钥,然后重新保存。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
teams_app_taken
- 含义
- 此 Teams 机器人已连接到另一个 Azoth 工作区。
- 最常见的原因
- 同一个应用 ID 被用于两个工作区。
- 如何处理
- 请为此工作区使用单独的机器人,或先将该机器人与另一个工作区断开。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
connector_not_available
- 含义
- 此工作区的套餐不包含连接助手(Claude、ChatGPT)。
- 最常见的原因
- 该工作区所用套餐不含已连接的助手。
- 如何处理
- 请升级到包含已连接助手的套餐(设置 › 组织),然后重新连接助手。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
connectors_disabled
- 含义
- 工作区的所有者或管理员已关闭已连接的助手。
- 最常见的原因
- 已连接的助手在“设置 › 访问”中处于关闭状态。
- 如何处理
- 请让所有者或管理员在“设置 › 访问”中开启已连接的助手。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
missing_token
- 含义
- 调用连接器端点时没有提供访问令牌。
- 最常见的原因
- 助手尚未连接到 Azoth,或是手动发起的调用。
- 如何处理
- 请在助手自身的设置中将其连接到 Azoth:它会登录并获得令牌。
- 由谁处理
- 调用方代码的开发者
invalid_token
- 含义
- 调用连接器端点时使用的访问令牌不被接受:已过期、已撤销、格式错误或为其他地址签发。
- 最常见的原因
- 该连接已被本人移除、令牌已到期,或部署的地址已更改。
- 如何处理
- 请在助手自身的设置中重新将其连接到 Azoth:它的访问令牌已过期或已被撤销。
- 由谁处理
- 调用方代码的开发者
insufficient_scope
- 含义
- 该访问令牌不具备连接器所需的读取权限。
- 最常见的原因
- 授予连接时未包含对工作区的读取权限。
- 如何处理
- 请在助手自身的设置中重新将其连接到 Azoth,并授予它读取工作区的权限。
- 由谁处理
- 调用方代码的开发者
missing_client
- 含义
- 连接请求未指明任何客户端,因此无法连接该助手。
- 最常见的原因
- 指向同意页面的链接不完整。
- 如何处理
- 请在助手的设置中重新开始连接。
- 由谁处理
- 调用方代码的开发者
unknown_client
- 含义
- 连接请求指明了一个 Azoth 不认识的助手。
- 最常见的原因
- 该助手从未在此部署注册,或其注册已被删除。
- 如何处理
- 请在助手的设置中重新开始连接,以便它重新注册。
- 由谁处理
- 调用方代码的开发者
invalid_redirect_uri
- 含义
- 连接请求的返回地址不是该助手声明过的地址,因此 Azoth 不会向那里发送任何内容。
- 最常见的原因
- 链接被修改,或助手的返回地址已更改。
- 如何处理
- 请在助手的设置中重新开始连接。
- 由谁处理
- 调用方代码的开发者
connector_not_installed
- 含义
- 此工作区和环境未安装 Inventory Object 连接器,因此未保存任何内容。
- 最常见的原因
- 该批次所指环境从未安装过该连接器,或连接器已被暂停。
- 如何处理
- 请为此环境安装连接器(连接器),或将该批次发送到已安装连接器的环境。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
connector_revoked
- 含义
- 此连接器已被卸载,因此无法批准:卸载永远不会被撤销。
- 最常见的原因
- 所有者或管理员已将其卸载——在批准之前,或在针对它的双人审批请求等待期间。
- 如何处理
- 请重新安装该连接器:它将作为一次新的安装从头开始;如果此工作区要求审批,则需等待审批。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面
connector_governance_failed
- 含义
- 测试导入期间连接器的治理检查失败,因此未保存测试行。
- 最常见的原因
- 连接器配置有问题,或数据库出现短暂故障。
- 如何处理
- 请稍后重新运行测试。如果仍然失败,请联系支持团队:服务器日志会写明原因。
- 由谁处理
- Azoth,或此部署的运营方
repository_not_found
- 含义
- 此工作区的 GitHub 连接中没有使用此 ID 的代码仓库。
- 最常见的原因
- GitHub 应用已无法访问该仓库,或使用了另一个工作区的 ID。
- 如何处理
- 请在“设置 › 集成与告警”中重新加载仓库,然后从中选择一个。
- 由谁处理
- 工作区的所有者或管理员 · 打开相关页面