You need to enable JavaScript to run this app.
导航
飞书认证排障指南
最近更新时间:2025.11.14 16:29:28首次发布时间:2025.11.14 16:29:28
复制全文
我的收藏
有用
有用
无用
无用

本指南旨在解决终端用户使用飞书账号登录飞连时,可能遇到的问题,包括:

  • 登录时提示用户无权限、用户不存在等。
  • 客户端无法加载登录配置、浏览器认证失败、客户端认证失败。

排查前建议

请先阅读身份认证常见问题,确认您遇到的问题是否已有对应的快速解决方案。若上述文档未能解决您的问题,请遵循本文提供的排查步骤进行深度诊断。

排查步骤
  1. 参考配置飞书第三方登录(飞书作为认证源)配置文档,检查当前配置。

    说明

    部分旧版本中推荐的权限可能在新版飞书中已无法开通,可忽略。

    请着重检查应用权限配置,可点击批量导入/导出权限,输入以下权限进行验证:

    {
      "scopes": {
        "tenant": [
          "admin:admin_dept_stat:readonly",
          "admin:admin_user_stat:readonly",
          "admin:app.user_usable:readonly",
          "application:application.contacts_range:write",
          "contact:contact",
          "contact:contact.base:readonly",
          "contact:department.base:readonly",
          "contact:department.organize:readonly",
          "contact:group:readonly",
          "contact:role:readonly",
          "contact:user.base:readonly",
          "contact:user.department:readonly",
          "contact:user.email:readonly",
          "contact:user.employee:readonly",
          "contact:user.employee_id:readonly",
          "contact:user.gender:readonly",
          "contact:user.id:readonly",
          "contact:user.phone:readonly",
          "corehr:authorization:read",
          "corehr:department.cost_center_id:read",
          "corehr:department.custom_fields:read",
          "corehr:department.manager:read",
          "corehr:department.operation_log:read",
          "corehr:department.organize:read",
          "corehr:department:read",
          "corehr:security_group:read",
          "directory:department.idconvert:read",
          "directory:department:list",
          "directory:department:read",
          "directory:employee.work.staff_status:read",
          "directory:employee:read",
          "passport:session_mask:readonly"
        ],
        "user": [
          "contact:user:search"
        ]
      }
    }
    
  2. 检查应用可用范围
    若上述通讯录权限选择的与应用权限保持一致,则需着重检查应用可用范围是否包含了失败的用户。
    Image

(可选)相关问题后续预防举措
  • 配置飞书认证,需要完全按照飞书上的参数进行配置。
  • 需要将飞书用户同步到飞连进行登录。

仍无法解决?
  • 如果您是飞连认证渠道工程师:请通过飞书搜索飞连 FOC,提交工单处理。
  • 如果您是企业用户:请通过火山引擎官网提交工单处理。