SSO登录

## 配置SSO单点登录基本步骤

### 1、前言
本文档身份提供商（IdP）是以“authing平台”为例进行编写的，其他平台创建、设置的方式可能和文档的内容会有存在出入的情况，请以实际使用平台的规则为准进行创建和设置。
### 2、创建应用

登录并访问["authing平台"](https://console.authing.cn/)，找到可以创建应用的地方并进行使用。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_154418_0827360.9686902757893072.png)

点击右上角的“创建自建应用”，并在弹窗内填写以下信息：

- 选择应用（“标准Web应用”）
- 应用名称（建议名称具有辨识度）
- 认证地址（建议可以使用自己网站的域名）

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_154613_0990250.1744510012623467.png)

点击“创建”后，即可完成应用的创建。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_160538_0461070.4408825612904349.png)

### 3、协议配置

找到“协议配置”-“授权配置”，选择“SMAL2.0”，打开“启用 SAML2 Provider”的开关，并填写“ACS地址”，进行保存。
（其他平台找到可以**配置SAML协议**的地方并在配置填入**“ACS地址”**，将协议勾选为**“SMAL2.0”**即可。）

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_160910_9685480.6482043184069669.png)

> 如何获取ACS地址？
登录并访问[“CloudLinker平台”](https://csos.cloudcare.cn/console.html#/login)，找到“配置”-[“团队管理-SSO标签”](https://csos.cloudcare.cn/console.html#/settings/team?type=sso)，找到“断言地址”，将该地址复制到“ACS地址”内并保存。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-11-11_150527_3073270.6459281517338763.png)

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_154924_6999510.4978708536317292.png)

> 将默认协议类型勾选为“SAML2”

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_155002_6045370.8835545075239378.png)

### 4、下载元数据文档
找到“SAML2 元数据文档”的位置并进行下载。
（保留好该文档，后续会用到）

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_160658_4047540.10362485161013213.png)

### 5、登录控制配置

> 根据需求自行选择登录注册分离或者登录注册合并以及采用哪些认证方式进行登录和注册。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_160744_1937170.11053329722128946.png)

### 6、访问授权配置

> 根据需求自行选择需要授权的范围即可。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_160813_3012490.5047651394182451.png)

### 7、平台配置SSO
登录并访问[“CloudLinker平台”](https://csos.cloudcare.cn/console.html#/login)，找到“配置”-[“团队管理-SSO标签”](https://csos.cloudcare.cn/console.html#/settings/team?type=sso)。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-11-11_143516_7868450.039372173780592434.png)

点击“单点登录SSO”，并填写以下信息：
- 单点登录开关（打开）
- 启用账密登录（禁用后无法使用账号密码登录）
- 类型（SAML 2.0）
- 身份供应商（authing）
- 元数据文档（上传第四步中下载的元数据文档）
- 访问限制（添加可以访问的邮箱域名）

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-11-11_143857_9781930.46851741415593107.png)

点击保存，即可完成“单点登录SSO”的配置。

### 8、测试登录
#### 方法一
复制“单点登录SSO”的“登录地址”。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-11-11_150042_4753310.8473995576561838.png)

在标签页内输入复制的地址，并点击回车，会自动跳转到authing平台的配置的应用页面。

> 当前端发起链接请求到服务器，服务器会拿该地址去解析并确认是否匹配数据文档内的认证信息，当认证信息匹配时，则自动跳转到“authing”平台。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2025-09-10_160240_1966710.2767359257361315.png)

选择要登录的手机号/邮箱号，并进行注册和登录，校验完成后会自动跳转到CloudLinker平台的首页。

（因为前面选择的“登录和注册合并”，所以登录和注册页面是在一起。如果手机号/邮箱是在CloudLinker平台内可以匹配成功的话，则登录绑定该手机号或者邮箱的账号；如果该手机号/邮箱是CloudLinker平台中匹配不上的话，会自动创建新的账号。）

> authing平台账号登录或注册校验通过后，会去判断authing平台上配置的ACS地址是否与断言地址一致；如果一致，则自动登录CloudLinker平台并跳转到首页。

#### 方法二
登录并访问[“CloudLinker平台”](https://csos.cloudcare.cn/console.html#/login)，输入团队代码后，下方会展示“SSO登录”的按钮，勾选“用户协议、隐私政策”后点击“SSO登录”按钮，后续与方法一类似，在此不做赘述。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-11-11_145735_4646900.33349203518885395.png)

### 9、注意事项
如碰到部分身份提供商（IdP）要求填写服务提供商（SP）的唯一标识，CloudLinker平台的唯一标识为“登录地址”。

![](https://static.cloudcare.cn/cloudcare-mrdoc/img/2026-11-11_150042_4753310.8473995576561838.png)