飞书单点登录和数据同步配置
# 说明
本文介绍飞书与IDaaS的认证配置和同步配置,实现IDaaS单点登录腾讯企业邮箱和IDaaS组织与用户数据同步至飞书。 飞书支持超级管理员配置基于 SAML 2.0 协议的 SSO 登录,即通过第三方认证中心单点登录至飞书系统。 适用版本:旗舰版。
配置参考飞书管理员如何配置单点登录 (opens new window)
# 认证配置
# IDaaS配置
- 1.登录IDaaS企业中心,添加飞书旗舰版预集成应用。
- 2.配置认证参数。
参数 | 说明 |
---|---|
SP Entity ID: | https://www.feishu.cn |
断言消费地址(ACS URL): | https://www.feishu.cn/suite/passport/authentication/idp/saml/call_back |
NameID | 应用账号 |
NameID Format | 默认 |
Audience URl | https://www.feishu.cn |
Single Logout URL | 不填 |
Relay State | 不填 |
Response签名 | 是 |
断言签名 | 是 |
数字签名算法 | 默认 |
数字摘要算法 | 默认 |
断言加密 | 否 |
验证请求签名 | 否 |
进入应用详情-认证配置-映射配置,添加一个email映射。
- 3.用户授权
账号名设置为飞书内用户的手机号或邮箱。
- 4.查看IDP配置 【设置】-【服务配置】-【IDP配置】
下面配置飞书SSO账号登录会用到IDP配置参数。
# 飞书配置
- 1.管理员登录飞书管理后台【企业设置】-【SSO账号登录】
- 2.编辑并启用SSO
- SAML 2.0 Endpoint:IDP配置的SSO URL
- Identity Provide Issuer:IDP配置的IDP EntityId
- Public Certificate:IDP 证书(去掉首尾的-----BEGIN CERTIFICATE----- 和-----END CERTIFICATE-----)
# 登录
电脑端和移动端皆可登录
- 1.打开飞书,点击“ SSO 登录”,输入飞书企业域名(【飞书管理后台】-【企业设置】-【企业信息】查看)。
- 2.跳转至IDaaS登录界面,输入授权账号登录信息,进入飞书。
# 同步配置
# 飞书配置
- 1.登录飞书开放平台--》开发者后台。
- 2.创建企业自建应用。
- 3.获取应用APP ID和APP Secret。
- 4.申请接口权限。
# 飞书配置扩展属性
1.登录 飞书管理后台 (opens new window)。进入组织架构->成员字段管理。
2.点击全局设置。
3.在弹出窗体中,开启 允许开放平台通讯录API调用,并点击确定。
4.点击新增字段。
5.在弹出窗体中,输入中文字段名、英文字段名,并选择字段类型为文本,点击确定。
注: 中文字段名对应IDaaS应用账号模型属性的显示标签,英文字段名可不填。 当前IDaaS只支持文本类型的扩展字段。6.此时,在页面可以看到刚刚创建的扩展属性。
# IDaaS配置
- 1.登录IDaaS企业中心。
- 2.添加预集成应用飞书身份同步。
3.配置应用参数。
- 应用id:APP ID
- 应用密钥 :APP Secret
- 4.授权应用机构。
进入应用详情-应用机构-授权策略。
开启机构自动授权,选择机构范围,点击保存按钮,然后点击执行新增。
- 5.授权应用账号。
进入应用详情-应用账号构-授权策略。
开启机构自动授权,选择用户范围,点击保存按钮,然后点击执行新增。
- 6.查看同步事件。
进入应用详情-同步事件
# 查看同步结果
登录飞书管理后台。
进入通讯录,查看同步的组织机构和用户。
# IDaaS配置扩展属性
1.登录IDaaS企业中心后。进入飞书应用首页->点击同步集成->配置。
2.进入飞书同步配置页面后,点击保存且保存成功。
3.点击对象模型->应用账号模型->右侧添加。
4.在右侧弹出窗体中,可在属性名下拉框中查看到在飞书配置的扩展属性
注:这里的扩展属性名格式为固定前缀"CUST-"+飞书平台扩展属性对应的内部ID。5.选择这个扩展属性,可以看到扩展属性的详细信息,并点击保存。
6.此时,在属性定义页面的尾端,可以看到刚刚保存的扩展属性。如需和系统用户的属性建立映射关系,请在映射定义配置。