飞书配置

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

本文介绍如何配置飞书,以便阿里云盘企业版能够同步飞书内的组织结构及用户。配置完成后,用户将能够使用飞书账号直接登录阿里云盘企业版,从而实现云盘内用户和团队的便捷管理。

前提条件

操作步骤

步骤一:获取飞书信息

  1. 飞书创建企业自建应用

    1. 登录飞书开放平台

    2. 在页面顶部导航栏,单击开发者后台

    3. 单击创建企业自建应用。填入应用信息,单击创建

      image

    4. 创建成功后会自动跳转到飞书应用详情。

  2. 配置重定向URL。

    在飞书应用详情页面内的左侧导航栏,选择开发配置>安全设置,添加重定向URL

    重要

    实际填写时,将domainId替换为企业代码

    请根据阿里云盘企业版创建时间选择示例:

    • 创建时间在20230302日及之后,回调地址格式为https://domainId.api.aliyunfile.com/v2/oauth/callback

    • 创建时间在20230302日之前,回调地址格式为https://domainId.auth.aliyunfile.com/v2/oauth/callback

  3. 开启所需权限

    1. 在左侧导航栏,选择开发配置>权限管理

    2. 单击开通权限

    3. 选择应用身份权限>通讯录

    4. 将通讯录权限全部勾选。单击确认开通

      image

    5. 权限可访问的数据范围修改为与应用的可用范围一致。单击确认

      image

  4. 发布应用

    1. 在左侧导航栏,选择应用发布>版本管理与发布

    2. 单击创建版本

    3. 填写应用版本号更新说明和设置可用范围

      可见范围可以设置全部成员部分成员。按需选择需要使用网盘的员工范围即可。

    4. 单击保存

      image

    5. 在右上角确认发布

      如应用需要审批,待审批完成后进行发布。

  5. 获取应用App IDApp Secret。

    1. 在左侧导航栏,选择基础信息>凭证与基础信息

    2. 保存应用凭证下的App IDApp Secret

      image

步骤二:启用飞书配置和配置飞书信息

  1. 启用飞书配置

    1. 登录企业文件管理,进入到管理控制台

    2. 在左侧导航栏选择专属登录配置>飞书配置,打开飞书配置开关。

  2. 配置登录信息。

    1. 在飞书配置页面,配置AppIDAppSecret

    2. AppID填入飞书App ID,在AppSecret填入飞书Client Secret。

      image

    3. 单击测试连接,界面会提示连接成功

    4. 单击下一步

  3. (可选)配置同步选项。

    • 如果不需要开启飞书同步功能,请跳过此步骤。

      如果不开启同步配置功能,仅启用飞书登录功能,任何组织范围内的飞书用户都可以登录企业云盘,在登录时自动创建账号,无组织结构。

    • 如果开启同步功能,则可导入钉钉内的用户和组织结构。具体配置步骤如下:

      • 在同步配置页面,打开同步配置开关并配置同步信息。

        警告

        同步范围变更时请谨慎操作。同步范围变更后,不在范围内的用户会被禁用(不会自动删除)。如果又将该用户划入同步范围内,该用户也不会自动变成启用,需要管理员手动将用户状态设置为启用。

        image

      • 单击配置检测

        可以检测同步的部门数量和员工数量,如果此步骤报错,请检查上一步的授权是否按要求完成。

      • 同步时间设置可以选择手动同步或者自动同步

        • 手动同步:手动同步组织或用户到云盘。使用手动同步时,如果原数据有更新,可能无法同步变更到云盘,此时需要再次手动执行同步操作。例如,在企业人员管理应用场景下,员工有新增,这些变更可能无法及时反映到服务中,导致新配置人员无法登录到云盘。

        • 自动同步:根据指定同步频率和时间将组织或用户同步到云盘。同步频率可设置为每日、每周或每月,同步时间可选择24小时中的任意整点时间。

      • 同步手机号/邮箱,按需开启,如果开启同步手机号/邮箱,则支持使用飞书手机号/邮箱登录。

        • 开启同步手机号,将同步员工在飞书的手机号,同步成功之后支持员工使用该手机号登录。

        • 开启同步邮箱,将同步员工在飞书的邮箱,同步成功之后支持员工使用该邮箱登录

  4. 查看导入结果。

    1. 单击立即同步

    2. 同步完成后会展示导入结果。如遇到导入失败情况,会在导入结果展示导入失败原因。

    image

  5. 查看上一次同步信息。

    上次同步信息区域,可查看上次同步时间上次同步状态。单击右侧详情,可查看上次同步详细信息。

    image

步骤三:使用飞书登录

  1. 企业专属登录界面,输入企业代码。单击飞书

    image

  2. 登录飞书并进行授权,进入阿里云盘企业版使用界面。

常见问题

使用飞书登录报错:20029 redirect_uri 请求不合法

请检查飞书应用重定向 URL配置是否正确。

相关文档