本文介绍毕升office v4版本中单点登录功能的使用。
毕升Office系统支持OAuth2.0协议类型的单点登录配置。
¶ SSO设置
管理员用户在系统设置页面可进行单点登录的相关设置，设置页面如下。
¶ 设置项目说明
- 启用SSO认证
设置系统是否开启单点登录功能，单点登录流程请参考单点登录流程说明。
开启后，用户登录时将使用SSO进行认证，同时禁止新用户的注册，登录时，毕升Office系统中不存在的用户将进行创建；关闭后，用户可使用系统默认密码进行登录。
ROOT用户登录时不使用SSO认证，管理员用户可使用毕升Office系统原有的登录界面进行登录。
非ROOT用户使用毕升Office原有的登录界面登录时，会提示错误信息，禁止登录。
LDAP设置和SSO设置不能同时设置为开启的状态。
- 导入目标通讯录
必须设置项目，设置登录时，创建新用户所属的默认通讯录。 - Token 端点
必须设置项目，设置获取AccessToken的地址，AccessToken用于换取用户信息。毕升Office系统将会向此地址发送POST请求，以FORM形式传递相关参数，最终获取AccessToken信息。获取信息案例如下：{ "access_token": "0a3db4881d3adaf40c552bffe72b2c2e1ac4f8bb", "token_type": "Bearer", "expires_in": 1209599, "refresh_token": "b68e1b8f21a7f281455e9723dcd8a395dceb4c32", "scope": "user" } - 用户信息端点
必须设置项目，设置获取用户信息的地址，用户信息用于后续的创建、更新用户和在毕升Office的登录授权处理。毕升Office系统将会向此地址发送POST请求，获取用户信息。获取信息案例如下：{ "updated_at": "2023-06-28T01:59:46.604Z", "phone_number": "18000000000", "gender": "U", "email": null, "website": null, "picture": "avatarurl", "profile": null, "sub": "64914c836e68b833b5aienxy", "external_id": null, "unionid": null, "username": "test001" } - 登出端点
登出毕升Office系统时，将向此地址调用此GET请求，用于登出SSO用户。 - 登录回调URL
必须设置项目，设置为http:{yourhost}/apps/api/auth/sso/oauth即可。 - App ID
必须设置项目，设置单点登录应用的App ID。 - App Secret
必须设置项目，设置单点登录应用的App Secret。 - 授权类型
必须设置项目，设置为authorization_code即可。 - 用户ID属性名
必须设置项目，设置登录用户的ID属性名。如设置为sub，sub属性值将作为用户ID，值需要为字符串类型，在毕升Office系统中使用。 - 用户属性对应关系
设置用户属性的对应关系，用于在毕升Office系统中创建或更新用户信息。应设置为用户信息JSON数据中对应的Key。
¶ 单点登录流程说明
¶ 登录流程
¶ 登出流程
