连接飞书通讯录

    1

    创建飞书应用

    2

    在 Authing 中配置飞书通讯录

    3

    从飞书中同步组织机构到 Authing

    创建飞书应用
    1. 如果你还没有开通飞书开发者账号，请先前往飞书开放平台 (opens new window)创建一个开发者账号；
    2. 在开发者后台 (opens new window)，点击「创建企业自建应用」；
    3. 输入应用名称和应用描述（可以随意填写），并上传 Logo；

    1. 点击「确定创建」按钮。
    获取应用凭证

    创建完成之后，点击刚刚创建的应用，进入应用详情页面：

    1. 在飞书应用详情的凭证和基础信息页面，你可以获取到该应用的 App ID 和 App Secret，复制这两个值；
    2. 在 Authing 控制台 (opens new window) 的连接身份源 - 企业身份源 页面，找到 飞书通讯录；

    1. 将 App ID 和 App Secret 填入表单：

    1. 点击「保存」按钮。
    配置事件订阅（可选）

    配置完成事件订阅之后，在飞书组织机构的操作（如部门的增删改查、用户的增删改查）将会实时同步到 Authing 组织机构，如果你不需要此功能，可以跳过。

    1. 在飞书应用详情的事件订阅页面，配置事件订阅；
    2. 确定是否启用 Encrypt Key，如果你对消息内容的安全级别要求较高，可以通过与飞书开放平台约定密钥的方式进行消息加密；飞书开放平台推送事件时会使用该密钥对消息内容做对称加密，详情请见 飞书文档 - 订阅事件概述 (opens new window)。如果你不需要开启，可以跳过此步骤；如果需要，请继续阅读下面的步骤。
    3. 如果你还没有设置 Encrypt Key，点击重置按钮：

    1. 复制最新的 Encrypt Key 和 Verification Token，填入 Authing 控制台的配置表单：

    1. 将请求网址 URL 设置为：
    https://core.authing.cn/connections/enterprise/lark/<USERPOOL_ID>/events

    你需要将其中的 USERPOOL_ID 替换为你的用户池 ID。

    你需要勾选以下事件：

    • 用户状态变更；
    • 部门新建；
    • 部门被删除；
    • 部门信息变化；
    • 通讯录范围权限被更新；
    • 员工入职；
    • 员工离职；
    • 员工信息变化；
    • 用户组被创建；
    • 用户组被删除；
    • 用户组信息变化；

    最后点击保存。

    应用申请权限
    1. 在飞书应用详情的权限管理页面，选择该应用所需的权限，如：
    • 获取用户邮箱；
    • 获取用户手机号；
    • 获取用户 userid；
    • 通过手机号或者邮箱获取用户 ID；
    • 获取用户基本信息；
    • 获取用户统一 ID；
    • 以应用身份访问通讯录；

    设置权限之后，你需要发布最新版本。

    发布应用
    1. 在飞书应用详情的版本管理与发布页面，点击右上角的创建版本：

    1. 填写应用版本号（格式如 1.0.0）和更新说明，设置可用性状态为所有员工可见，最后点击保存：

    如果可用性状态非所有员工可见，导入组织机构的时候会提示 获取飞书组织机构部门失败。

    1. 保存之后，点击申请发布：

    1. 提交申请后，你的企业管理员会进行审核，审核结果会通过飞书和开发者后台发送给你。详情请见飞书文档 - 开发企业自建应用 (opens new window)。
    回到列表