|问题分类 |问题 | |---|---| |企业微信登录常见问题 |* [问题：登录页面提示“redirect_uri 与配置的授权完成回调域名不一致”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#DAQ2CuAQ)

* [问题：登录页面提示“第三方登录遇到以下问题failed sign in user: idp config error”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#DVqKAUI1)

* [问题：配置可信IP时提示“以下IP属于第三方服务商”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#pGEjVf3G)

* [问题：登录页面提示“appid参数错误”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#wFvVXoN9)

* [问题：企业微信域名认证失败](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#dxydnDKv) | |OAuth/OIDC登录常见问题 |* [问题：登录页面提示“第三方登录遇到以下问题”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#3HB85Xr8)

* [问题：登录页面提示“登录页面已经被设置为不展示”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#MkDCpbV9)

* [问题：登录页面提示“The requested redirect_uri is missing in the client configuration”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#bSu39nqa)

* [问题：用户登录后，ArkClaw用户列表显示用户信息为空](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#EBGbHITC) | |钉钉登录常见问题 |* [问题：登录页面提示“第三方登录遇到以下问题failed to fetch dingding access token: dingding API http error: status=400 Bad Reauest”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#dVRFOjX4)

* [问题：登录页面提示“出错了，应用不存在”](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#bqDG77L2) | |平台托管登录常见问题 |[问题：用户忘记密码后如何重置密码？](https://www.volcengine.com/docs/87732/2389859?lang=zh&TagIDs=2%2C522%2C512%2C502#OL8AJAYh) | ## 企业微信登录常见问题 ### 问题：登录页面提示“redirect_uri 与配置的授权完成回调域名不一致” 本问题通常表示企业微信中的授权回调域与实际登录地址不一致。 1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“空间概览”。 3. 单击企业微信免登授权码跳转地址后面的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_853b8594d5dded0729fe89fbec66a9dc.png) 图标复制信息，然后单击“去配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_328acb5892174f01a1472d1d9f5a5b2a.png) 4. 自动跳转至[企业微信官网](https://work.weixin.qq.com/)，在左侧目录树选择“应用管理 \> 应用”，单击自建的应用卡片进入应用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f0b3bd28f5518f9e178a87a8a12bd46a.png) 5. 下拉至页面底部，单击“企业微信授权登录”卡片的“设置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2898fdc0fdd55f7b2e080c9c50076897.png) 6. 单击“设置授权回调域”按钮，把从ArkClaw空间中复制的企业微信免登授权码跳转地址，粘贴至输入框中，然后单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ea989ac74ec9a64225887906359bfc64.png) ### 问题：登录页面提示“第三方登录遇到以下问题failed sign in user: idp config error” 本问题通常表示企业微信接口请求来源不在可信IP 白名单中。 1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“用户管理”。 3. 在页面右上角单击“编辑”按钮，复制可信 IP。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_85a12eec9528d88cf6daa82d7e00aec1.png) 4. 在[企业微信官网](https://work.weixin.qq.com/)设置可信域名页面，单击“确定”按钮。 5. 单击“企业可信IP”卡片的“配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cafdacdb44a6917769a7b63bdb7f5eb8.png) 6. 添加可信IP，单击“确定”按钮完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_075a65376259ac1f053eab247bd05556.png) ### 问题：配置可信IP时提示“以下IP属于第三方服务商” 本问题通常表示企业微信侧对该IP做了额外限制校验。 1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“用户管理”。 3. 在“登录配置”页签右上角单击“编辑”按钮，复制可信 IP。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_85a12eec9528d88cf6daa82d7e00aec1.png) 4. 在[企业微信官网](https://work.weixin.qq.com/)设置可信域名页面，单击“确定”按钮。 5. 单击“企业可信IP”卡片的“配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cafdacdb44a6917769a7b63bdb7f5eb8.png) 6. 输入从ArkClaw企业版控制台“用户管理 \> 登录配置”中获取的企业可信IP，并删除其他可信IP，单击“确定”按钮完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_075a65376259ac1f053eab247bd05556.png) ### 问题：登录页面提示“appid参数错误” 本问题通常表示应用相关配置项有误。 1. 在[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)“空间概览”中单击“去配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_328acb5892174f01a1472d1d9f5a5b2a.png) 2. 自动跳转至[企业微信官网](https://work.weixin.qq.com/)，在左侧目录树选择“应用管理 \> 应用”，单击自建的应用卡片进入应用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f0b3bd28f5518f9e178a87a8a12bd46a.png) 3. 在左侧导航树单击“我的企业”，下拉至页面底部，获取企业ID。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9856b18b082b8ab798f84d54b770c8e5.png) 4. 在左侧导航树单击“应用管理 \> 应用”，在自建应用部分单击已创建的企业应用名称，在详情页面获取应用AgentId。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_91bf4130f160faf9772367455bd5e9ab.png) 5. 在同一个页面，单击Secret的“查看”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bdae7c68d745166a915dddb4357eb940.png) 6. 在弹出的对话框中单击“发送”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_405dc744f193a21a56f0e64379cbc890.png) 7. 在企业微信APP中接收“企业微信团队”推送的信息，点击“前往查看”按钮，获取应用Secret信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ac50ddfbc5cbd84c34289dd278ab75aa.png) 8. 返回[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)，在左侧导航树中，选择“用户管理”。 9. 在“登录配置”页签右上角单击“编辑”按钮， 10. 对照企业微信侧应用信息，逐项检查企业 ID、Agent ID、Agent Secret是否填写正确。 ### 问题：企业微信域名认证失败本问题通常表示域名绑定链路未完成。 1. 在[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)把您的企业可信域名、域名证书信息配置到自定义域名中。**您需要自行准备企业可信域名、域名证书信息**，先配置自定义域名，然后配置[CNAME记录](https://www.volcengine.com/docs/87732/2301388?lang=zh#dv5ftG9z)。

说明

企业微信进行域名验证时，需配置备案主体与当前企业主体相同或存在关联关系的域名。因此，您在自己的域名服务商中，注册或者创建一个子域名，然后把该域名配置到ArkClaw控制台，并配置CNAME记录，详细操作请参见配置企业自定义域名（旧版）/配置企业自定义域名（新版）。

2. 在[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)“空间概览”中单击“去配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_328acb5892174f01a1472d1d9f5a5b2a.png) 3. 自动跳转至[企业微信官网](https://work.weixin.qq.com/)，在左侧目录树选择“应用管理 \> 应用”，单击自建的应用卡片进入应用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f0b3bd28f5518f9e178a87a8a12bd46a.png) 4. 单击“网页授权及JS\-SDK”卡片的“设置可信域名”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_acd020e8e2d8d6fa423e461ea0a39fe6.png) 5. 单击“申请校验域名”按钮，然后单击“下载文件”按钮，会下载域名校验文件“WW_verify_NPhdTFaSSUquSsPu.txt”到本地。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7cbf3c3ed476a778f98447e3dde38e65.png) ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e0532ccdf317b5e3b735f2a98469f97e.png) 6. 前往[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)，在左侧导航树选择“用户管理”，在“登录配置”页签下单击“编辑”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bd96cfae66c9aa60cc448fc9489f8c75.png) 7. 单击“上传文件”按钮上传“WW_verify_NPhdTFaSSUquSsPu.txt”文件进行校验，校验通过后会返回企业可信IP的信息，复制企业可信IP并单击“配置已完成”关闭弹窗，然后单击页面底部“保存”按钮保存配置。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3c37189e7997ad7e806aa2cc48351d98.png) 8. 在企业微信应用的“设置可信域名”页面，粘贴上文“步骤一”中配置的企业自定义域名（需去掉`https://`），然后单击“确定”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_dde2af9ad39dea33cbf50ab48cb7ee51.png) ## OAuth/OIDC登录常见问题 ### 问题：登录页面提示“第三方登录遇到以下问题” 请结合页面中的具体错误关键词继续定位。本章节以OAuth 2.0协议为例。 |**错误关键词** |**常见原因** |**建议您优先检查** | |---|---|---| |404 not found / no such host |令牌端点或用户信息端点地址填写错误，或目标地址不可访问。 |端点URL是否完整、可访问，是否误填域名、路径或协议。 | |failed to get user id |用户唯一标识字段配置错误，或身份源返回结果中缺少该字段。 |用户唯一标识字段名称、返回数据中的实际字段值。 | |invalid client_id / client_secret |客户端凭据填写错误。 |Client ID、Client Secret 是否正确且无空格。 | 1. 登录[火山引擎智能体身份和权限管理平台](https://console.volcengine.com/identity)，在左侧导航栏，选择“身份管理 \> 用户池”。 2. 单击目标用户池查看用户池信息。 3. 复制“OIDC 发现端点 Discovery URL”，然后使用浏览器打开。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d85c2de51d0c73dfd0a5c0217c2351b9.png) 4. 启用美观输出，获取以下端点信息，用于后续配置协议认证参数，以实现访问管理授权。 * **authorization_endpoint**：授权端点 * **token_endpoint**：令牌端点 * **userinfo_endpoint**：用户信息端点

说明

scopes_supported 可用于配置授权范围。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_57516f18672c8946b84c5767066006de.png) 5. 在左侧导航栏，选择“身份管理 \> 用户池”。继续单击目标客户端名称，获取客户端 ID（Client ID）和客户端密钥（Client Secret）。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f7fde52ae13eaa16331f5d7b64ba604a.png) 6. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 7. 在左侧导航树中，选择“用户管理”。 8. 在“登录配置”页签右上角单击“编辑”按钮，检查配置信息是否有误。 * **用户信息端点**：配置是否与查询到的信息一致；格式是否正确，没有空白字母，且是一个正式的**https://** 或**http://** 的URL。 * **用户唯一标识**：确保填写的内容无误，没有多余的标点或者空格。 * **Client ID和Client Secret**：配置是否与查询到的信息一致，尤其查看有没有多余的空格。 ### 问题：登录页面提示“登录页面已经被设置为不展示” 本问题通常需要优先检查issuer配置。 1. 登录[火山引擎智能体身份和权限管理平台](https://console.volcengine.com/identity)，在左侧导航栏，选择“身份管理 \> 用户池”。 2. 单击目标用户池查看用户池信息。 3. 复制“OIDC 发现端点 Discovery URL”，然后使用浏览器打开。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d85c2de51d0c73dfd0a5c0217c2351b9.png) 4. 启用美观输出，获取 Issuer 信息。

说明

scopes_supported 可用于配置授权范围。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_65cecb8e1140f9c48a9a00e4f2953d61.png) 5. 在[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)左侧导航树中，选择“组织管理 \> 用户管理”。 6. 在用户管理页面，选择“登录配置”页签，在“基础配置信息”区域单击“编辑”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_181b2ac64f0f27605a64a7a0f59f9d93.png) 7. 将之前获取的Issuer信息正确填写至配置信息中。 ### 问题：登录页面提示“The requested redirect_uri is missing in the client configuration” 本问题通常表示用户没有在OAuth 应用或Userpool 配置重定向URL。 1. 在[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)左侧导航树中，选择“空间概览”，单击标准协议（OIDC）免登授权码跳转地址后面的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_853b8594d5dded0729fe89fbec66a9dc.png) 图标复制信息。 2. 登录[火山引擎智能体身份和权限管理平台](https://console.volcengine.com/identity)，在左侧导航栏，选择“身份管理 \> 用户池”。 3. 单击目标用户池名称，切换至客户端页签。 4. 编辑客户端信息，将复制的免登授权码跳转地址粘贴至“允许回调 URIs”，单击“确定”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7ef5b3626326e6b4ab5fba65ee323e86.png) ### 问题：用户登录后，ArkClaw用户列表显示用户信息为空本问题通常表示登录配置时没有添加对应的授权范围，导致无法获取用户的信息。 1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“用户管理”。 3. 在“登录配置”页签右上角单击“编辑”按钮，检查配置的授权范围。例如Identity IDP的scope为profile、email和phone。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fc82aa79b9f7e1b7b024a0a3c6f755b0.png) ## 钉钉登录常见问题 ### 问题：登录页面提示“第三方登录遇到以下问题failed to fetch dingding access token: dingding API http error: status=400 Bad Reauest” 本问题通常表示客户端凭据配置有误。 1. 在[钉钉开发者平台](https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app)，单击应用名称，进入用于企业系统权限的钉钉应用开发页面。 2. 在左侧导航树，选择“基础信息 \> 凭证与基础信息”，复制并保存App ID、Client ID和Client Secret。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b74406775aab206d3dc1f04178fa140d.png) 3. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 4. 在左侧导航树中，选择“用户管理”。 5. 在“登录配置”页签右上角单击“编辑”按钮，对照检查App ID、Client ID和Client Secret是否与当前应用一致，例如关注是否有多余的空格。 ### 问题：登录页面提示“出错了，应用不存在” 本问题通常表示钉钉应用配置和平台实际使用的参数不一致。 1. 在[钉钉开发者平台](https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app)，单击应用名称，进入用于企业系统权限的钉钉应用开发页面。 2. 在左侧导航树，选择“基础信息 \> 凭证与基础信息”，复制并保存App ID、Client ID和Client Secret。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b74406775aab206d3dc1f04178fa140d.png) 3. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 4. 在左侧导航树中，选择“用户管理”。 5. 在“登录配置”页签右上角单击“编辑”按钮，对照检查App ID、Client ID和Client Secret是否与当前应用一致，例如关注是否有多余的空格。 6. 在左侧导航树中，选择“空间概览”，单击钉钉免登授权码跳转地址后面的![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_853b8594d5dded0729fe89fbec66a9dc.png) 图标复制信息，然后单击“去配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a831e8e2a150b0526a446e4f9fa58699.png) 7. 将自动跳转至[钉钉开发者平台](https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app)配置了企业系统权限钉钉应用的“安全配置”页面。 8. 把从ArkClaw空间中复制的钉钉免登授权码跳转地址粘贴至重新定向URL中，单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_58238445aa9bfe2362cfff308e7afd47.png) ## 平台托管登录常见问题 ### 问题：用户忘记密码后如何重置密码？在平台托管认证方式下，用户如需重新获取登录密码，可通过以下两种方式处理： * **用户自助重置密码**：若用户已绑定有效手机号，可在登录页通过手机号短信验证码自助找回密码，无需管理员介入。 * **管理员代为重置密码**：若用户未绑定手机号，或手机号暂不可用，管理员可通过用户管理功能为用户重置登录密码。 #### 方法一：用户自助重置密码 1. 用户打开浏览器，在浏览器地址栏中输入登录ArkClaw的链接，按“回车”键打开链接。 2. 在打开的页面，单击“立即体验”按钮进入登录页。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bf488a87047c28af9d9346994e55641f.png) 3. 在登录页面，单击“忘记密码”按钮，通过绑定手机号接收短信验证码，自主完成身份核验并重置密码。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cdcb20b51637ff7ed97938a7df8e77a2.png) #### 方法二：管理员代为重置密码 1. 管理员登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 左侧导航树中，选择“组织管理 \> 用户管理”。 3. 在用户管理页面，选择“全员列表”页签，单击目标用户操作列中的“重置密码”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_aadf284d6a1e97d6565c202522310c03.png) 4. 在弹出的对话框中单击“重置”按钮，确认重置用户密码。 5. 在弹出的对话框中，单击![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_63c193a480ce090a432f5bbb65b83c5e.png) 将新密码复制到剪贴板，确认已妥善保管后单击“我已知晓”按钮，完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6b45adcc34f41d692b66e4bc990a1d20.png)

说明

单击“我已知晓”按钮并关闭对话框后，将无法再次查看该密码，若未及时保存或遗忘密码，管理员可再次重置密码。

重置密码完成后，请通过企业内安全渠道将新密码尽快传递给目标用户，并提醒用户首次登录后立即修改为自定义密码。

ArkClaw 企业版