• 博客园logo
  • 会员
  • 周边
  • 新闻
  • 博问
  • 闪存
  • 赞助商
  • Chat2DB
    • 搜索
      所有博客
    • 搜索
      当前博客
  • 写随笔 我的博客 短消息 简洁模式
    用户头像
    我的博客 我的园子 账号设置 会员中心 简洁模式 ... 退出登录
    注册 登录
记得承诺过
博客园    首页    新随笔    联系   管理    订阅  订阅

AIGC标识 统一认证SSO原理介绍

身份认证,统一认证

# 统一认证(SSO 单点登录)原理与实现详解

> 版本:v1.0 | 适用读者:系统架构师 / 后端开发 / 运维 | 主题:登录一次,多系统免密登录的内部机制

## 目录
1. [概念总览](#1-概念总览)
2. [核心原理:身份只校验一次](#2-核心原理身份只校验一次)
3. [免密登录的根本机制:IdP 会话 Cookie](#3-免密登录的根本机制idp-会话-cookie)
4. [主流实现协议对比](#4-主流实现协议对比)
5. [CAS:票据(ticket)如何生成与校验](#5-cas票据ticket如何生成与校验)
6. [OIDC:授权码与 ID Token 如何生成与校验](#6-oidc授权码与-id-token-如何生成与校验)
7. [SP 如何用票据匹配本地用户](#7-sp-如何用票据匹配本地用户)
8. [匹配键的约定(账号打通的关键)](#8-匹配键的约定账号打通的关键)
9. [完整链路时序图(OIDC 授权码模式)](#9-完整链路时序图oidc-授权码模式)
10. [系统架构总览](#10-系统架构总览)
11. [常见坑点与安全要点](#11-常见坑点与安全要点)
12. [术语速查表](#12-术语速查表)

---

## 1. 概念总览

**统一认证**是一个身份管理体系的统称,其核心能力是 **SSO(Single Sign-On,单点登录)**:用户在身份中心登录一次,之后访问所有关联业务系统都免密登录。

核心一句话:

> **身份只在认证中心校验一次,各业务系统不再单独校验账号密码,而是信任认证中心签发并验证的身份凭证。**

### 两个容易混淆的概念
| 角色 | 说明 | 典型实现 |
|---|---|---|
| **IdP**(Identity Provider,身份提供者) | 权威中心,管理账号、密码、MFA,负责签发身份票据 | CAS、Keycloak、Authing、AD/LDAP、IDaaS、IAM |
| **SP**(Service Provider,服务提供者) | 各个业务系统,不存密码,只信任 IdP 的凭证 | OKR、OA、CRM、ERP、HR |

---

## 2. 核心原理:身份只校验一次

```
用户浏览器 → 业务系统A(SP) → 未登录 → 重定向到 IdP 统一认证中心
↓
校验账号密码 / MFA / 密码策略
↓
回调 A → A 校验 IdP 凭证 → A 创建本地会话 → 登录成功
用户访问业务系统B(SP) → 重定向 IdP → IdP 已有会话 → 直接发凭证 → B 免密登录
```

关键逻辑:
1. 用户首次访问系统 A,A 发现未登录,**不弹自己的登录页**,而是把浏览器重定向到 IdP。
2. 用户在 IdP 完成一次身份校验(账号密码 / 扫码 / 验证码 / MFA)。
3. IdP 在**自己域名下**种下会话 Cookie,并签发可信凭证回给 A。
4. A 校验凭证合法后,创建 A 自己的本地会话。
5. 用户再访问系统 B,B 同样重定向到 IdP;IdP 凭中心 Cookie 识别出已登录,**不再要求输密码**,直接发凭证给 B,实现免密。

> 限制说明:Cookie 受**浏览器同源策略(域名隔离)** 约束。若 IdP 与业务系统完全跨域且没有合适协议支持,流程会失效——这正是很多企业要求统一域名体系的原因。

---

## 3. 免密登录的根本机制:IdP 会话 Cookie

这是一个最容易混淆的关键点,必须分清两类 Cookie 的**域名隔离**。

假设:
- IdP:`sso.company.com`
- SP1(OA):`oa.company.com`
- SP2(OKR):`okr.company.com`

| Cookie 类型 | 归属域名 | 谁能读取 |
|---|---|---|
| **IdP 会话 Cookie(TGT Cookie)** | `sso.company.com` | 仅访问 IdP 域名时,浏览器自动携带;SP 的前端 JS 与后端**都读不到** |
| SP 自己的 Session Cookie | `oa.company.com` | 仅在访问 OA 时携带,与 IdP 无关 |

### 免密链路中 Cookie 何时出现
1. 访问 `okr.company.com`,OKR 发现自己本地无会话。
2. OKR 构造重定向地址跳转到 IdP:
```
https://sso.company.com/auth?client_id=okr&redirect_uri=https://okr.company.com/callback&scope=openid
```
⚠️ **SP 在这个跳转 URL 里不携带、也无法携带 IdP 的 Cookie**(SP 根本拿不到),只传 `client_id`、`redirect_uri`、`scope` 等参数。
3. 浏览器收到 302,**主动发起对 `sso.company.com` 的 GET 请求**。
4. 浏览器根据请求目标域名,自动检索并附上属于 `sso.company.com` 的 Cookie,放入请求头发给 IdP。
5. IdP 读取 Cookie,校验会话是否有效:
- 有效 → 不再展示登录页,直接发凭证回调 SP,实现**免密**;
- 无效 / 不存在 → 弹出登录页,要求输入账号密码。

> **一句话区分**:SP 只负责"把浏览器赶到 IdP 那里";**Cookie 是浏览器在访问 IdP 域名时自动捎带的,不是 SP 携带或传递的。**

### 第一次登录发生了什么
首次访问 OA → OA 重定向到 IdP → 浏览器请求 `sso.company.com` 时**还没有 IdP Cookie** → IdP 识别不到会话 → 返回登录页 → 用户输密码 → 校验成功后 IdP 在响应头 `Set-Cookie` 种下 IdP 域名的会话 Cookie。**从这一刻起,只要 Cookie 未过期、未被清除,后续所有 SP 跳转 IdP 时浏览器都会自动带上它。**

### 跨站 Cookie 限制(SameSite,最常见翻车点)
现代浏览器(Chrome、Safari)的 SameSite 策略:当 IdP 与 SP **不是同一父域名(跨站)** 时,浏览器默认不在第三方跳转时携带 IdP Cookie,导致"明明登录过却每次都要重新登录"。
解决办法:IdP 的 Cookie 必须显式设置并走 HTTPS:
```
Set-Cookie: idp_tgt=xxx; Domain=sso.company.com; Path=/; Secure; SameSite=None
```

---

## 4. 主流实现协议对比

| 协议 | 载体 | 用户信息存放位置 | SP 校验方式 | 典型场景 |
|---|---|---|---|---|
| **CAS** | 一次性 Ticket | IdP 后端缓存,Ticket 只是索引 key | 后端调用 IdP `validate` 接口 | 国内老系统、校园、传统企业内网 |
| **SAML 2.0** | 签名 XML Assertion | 自带在 XML 节点中 | 本地验签(证书) | 外企、海外 SaaS、ADFS |
| **OIDC / OAuth2** | 授权码 code + JWT ID Token | ID Token 自带在 payload 中 | 本地验签(公钥),可选调 `/userinfo` | 现在主流、IDaaS、自研平台 |

> 关键差异:**CAS 的 ticket 和 OIDC 的 id_token 不是一类东西**,前者是"查号用的索引 key",后者是"自包含身份的 JWT"。

---

## 5. CAS:票据(ticket)如何生成与校验

CAS 有两类票据:
- **ST**(Service Ticket,服务票据):就是我们常说的 ticket,**一次性**。
- **TGT**(Ticket Granting Ticket,票据授予票据):IdP 会话的凭证,存于 IdP Cookie 中。

### 1)IdP 根据什么生成 ST
前置条件:用户已在 IdP 登录成功,IdP 已存在一条 **TGT 记录**。TGT 绑定了:
- IdP 内部唯一用户标识(如 `uid=u10001`)
- 登录时间 / 过期时间 / 认证方式(密码、扫码等)
- 会话状态

SP 跳转 IdP 并携带 `service=https://oa.company.com/callback`(SP 回调地址)时,IdP 执行:
1. 校验当前浏览器是否存在合法、未过期的 TGT。
2. 校验传入的 `service` 是否在 IdP 白名单。
3. 生成一个**随机唯一字符串 ST**,如 `ST-123456-ABCDE-idp01`。
4. 在 IdP 服务端数据库 / 缓存中存一条 ST 记录,绑定:
- ST 值(作为 key)
- 关联的 TGT → 关联到用户唯一标识 uid
- 对应的 service(SP 地址)
- 生成时间 / 过期时间(ST 有效期很短,几秒到几十秒,一次性)
5. 通过 302 重定向将 ST 回传给 SP:
```
https://oa.company.com/callback?ticket=ST-123456-ABCDE-idp01
```

> **重点**:ST 本身是随机串,**不自带用户信息**!用户信息存在 IdP 后端缓存里,ST 只是一个"查询索引"。

### 2)SP 拿到 ticket 后如何获取用户
SP 收到回调拿到 `ticket`:
1. **不解析 ticket**(它是随机串),由**后端发起服务端调用**(不能前端调),请求 IdP 的 `/validate` 接口:
```
ticket=ST-123456-ABCDE-idp01
service=https://oa.company.com/callback
```
2. IdP 校验:ST 是否存在、未过期、`service` 与记录一致。
3. ✅ 校验通过后,**立刻删除这条 ST(一次性,防重放)**,返回用户唯一标识字段(CAS 默认返回用户名,可配置返回 uid / employeeId):
```xml
<cas:user>2026001</cas:user>
```
4. SP 拿返回字段(如 `employeeId = "2026001"`)去本地用户表匹配。

---

## 6. OIDC:授权码与 ID Token 如何生成与校验

OIDC 没有 CAS 那种一次性 ST,回调返回的是 `code`(授权码),再用它换取 `id_token`(JWT)。

### 1)IdP 根据什么生成 code 与 id_token
前置条件:用户在 IdP 已登录,IdP 会话里保存用户主体信息(`sub`、用户名、工号、邮箱等)。
SP 跳转授权地址:
```
https://sso.company.com/authorize?client_id=oa&redirect_uri=https://oa.company.com/callback&response_type=code&scope=openid profile
```

**IdP 生成 `code`(授权码,一次性票据)的逻辑:**
1. 校验 `client_id`、`redirect_uri` 是否在白名单。
2. 检查用户的 IdP 会话是否有效。
3. 生成随机唯一 `code`,在 IdP 缓存记录:`code → 绑定用户 sub、client_id、scope、回调地址、过期时间`。
4. 回调 SP,带上 `code`。

**SP 后端拿 code + client_secret 调用 `/token` 端点后,IdP 的响应逻辑:**
1. 校验 code 是否存在、未过期、client 匹配。
2. **销毁 code(一次性)**。
3. 组装并签发 **id_token(JWT)**,其 payload 由 IdP 根据**当前登录用户身份数据**生成:
```json
{
"iss": "https://sso.company.com",
"sub": "user-10001", // 【最重要】OIDC 标准唯一主体标识
"aud": "oa", // 接收方 client_id
"exp": 1735689600,
"iat": 1735689000,
"employeeId": "2026001",
"name": "张三",
"email": "zhangsan@company.com"
}
```
4. IdP 用**自己的私钥**对整个 JWT 签名,发给 SP。

> **与 CAS 最大区别**:id_token 是自包含的,身份信息直接放在 JWT payload 中;SP 拿到后可用 IdP 公钥**本地验签**,无需每次都远程调用 IdP 查用户信息(可选额外调 `/userinfo` 接口取更多属性)。
> 注意:`sub` 是 IdP 域内用户永久唯一标识(标准字段);但企业常额外扩展 `employeeId`(工号)作为业务匹配键。

### 2)SP 拿到 id_token 后如何校验与解析
1. 后端校验 JWT:验签名、校验 `iss`(发行人)、`aud`(接收方)、`exp`(过期时间),防止伪造 / 过期 / 别系统 token 复用。
2. 校验通过,解析 payload,取出约定好的唯一匹配字段(见下一节)。

> 补充 `/userinfo`:有些场景不把所有用户属性塞进 id_token,SP 用 `access_token` 调 IdP `/userinfo` 接口获取用户属性再匹配,逻辑相同。

---

## 7. SP 如何用票据匹配本地用户

SP 拿到 IdP 返回的唯一标识后,用 SQL 去自己本地用户表查询:

**CAS 场景**(用 validate 接口返回的字段):
```sql
select * from sys_user where employee_id = '2026001';
```

**OIDC 场景**(两种常用匹配方案):
- **方案 A:用标准 `sub` 匹配**(纯 OIDC 原生推荐)
```sql
select * from sys_user where oidc_sub = 'user-10001';
```
> 缺点:`sub` 是 IdP 生成的字符串,业务系统看不懂,HR 同步数据时一般不带这个字段。
- **方案 B:用扩展字段 `employeeId` / `userId`(企业最常用)**
```sql
select * from sys_user where employee_id = '2026001';
```

查到本地用户记录 → 创建 SP 本地会话 → 登录成功。

**查不到用户时的两种策略:**
- **静态开通(JIT 之前):** 提前在 SP 系统维护好用户、同步工号;找不到直接拒绝登录(内部系统常用)。
- **自动供给(JIT,Just-In-Time):** SP 校验通过后,自动新建一条本地用户记录,把工号、姓名写入(SaaS 系统常用)。

---

## 8. 匹配键的约定(账号打通的关键)

IdP 与所有 SP 必须提前敲定一个**稳定不变的唯一键**,这是单点登录账号打通的根基。

### 可选匹配键优先级(企业实践)
| 匹配键 | 推荐度 | 说明 |
|---|---|---|
| **employeeId / 工号** | ⭐⭐⭐ 首选 | HR 主数据唯一、稳定不变 |
| 员工编号 / 企业唯一账号 | ⭐⭐⭐ | 同上,企业内部主数据 |
| OIDC `sub` | ⭐⭐ | 适合 SaaS 应用(无工号体系) |
| 邮箱 | ⭐ | 慎用:员工换邮箱即断开 |
| 手机号 | ⭐ | 不推荐,变更频繁 |
| 用户名 / 姓名 | ❌ 禁用 | 重名问题,绝对不可当匹配键 |

> **核心逻辑一句话**:IdP 负责在票据 / 断言里把这个唯一键带给 SP;**SP 本地用户表必须预留一个字段保存这个 IdP 唯一键**,用该字段做关联。
>
> 常见疑问:为什么不能直接用用户名?因为 OA 里张三账号是 `zhangsan`,ERP 里可能是 `zhangs01`;IdP 统一用一个工号 `2026001`,两边用户表都存这个工号才能对齐。

### SAML 2.0 对照
SAML 没有 ticket / code,IdP 生成签名 XML 断言(Assertion),用 `<NameID>` 作为匹配唯一标识,也可加 Attribute 节点放工号:
```xml
<saml:NameID>2026001</saml:NameID>
<saml:Attribute Name="employeeId">
<saml:AttributeValue>2026001</saml:AttributeValue>
</saml:Attribute>
```
SP 验完 XML 签名后,取出 NameID / employeeId 去本地用户表匹配。

---

## 9. 完整链路时序图(OIDC 授权码模式)

```mermaid
sequenceDiagram
participant U as 用户浏览器
participant OA as SP(OA系统)
participant OKR as SP(OKR系统)
participant IDP as IdP(统一认证中心)

Note over U,IDP: 第一次登录 OA
U->>OA: 访问 OA
OA->>U: 未登录,302 跳转 IdP /authorize
U->>IDP: 请求授权(带IdP域名下Cookie判断,首次无)
IDP->>U: 返回登录页
U->>IDP: 输入工号+密码
IDP->>IDP: 校验主数据,生成TGT会话,种IdP Cookie
IDP->>U: 302回调,带上一次性 code
U->>OA: 携带 code 请求回调
OA->>IDP: 后端用 code+client_secret 调 /token
IDP->>IDP: 销毁 code,签发 id_token(JWT)
IDP->>OA: 返回 id_token
OA->>OA: 验签,解析 employeeId=2026001
OA->>OA: select * from sys_user where employee_id='2026001'
OA->>U: 创建OA本地会话,登录成功

Note over U,IDP: 访问 OKR(免密登录)
U->>OKR: 访问 OKR
OKR->>U: 未登录,302 跳转 IdP /authorize
U->>IDP: 请求授权(浏览器自动带上IdP会话Cookie)
IDP->>IDP: 校验IdP会话有效,免密
IDP->>U: 302回调,带上新的一次性 code
U->>OKR: 携带 code 请求回调
OKR->>IDP: 后端用 code+client_secret 调 /token
IDP->>OKR: 销毁 code,签发 id_token
OKR->>OKR: 验签,解析 employeeId=2026001
OKR->>OKR: select * from sys_user where employee_id='2026001'
OKR->>U: 创建OKR本地会话,免密登录成功
```

---

## 10. 系统架构总览

```mermaid
graph TD
subgraph 用户端
U[用户浏览器<br/>保存IdP会话Cookie]
end

subgraph 业务层-SP
OA[OA系统]
OKR[OKR系统]
CRM[CRM系统]
end

subgraph 统一认证层-IdP
AUTH[认证中心<br/>CAS/SAML/OIDC]
MFA[MFA 多因子认证]
SESSION[会话管理<br/>TGT/Code/JWT签发与校验]
end

subgraph 账号源
AD[AD域]
LDAP[LDAP目录]
HR[HR主数据<br/>工号employeeId]
end

U --> OA
U --> OKR
U --> CRM
OA -->|重定向/回调| AUTH
OKR -->|重定向/回调| AUTH
CRM -->|重定向/回调| AUTH
AUTH --> MFA
AUTH --> SESSION
AUTH --> AD
AUTH --> LDAP
AUTH --> HR
AD -->|同步账号| AUTH
LDAP -->|同步账号| AUTH
HR -->|同步工号/邮箱| AUTH
```

配套能力说明:
- **账号源**:对接 AD、LDAP、HR 系统,账号自动同步。
- **认证方式**:密码、短信、扫码、人脸、硬件令牌(MFA)。
- **授权**:RBAC,由 IdP 或 SP 侧控制用户能访问的功能。
- **登出**:支持单点登出(SLO),在 IdP 退出时所有业务系统一并清会话。

---

## 11. 常见坑点与安全要点

### 坑点
1. **单点登出(SLO)很难完美实现**:OIDC / SAML 的 SLO 有兼容性问题,很多企业只做"中心登出",业务会话等超时自动失效。
2. **跨站 Cookie 被浏览器拦截**:SameSite 策略、Safari ITP 会阻断第三方 Cookie,是 SSO 最常见的故障根源。
3. **JWT 一旦签发到期前无法撤销**:一般有效期设短,配合刷新 token;不放敏感信息,只是身份声明。
4. **SP 与 IdP 必须提前互信**:client_id、密钥、回调白名单、公钥交换,防止伪造凭证。

### 安全要点
- 校验 `iss` / `aud` / `exp` / 签名,防止跨系统 token 复用。
- 票据(ST / code)设计为**一次性**,防止重放攻击;JWT 靠短过期时间防风险。
- 匹配键不用姓名、手机号等易变字段。

---

## 12. 术语速查表

| 术语 | 全称 / 含义 |
|---|---|
| SSO | Single Sign-On,单点登录 |
| IdP | Identity Provider,身份提供者(认证中心) |
| SP | Service Provider,服务提供者(业务系统) |
| TGT | Ticket Granting Ticket,CAS 的会话票据 |
| ST | Service Ticket,CAS 的一次性服务票据 |
| SAML | Security Assertion Markup Language,基于 XML 断言的身份协议 |
| OIDC | OpenID Connect,在 OAuth2 之上加身份层的协议 |
| OAuth2 | 授权协议(给谁权限),本身不含身份 |
| ID Token | OIDC 签发的 JWT 身份令牌 |
| JWT | JSON Web Token,自包含签名令牌 |
| sub | OIDC 标准用户唯一主体标识 |
| RBAC | Role-Based Access Control,基于角色的访问控制 |
| MFA | Multi-Factor Authentication,多因子认证 |
| JIT | Just-In-Time,自动供给账号 |
| SLO | Single Log Out,单点登出 |

posted @ 2026-11-02 11:59  记得承诺过  阅读(18)  评论(0)    收藏  举报
刷新页面返回顶部
博客园  ©  2004-2026
浙公网安备 33010602011771号 浙ICP备2021040463号-3