为了识别用户身份，三方业务系统和智书合同对接时，目前按照飞书开放平台的设计，双方系统可以通过user_id 来识别企业员工的唯一身份，租户可以在“飞书开放平台”单独创建一个自建应用，配置在智书合同中，以便智书合同能获取到员工的 user_id，从而识别三方系统传入的 user_id 的身份。

如果选择自建应用的方式进行对接，可参考以下步骤创建自建应用。仅开通第一个开放平台应用时需要创建自建应用，后续再开通开放平台应用时，无需再次创建自建应用。

1. 进入飞书开发者后台

https://open.feishu.cn/app

2. 创建自建应用

图（1）

请注意，应用的通讯录权限范围必须是全部成员，否则开放平台无法完成人员的自动匹配，请给应用的权限授权为全部成员。具体配置入口见图（2）图（3）所示。

图（2）

图（3）
若您的租户没有该页面参考右侧的图片

3. 开通自建应用相应的权限

开通权限入口如图（4）或图（5）所示

序号	分组	编码	名称	等级	版本	应用场景举例	目的
1	事件订阅	event:ip_list	获取事件的出口IP	普通	1.0.0	系统层面获取事件的出口IP后在回调服务的访问控制中配置IP白名单	以便给事件回调服务设置IP白名单
2	通讯录	contact:contact.base:readonly	获取通讯录基本信息	普通	1.0.0	查询用户、部门基本信息	-
3	通讯录	contact:department.base:readonly	获取部门基础信息	普通	1.0.0	获取：部门名称、部门状态	-
4	通讯录	contact:department.organize:readonly	获取通讯录部门组织架构信息	高级	1.0.0	获取：部门直属成员数、部门在同级部门中的排序、部门负责人ID	-
5	通讯录	contact:user.base:readonly	获取用户基本信息	普通	1.0.0	获取：用户名、用户英文名、用户头像	-
6	通讯录	contact:user.employee_id:readonly	获取用户user ID	普通	1.0.0	获取：用户user_id	-
7	通讯录	contact:user.department:readonly	获取用户组织架构信息	高级	1.0.0	获取：用户归属的部门ID 、用户的直属上级ID 、用户在其直属部门内的排序、用户多个部门间的排序	-
8	通讯录	contact:user.department_path:readonly	获取成员所在部门路径	高级	1.0.0	获取用户的部门路径	-
9	通讯录	contact:user.dotted_line_leader_info.read	查看成员的虚线上级ID	高级	1.0.0	便于根据虚线上级配置审批流程	-
10	通讯录	contact:user.employee:readonly	获取用户受雇信息	高级	1.0.0	获取用户的status（状态）、employee_type（人员类型）	-
11	应用信息	application:application:self_manage	管理应用自身资源	普通	1.0.0	获取应用被授权的通讯录范围	-
12	企业信息	tenant:tenant:readonly	获取企业信息	普通	1.0.0	获取企业编号（display_id、F码）、tenant_key	-

图（4）

图（5）

JSON:可直接将以下json导入自建应用

4. 飞书自建应用配置事件订阅地址

配置飞书自建应用事件订阅地址，以便飞书组织架构和智书平台组织架构数据同步
【重要】在配置监听地址之前，Encrypt Key 必须保持未设置状态。如果已设置 Encrypt Key 可以先清空，配置完事件监听地址后再配置 Encrypt Key。

事件监听地址是一个url
https://contract.qfei.cn/api/public/feishu-event/{飞书自建应用的appid}/encrypted
配置事件监听地址后，开通以下通讯录事件监听权限。配置地址如图（6）所示
请注意：在订阅开放平台事件的时候如果想要进行加密传输数据，则需要先配置事件监听地址，然后再生成Encrypt Key。不然无法配置事件订阅地址，如果已经生成的 Encrypt Key 则需要先清空 Encrypt Key。

图（6）
需要开通的事件列表

5. 发布应用

1. 保存并发布该飞书应用，即可开始调试智书开放平台相关接口。

1、创建版本

2、填写信息

3、申请发布

应用审批人为租户管理员（即超级管理员），而非飞书管理员。请在应用发布后，找租户内管理员进行审批。只有审批通过后，应用或者应用的配置修改才能生效

2. 开通智书开放平台对接App ID和App Secret

使用 https://ysi13ckdb9.feishu.cn/wiki/WP55wjUYPioY8xkvYoNc2ujrn3n 模版，在模版中填写该飞书自建应用的 app id 、 app secrect 、加密策略中的 Encrypt Key （可选）、 Verification Token 和本企业的租户名称和 F 码，并把文档发给到智书合同 CSM。智书合同CSM 会给接入方提供调用智书合同开放平台的另一个App id 和 App secrect 【补充在您提供的文档中，方便给到开发方技术使用】。该appi和app secret用于获取智书合同接口授权token

说明	示例	是否必填	字段英文名
租户名称	xxx	是	tenant_name
租户的F码	xxx	是	display_id
租户开通并且配置好授权的自建应用的App id	cli_aaaaaaaaaaaa	是	app_id
租户开通并且配置好授权的租户开通的自建应用的App Secret	xxx	是	app_secret
租户开通的自建应用的Encrypt Key（可选）	xxx	否	encrypt_key

说明	示例	是否必填	字段英文名
事件回调：开放平台应用需要的事件回调地址	xxxxx	是	subscription_url

6. 视频demo

点击查看：https://ysi13ckdb9.feishu.cn/wiki/TTpHwGfvwi3HC0kEun9chuwVnPp?from=from_copylink

【识别用户身份】选择自建应用的方式快速对接

1. 进入飞书开发者后台#

2. 创建自建应用#

3. 开通自建应用相应的权限#

4. 飞书自建应用配置事件订阅地址#

5. 发布应用#

1. 保存并发布该飞书应用，即可开始调试智书开放平台相关接口。#

2. 开通智书开放平台对接App ID和App Secret#

6. 视频demo#