文章目录
- 前言
-
- [01 认证与授权的边界](#01 认证与授权的边界)
- [02 认证体系的技术分层](#02 认证体系的技术分层)
- [03 用户认证与 Passkey](#03 用户认证与 Passkey)
- [04 会话、令牌与生命周期](#04 会话、令牌与生命周期)
-
- [Cookie、Session 与 Token](#Cookie、Session 与 Token)
- 续期、退出与撤销
- [05 统一登录与用户委托](#05 统一登录与用户委托)
- [06 服务身份与系统调用](#06 服务身份与系统调用)
-
- [API Key 与 Client Credentials](#API Key 与 Client Credentials)
- 请求签名与防重放
- mTLS:在连接层验证双方身份
- 扩展机制:发送方约束与工作负载身份
- [07 权限模型](#07 权限模型)
- [08 权限校验的执行位置](#08 权限校验的执行位置)
- [09 统一文件中心的授权架构](#09 统一文件中心的授权架构)
- [10 应用框架与身份平台](#10 应用框架与身份平台)
-
- [平台层:统一身份、权限策略与 API 网关](#平台层:统一身份、权限策略与 API 网关)
- 结语
前言
刚做开发时,觉得认证鉴权很简单:登录成功发个 Token,请求过来校验一下,不就完事了?
后来接触的系统多了才发现,事情没那么简单。
用户登录、微服务调用、第三方开放接口、后台菜单权限、数据访问控制......场景一变,方案可能就得跟着变。
JWT、OAuth 2.0、AK/SK、RBAC、Sa-Token,这些技术到底是什么关系,又该怎么选?
这篇文章就从一个开发人员的实际视角出发,把这些常用技术串起来,尽量讲得简单、实用、有点干货。
01 认证与授权的边界

-
认证(Authentication):确认"你是谁"。通过账号密码、令牌(Token)、数字证书等方式验证身份,确认请求来自可信主体。这个主体可以是员工,也可以是 OCR 服务、定时任务或外部合作机构。
-
授权(Authorization):确定"你能做什么"。根据角色、权限和业务规则,决定主体可以访问哪些资源、执行哪些操作。例如,某个角色虽然拥有"下载文件"权限,但还需要结合文件所属租户、经办关系、共享范围等条件,判断是否允许下载。
在实际开发中,我们常说的"鉴权"通常是一个广义概念,既包括身份认证,也包括权限校验。但落到代码层面,两者应当分开处理:认证负责确认身份,权限校验负责判断能否访问。只有身份可信、权限符合要求,才能放行请求。
02 认证体系的技术分层
明确了认证、授权和鉴权的职责后,很多看似复杂的技术名词就容易理解了。密码、JWT、OAuth 2.0、OIDC、RBAC 等并不是同一类技术,它们各自解决不同的问题,也经常配合使用,共同构成一套完整的认证与权限控制体系。

以员工访问文件中心为例:员工通过账号密码完成身份认证;业务应用通过 OIDC 接入统一登录;调用文件 API 时携带访问令牌(例如 JWT 格式);文件 API 验证令牌后,再结合 RBAC 角色权限、资源属性和业务关系,判断员工是否有权访问目标文件。
这些技术各司其职、相互配合,但并不意味着每次请求都要把所有流程重新走一遍。例如,账号密码通常只在登录时验证,而令牌和资源权限则需要在访问接口时进行相应校验。
理解这套体系,还需要认识三个经常出现的角色:
-
主体(Principal):谁在访问? 被系统识别的用户或程序身份,例如员工张三、OCR 服务。
-
客户端(Client):谁在发起调用? 申请或使用访问令牌的应用,例如业务后端、移动 App,并不特指浏览器。
-
资源服务器(Resource Server):谁在提供资源? 对外提供受保护 API、验证访问令牌并实施访问控制的服务,例如文件中心。
需要注意,客户端和服务端并不是固定身份,而是取决于当前的调用关系。例如,业务后端接收浏览器请求时是服务端;当它调用文件中心 API 时,又成为这段调用链路中的客户端。
因此,在设计认证与鉴权方案时,不能只关注用了什么协议或框架,还要搞清楚:谁在调用、拿什么证明身份、访问什么资源、由谁判断权限。把这几个问题理清楚,技术选型和安全边界才能真正落到实处。
03 用户认证与 Passkey
用户登录系统,首先要解决的是如何证明"你就是你"。
最常见的是账号密码,但现在还有短信验证码、动态口令、指纹、人脸识别以及 Passkey 等多种认证方式。它们的核心区别在于:用户用什么证明自己的身份,系统又如何确认这份证明可信。
下面整理了几种常见的用户认证方式:
| 认证方式 | 如何证明身份 | 适用场景与实现要点 |
|---|---|---|
| 账号密码 | 提供只有用户本人应当知道的密码 | 最常见的登录方式;密码应使用 Argon2id、bcrypt 等成熟算法进行加盐哈希存储,并配合登录限流、防暴力破解和安全的密码找回机制 |
| TOTP / HOTP(动态口令) | 使用绑定设备中的共享密钥生成一次性验证码 | 常见于认证器 App、硬件令牌;TOTP 基于时间生成,HOTP 基于计数器生成,服务端需要校验有效性并防止重复使用 |
| 短信 / 邮件验证码、Magic Link | 通过用户控制的手机号码或邮箱接收验证码、登录链接 | 常用于快捷登录、二次验证或账号恢复;验证码和链接应设置有效期、使用次数限制及用途约束 |
| App 推送确认 | 通过已绑定的可信设备确认登录请求 | 常用于企业移动认证;建议结合数字匹配、登录地点和设备信息,降低用户误点确认的风险 |
| Passkey(通行密钥) | 使用设备或认证器中的私钥完成加密验证 | 适用于无密码登录;基于 FIDO2 / WebAuthn,支持设备解锁验证,并具备抗钓鱼能力 |
| 安全密钥 / 智能卡 | 使用硬件认证器中的密钥或证书证明身份 | 常用于管理员、特权账号和高安全等级场景;具体认证方式与安全能力取决于 FIDO2、证书认证等所采用的协议 |
其中,Passkey(通行密钥) 是近年来值得关注的一种认证方式。
与传统密码不同,Passkey 使用公私钥机制:服务端保存公钥,私钥保存在用户的设备或认证器中,不需要把密码传给服务端。
用户登录时,通常只需通过指纹、人脸或设备 PIN 解锁通行密钥,设备就可以使用私钥完成认证。这里的指纹、人脸主要用于本地验证用户,服务端验证的是密码学证明,而不是直接接收用户的生物特征数据。
需要注意,指纹登录不一定就是 Passkey。关键要看底层是否采用 WebAuthn 等公钥认证机制,而不能仅根据登录界面是否支持指纹或人脸来判断。
从实际选型来看,普通业务系统可以采用账号密码配合多因素认证(MFA);对安全要求更高的系统,可以优先考虑支持抗钓鱼认证的 Passkey 或 FIDO2 安全密钥。同时,无论采用哪种方式,都需要设计安全可靠的账号恢复和设备更换流程。
04 会话、令牌与生命周期
登录只是完成了一次身份确认,并不代表后续请求就自动可信。用户每次访问接口时,都需要携带可验证的凭证,服务端才能识别请求来自谁,并进一步判断是否允许访问。
Cookie、Session 与 Token
Cookie 是浏览器保存数据、并在符合条件的请求中自动携带数据的机制,本身并不等于登录凭证。
Session(会话) 则用于维护用户的登录状态。
常见的实现方式是:用户登录成功后,服务端创建 Session,并将随机生成的 Session ID 通过 Cookie 返回给浏览器。后续请求中,浏览器自动携带该 Cookie,服务端根据 Session ID 查找对应的用户身份、有效期和登录状态。

Token(令牌) 则是一种用于证明身份或表达访问权限的凭证,常见的有两种形式:
-
Opaque Token(不透明令牌) :通常是一串没有直接业务含义的随机字符串。接收方无法仅凭令牌内容判断其身份和权限信息,需要查询服务端存储,或调用 Introspection(令牌内省) 接口确认令牌是否有效、拥有哪些授权信息。
-
JWT(JSON Web Token):一种可以携带身份、有效期、权限等声明信息的令牌格式。对于经过签名的 JWT,服务端可以在本地验证签名、签发方、受众、有效期等信息,无需每次都查询集中式令牌服务。
| 方案 | 适用诉求 | 主要工程成本 |
|---|---|---|
| 服务端 Session / Opaque Token | 状态集中管理,方便主动失效、停用和撤销 | 会话存储或令牌查询服务的可用性、缓存及多节点一致性 |
| 可本地验证的 JWT | 减少远程查询,适合分布式服务间调用 | 密钥管理、声明校验、权限变更和令牌提前撤销 |
需要注意以下几点:
-
JWT 不等于 OAuth 2.0。OAuth 2.0 是授权框架,访问令牌既可以采用 JWT,也可以采用 Opaque Token。
-
令牌有效不代表操作一定有权限。例如,JWT 验证通过,只能说明令牌满足相应验证条件;能否下载某个文件,仍需结合角色、所属租户、业务关系等进行权限校验。
-
Session 不一定存储在 Redis 中。Redis 只是常见的共享会话存储方案之一。对于服务端会话,还应合理设置空闲超时、绝对超时,并在登录、权限提升等关键状态变化时更新 Session ID,降低会话劫持风险。
续期、退出与撤销
令牌不可能一直有效,但如果有效期太短,用户又需要频繁登录,体验就会很差。
因此,实际系统通常会结合短期访问令牌(Access Token)和续期机制(如 Refresh Token):访问令牌负责日常接口调用,过期后通过受控的续期流程获取新令牌,在安全性和使用体验之间取得平衡。
但令牌续期只是其中一环,还需要考虑几个实际问题:用户主动退出后,凭证是否立即失效?账号被停用后,旧令牌还能不能使用?管理员调整权限后,新的权限何时生效?
这些问题不能仅靠设置 Token 过期时间解决,需要结合会话管理、令牌撤销、权限实时校验等机制统一设计。
以 BFF(Backend for Frontend,为前端服务的后端) 架构为例:浏览器只保存应用的 Session Cookie,BFF 在服务端维护用户会话并安全管理 OAuth 令牌,避免将访问令牌和刷新令牌直接暴露给浏览器 JavaScript。
下面通过这一架构,进一步说明令牌的续期、退出和撤销如何协同工作。

05 统一登录与用户委托
当公司有多个业务系统时,如果每个系统都要单独登录、维护账号密码,不仅员工使用麻烦,也增加了账号管理和安全治理的成本。
SSO(Single Sign-On,单点登录) 就是为了解决这个问题:让多个应用接入统一的身份认证体系。用户登录一次后,访问其他受信任的应用时,通常不需要再次输入账号密码。
OAuth 2.0 与 OIDC 的职责
实现统一登录时,经常会遇到 OAuth 2.0、OIDC 和 IdP 这几个概念,它们各有分工:
-
OAuth 2.0:解决"如何授权访问资源"。 它是一套授权框架,规定客户端如何获得访问受保护资源的授权,例如允许业务系统调用文件中心 API。
-
OIDC(OpenID Connect):解决"如何确认登录用户的身份"。 它在 OAuth 2.0 基础上增加了身份认证能力,通过 ID Token(身份令牌) 等机制,让业务应用能够验证用户的认证结果。
-
IdP(Identity Provider,身份提供方):负责"统一认证用户身份"。 例如统一登录平台,负责验证员工身份。授权服务器则负责处理授权请求、签发令牌。在实际系统中,同一个身份平台通常会同时承担这两种角色。
需要注意,单点登录不等于多个应用共用同一个 Session。应用通过统一身份平台完成认证后,仍然可以建立并维护自己的本地登录会话。

上图仍以 BFF(为前端服务的后端)架构 为例:浏览器只保存业务应用的 Session Cookie,BFF 作为 OIDC 客户端,负责完成协议交互并在服务端安全管理令牌。这种方式适合有独立后端的 Web 应用,可以避免将访问令牌直接暴露给浏览器 JavaScript。
整个登录过程可以简单理解为:
-
跳转统一登录 :用户访问业务系统,BFF 将浏览器重定向到统一身份平台,并携带客户端标识、回调地址、
scope=openid等参数。 -
完成身份认证:用户在统一身份平台登录,认证成功后,浏览器携带授权码(Authorization Code)返回业务系统。
-
换取令牌:BFF 在服务端使用授权码换取 ID Token、Access Token 等令牌。
-
建立本地会话:BFF 验证 ID Token,确认用户身份后,建立业务系统自己的登录会话。
-
访问业务资源:后续调用文件 API 时,使用面向该 API 的 Access Token。文件 API 验证令牌后,还需要独立检查用户是否有权访问目标文件。
这里还有一个重要的安全细节:本例中的 BFF 按机密客户端(Confidential Client)注册 ,换取令牌时,不仅需要提交 code_verifier(PKCE 校验参数),还需要按照注册的客户端认证方式证明自身身份。
两者作用不同:PKCE 用于将授权码与发起授权的客户端实例关联,客户端认证则用于验证客户端身份 。此外,BFF 还需要校验 state 等参数,防止授权响应被冒用或错误关联。
归根结底,OIDC 负责让业务系统可信地确认用户身份,OAuth 2.0 负责规范访问授权,而具体业务资源能不能访问,最终仍由资源 API 根据权限规则判断。
令牌的用途与接收方
同一个身份平台可以签发多种令牌,但并不是拿到一个有效的 Token,就能访问所有系统。不同令牌有不同的用途和接收方,即使签名验证通过,也不代表它可以用于当前接口。

这三种令牌的职责需要明确区分:
-
ID Token(身份令牌):证明用户已经完成认证。 主要提供给 OIDC 客户端使用。在前面的 BFF 架构中,BFF 通过验证 ID Token 确认用户的登录身份。
-
Access Token(访问令牌):用于访问受保护的资源。 客户端调用文件 API 时携带 Access Token,资源服务器验证令牌,并结合权限规则决定是否放行。
-
Refresh Token(刷新令牌):用于获取新的访问令牌。 仅提交给授权服务器,不用于直接访问业务 API。
举个例子:身份平台签发给 web-client 的 ID Token,即使签名合法、尚未过期,也不能直接拿去调用 file-api。因为ID Token 是给客户端验证用户身份的,而不是给资源服务器使用的访问凭证。
因此,服务端验证令牌时,除了验证签名、有效期等信息,还必须根据令牌类型检查签发方(Issuer)、接收方(Audience)以及其他适用的协议约束,防止不同用途的令牌被混用。
企业身份体系的接入
实际企业中,往往已经有域账号、LDAP 目录、OA 统一登录或第三方 SaaS,不可能为了接入新系统,就把原有账号体系全部推倒重来。
更常见的做法是:由统一身份平台对接现有账号和认证体系,再通过 OIDC、SAML 等标准协议向业务应用提供统一登录能力。
在这个过程中,经常会遇到以下技术:
| 名称 | 核心作用 | 常见应用场景 |
|---|---|---|
| SAML 2.0 | 通过身份断言在身份提供方与应用之间传递认证结果 | 企业 OA、ERP、第三方 SaaS 单点登录;重点校验签名、接收方、有效期及请求关联 |
| LDAP / Active Directory | LDAP 是目录访问协议;AD 是微软提供的目录与身份管理产品体系 | 管理企业员工、组织架构和域账号,供统一身份平台对接 |
| Kerberos | 基于票据的网络身份认证协议 | Windows 域登录、企业内网服务认证;需要关注密钥安全和时间同步 |
| CAS / Apereo CAS | CAS 是基于票据的单点登录协议;Apereo CAS 是支持多种认证协议的统一认证服务项目 | 对接已有 CAS 登录体系,或建设企业统一认证平台 |
这些技术并不是相互替代的关系,而是解决不同层面的问题。例如,企业可以继续使用
AD 管理员工账号,通过 Kerberos 完成域内认证,再由统一身份平台提供 OIDC 或 SAML 单点登录,让新老业务系统共享同一套身份体系。
对于新建 Web 应用,通常可以优先考虑 OIDC;对于已有的 SAML、CAS 等系统,则可以通过统一身份平台进行兼容和整合,避免每个业务系统都重复开发一套登录认证逻辑。
06 服务身份与系统调用
前面介绍的 OAuth 2.0 和 OIDC,主要围绕用户登录和授权展开。但实际系统中,并不是所有 API 调用都有用户参与。
例如,夜间自动执行的 OCR 任务、系统间数据同步、合作机构批量推送数据等,都属于程序调用程序的场景。这类调用通常不需要用户登录,而是为应用或服务分配独立身份,并明确其可以访问哪些接口、操作哪些资源。
API Key 与 Client Credentials
**在系统间调用中,**API Key 和 OAuth 2.0 Client Credentials(客户端凭证模式) 是两种常见的认证与授权方案。
-
API Key(接口密钥):由服务提供方分配给调用方的访问凭证,常用于简单的 API 接入、调用方识别和配额管理。例如,给某个合作机构分配独立的 API Key,用于调用文件上传接口。如果采用 Bearer(持有即有效)方式,谁拿到密钥就可能以对应身份调用接口,因此必须做好权限限制、密钥保管、定期轮换和停用管理。
-
Client Credentials(客户端凭证模式):OAuth 2.0 提供的一种授权方式。客户端先向授权服务器证明自己的身份,再获取有明确有效期和访问范围的 Access Token,随后使用该令牌调用业务 API。
这里需要理解一个概念:机密客户端(Confidential Client),指能够可靠保护自身凭证的应用,例如部署在受控服务器上的后端服务。
相对地,浏览器前端、普通移动 App 等属于公共客户端(Public Client)。由于代码和安装包可能被用户获取,不能简单地在其中写死 Client Secret,并将其作为可信身份的依据。

相比直接把长期有效的 API Key 交给业务系统,OAuth 2.0 可以让客户端通过受控的身份认证流程获取短期访问令牌,减少长期凭证在业务 API 之间传播的风险。
以后台服务读取文件为例,Client Credentials 的调用过程如下:
-
证明客户端身份:后台服务通过 HTTPS 请求授权服务器,使用 Client Secret、私钥签名或 mTLS 等受支持的方式完成客户端认证。
-
申请访问令牌 :指定
grant_type=client_credentials,申请file:read等权限范围(Scope)。 -
获取并使用令牌 :授权服务器验证客户端身份及允许的授权范围,签发 Access Token。客户端再通过请求头
Authorization: Bearer <token>调用文件 API。
文件 API 还需要验证令牌是否有效、是否面向当前资源服务器,以及是否具备所需的访问权限。
需要注意,Client Credentials 代表的是客户端自身,而不是某个登录用户。因此,这种模式通常不签发 Refresh Token;访问令牌过期后,客户端可以再次认证,申请新的令牌。
请求签名与防重放
对于合作机构开放 API,仅验证调用方身份有时还不够,还需要确保请求内容没有被篡改,也不能让同一份请求被恶意重复使用。
例如,合作机构调用放款接口时,如果有人修改了请求金额,或者截获合法请求后重复提交,就可能造成严重的业务风险。
这时,可以引入请求签名(Request Signing)机制。
其核心思路是:调用方将请求方法、路径、查询参数、指定请求头、请求正文摘要等信息,按照约定规则组合后计算签名;服务端使用相同规则验证签名,确认受保护的请求内容是否发生变化。
常见实现是 AK/SK + HMAC:
-
AK(Access Key):密钥标识,用于告诉服务端当前使用哪一组凭证,也可用于识别调用方。
-
SK(Secret Key):双方安全保存的共享密钥,用于生成和验证签名,不应直接放在业务请求中传输。
-
HMAC(基于哈希的消息认证码):结合共享密钥和请求内容计算校验值,用于验证消息完整性及调用方是否持有对应密钥。
但这里有个容易忽略的问题:签名正确,不代表请求一定安全。
攻击者即使无法修改已签名的请求,也可能原样重放。因此,实际设计中通常还需要配合:
-
Timestamp(时间戳):限制请求的有效时间窗口,避免旧请求长期有效。
-
Nonce(随机数):为请求生成唯一标识,服务端在有效窗口内检测重复使用。
-
幂等控制:对放款、扣款等关键业务操作,通过业务流水号等机制防止重复执行。
此外,双方还需要统一签名字段、参数排序、编码方式、密钥版本等规则,否则容易出现客户端签名与服务端验签结果不一致的问题。
mTLS:在连接层验证双方身份
普通 HTTPS 主要由客户端验证服务器身份,确保连接到的是可信服务。
mTLS(Mutual TLS,双向 TLS) 则更进一步:除了客户端验证服务器证书,服务器也要验证客户端证书,从而实现通信双方的身份认证。
例如,OCR 服务调用文件中心时,可以使用客户端证书证明自己的服务身份。文件中心验证证书及其对应的身份绑定关系后,再决定是否接受请求。
mTLS 比较适合企业内部服务间通信、合作机构接口,以及能够统一管理证书的受控环境。
不过,mTLS 的落地也有几个关键点:
-
证书必须可信 :需要校验证书链、有效期、用途及预期身份等信息,不能因为证书里写着
ocr-service就直接信任。 -
私钥必须安全保管:证书本身不是秘密,真正需要重点保护的是对应私钥。
-
证书需要生命周期管理:包括签发、分发、轮换、过期处理和必要的撤销机制。
同时要注意,mTLS 解决的是连接双方的身份认证问题,并不直接决定业务权限。即使确认调用方是 OCR 服务,也仍需检查它是否有权访问目标文件。
扩展机制:发送方约束与工作负载身份
前面介绍的 Bearer Token 有一个天然风险:只要令牌被窃取,攻击者就可能在有效期内冒用它。
虽然 HTTPS 可以保护传输过程,但无法保证令牌在其他环节泄露后不能被使用。
针对这个问题,可以引入发送方约束(Sender-Constrained Token):不仅要求调用方提供有效令牌,还要证明自己持有与该令牌绑定的密钥。
DPoP:在请求层证明令牌持有者身份
DPoP(Demonstrating Proof of Possession) 是 OAuth 2.0 中的一种发送方约束机制。
简单理解:光拿到 Token 还不够,还得证明这个 Token 确实是你有权使用的。
它的主要工作过程是:
-
客户端生成并持有一组公私钥。
-
授权服务器将访问令牌与客户端公钥绑定。
-
客户端调用 API 时,除了携带访问令牌,还需要使用私钥生成 DPoP 签名证明。
-
资源服务器验证令牌与公钥的绑定关系,以及证明中的请求方法、目标地址、时间和防重放信息。
这样一来,即使攻击者拿到了 Access Token,只要没有对应私钥,就无法正常使用该令牌。
DPoP 适合希望降低令牌被盗用风险、但不方便部署客户端 TLS 证书的 OAuth 应用。
两种令牌持有证明机制
mTLS:也可以实现访问令牌绑定
除了 DPoP,OAuth 2.0 还可以通过 mTLS 证书绑定访问令牌实现发送方约束。
授权服务器将 Access Token 与客户端证书绑定。后续调用业务 API 时,资源服务器不仅验证令牌,还会检查当前 TLS 连接使用的客户端证书是否与令牌绑定的证书一致。
两种方案的区别可以简单理解为:
-
DPoP:在 HTTP 请求层使用私钥签名,证明令牌持有者身份。
-
mTLS 令牌绑定:在 TLS 连接层利用客户端证书,证明令牌持有者身份。
需要特别注意:启用 mTLS 客户端认证,并不代表 Access Token 自动完成了证书绑定。客户端认证和令牌绑定是两个独立的安全机制,需要分别配置和验证。
对于规模较大的微服务或云原生环境,还可以进一步采用 Workload Identity(工作负载身份)机制,例如 SPIFFE/SPIRE 或云平台提供的工作负载身份能力,为服务自动分配和管理可信身份,减少人工维护长期密钥的成本。
但无论使用哪种机制,最终都要区分两个问题:如何证明调用方身份,以及这个调用方被允许访问哪些资源。

07 权限模型
认证解决了"你是谁",接下来还需要解决另一个问题:你能访问哪些资源、执行哪些操作?
实际系统中的权限往往不只是简单的"有"或"没有"。例如,某个员工虽然拥有文件下载权限,但不代表他可以下载所有人的文件。除了角色权限,还可能受到所属租户、业务关系、文件状态等条件限制。
为了解决这些问题,业界形成了 ACL、RBAC、ABAC、ReBAC 等不同的权限模型。
权限模型如何表达规则
| 模型 | 核心思路 | 场景示例 |
|---|---|---|
| ACL(访问控制列表) | 围绕具体资源,记录谁可以执行哪些操作 | 文档共享:将《项目排期表》设置为张三只读、李四可编辑,权限直接记录在这份文档的访问控制列表中。 |
| RBAC(基于角色的访问控制) | 先给角色分配权限,再把角色授予用户 | 工单系统:客服可以查看、回复工单,主管还可以分派工单。新员工只需分配对应角色,即可获得相应功能权限。 |
| ABAC(基于属性的访问控制) | 根据用户、资源、操作和环境等属性,动态判断是否允许访问 | 报销审批:经理只能审批本部门其他员工的待审批单据,且金额不能超过审批额度。部门、金额或单据状态发生变化,都可能影响审批权限。 |
| ReBAC(基于关系的访问控制) | 根据用户与资源之间的关系,以及预先定义的规则判断权限 | 项目文档:张三加入"官网改版"项目后,可以查看该项目的文档;退出项目且没有其他授权后,就不能继续访问。 |
简单理解,这几种模型的侧重点不同:
-
ACL 看具体资源:这份文件允许谁访问?
-
RBAC 看角色:你是什么角色,具备哪些权限?
-
ABAC 看属性条件:你的部门、审批额度、资源状态是否满足要求?
-
ReBAC 看关系:你是不是项目成员、文件所有者,或者被授权的共享对象?
它们并不是互相排斥的关系。实际开发中,RBAC 负责基础功能权限,ABAC 和 ReBAC 进一步约束具体业务数据,是一种常见的组合方式。
在一次请求中组合权限模型
以员工下载文件为例,假设系统要求:员工必须具有文件读取权限、属于相同租户,并且是申请单经办人或有效共享对象。
那么,一次完整的权限校验可以分为三步:
-
检查功能权限(RBAC) :用户是否具备
file:read权限? -
检查业务属性(ABAC):用户与文件是否属于同一租户?文件当前状态是否允许下载?
-
检查业务关系(ReBAC):用户是否为该申请单的经办人,或者拥有尚未失效的文件共享权限?
只有全部条件满足,才允许下载;任何一项不满足,都应拒绝访问。
这里需要特别注意:用于权限判断的数据必须可信。例如,租户 ID 不能直接相信前端传入的值,经办关系也不能由调用方自行声明,而应从可信身份上下文及服务端业务数据中获取。
另外,权限判断还需要考虑调用方式:
-
用户委托调用:除了用户自身权限,还要受到客户端授权和 Access Token 权限范围(Scope)的限制。
-
后台任务调用:使用任务自身的程序身份和授权范围,不能因为没有登录用户,就默认拥有更高权限。
权限模型的核心不是选择哪一种技术,而是把业务中的访问规则准确表达出来,并确保每次访问都能执行这些规则。
08 权限校验的执行位置
有了权限规则,还要解决一个实际问题:这些规则究竟应该在哪里执行?网关、业务服务,还是统一权限中心?
例如,API 网关能够验证 Token、识别调用方,也可以检查一些通用权限;但它通常不知道某份文件属于谁、申请单由谁经办、当前业务状态是否允许下载。
因此,权限校验通常需要分层处理:网关负责通用安全控制,业务服务负责具体资源和业务规则的权限判断。

在权限控制架构中,经常会遇到三个概念:
-
PEP(Policy Enforcement Point,策略执行点):负责执行。 拦截访问请求,根据权限判断结果决定放行还是拒绝。例如,API 网关中的鉴权插件、业务接口中的权限拦截器。
-
PDP(Policy Decision Point,策略决策点):负责判断。 根据权限规则和相关数据,计算当前请求是否允许访问。例如,判断张三能否下载指定文件。
-
PIP(Policy Information Point,策略信息点):负责提供数据。 为权限判断提供可信的用户、资源和环境信息,例如用户所属部门、文件归属、申请单经办关系等。
可以简单理解为:PEP 负责拦截,PDP 负责判断,PIP 负责提供判断依据。
它们是三种逻辑职责,并不一定需要部署成三个独立服务。简单系统可以在业务应用内部实现;复杂系统则可以将通用策略集中管理,同时保留必要的业务侧校验。
无论采用哪种架构,都应遵循一个重要原则:默认拒绝(Default Deny)。
也就是说,只有明确满足授权规则的请求才能放行。如果没有匹配的授权规则、缺少可信数据,或者权限判断出现异常,都不应该直接执行受保护的业务操作。
实际开发中,还需要重点防止权限校验遗漏:
-
新增接口时忘记增加权限控制。
-
前端隐藏了按钮,但后端接口没有校验权限。
-
只检查用户角色,没有检查具体资源的数据权限。
-
普通接口做了鉴权,但批量导出、后台任务等入口绕过了校验。
权限控制不能只停留在登录入口或 API 网关,而应该落实到真正访问和操作业务资源的位置。 尤其是涉及跨租户、跨用户、敏感数据查询和文件下载的场景,更需要在业务服务中落实细粒度权限校验。
09 统一文件中心的授权架构
在实际企业系统中,文件中心往往是一个公共服务,供多个业务系统共同使用。但调用方可能完全不同:有的是员工在线下载文件,有的是后台任务自动处理材料,还有的是外部合作机构通过接口获取文件。
虽然它们调用的是同一套 API,但身份来源、授权方式和可访问的资源范围并不相同。
因此,文件中心不能简单地认为"只要认证通过,就可以访问文件",而应该根据调用方身份和业务场景,分别制定权限规则。

| 调用方 | 授权依据 | 可访问的资源范围 |
|---|---|---|
| 员工在线访问 | 用户身份、调用应用、角色权限及用户委托 | 自己经办的申请单附件,或明确授权共享的文件 |
| 后台处理任务 | 独立的程序身份、任务权限及授权范围 | 当前任务被允许处理的文件或业务材料 |
| 外部合作机构 | 合作机构身份、所属租户及约定的业务权限 | 合作业务范围内获准访问的文件,不允许任意查询或遍历 |
这里有一个非常容易出现的安全问题:业务系统有权调用文件中心,不代表它可以代表任意用户访问文件。
例如,业务后端调用文件下载接口时,如果只携带自己的 Client Credentials 令牌,再传入一个 userId=张三,文件中心就直接认为请求来自张三,那么业务系统实际上就获得了冒用任意用户身份的能力。
正确的方式应该是:通过面向文件 API 的用户委托令牌 ,或者经过专门设计、具有可信来源和明确授权边界的服务间委托机制,证明业务系统确实有权代表该用户发起请求。
对于后台任务和合作机构,则应使用各自独立的程序身份,并限定允许执行的操作和访问的资源范围。
核心原则:调用方身份可信,不代表可以访问所有资源;不同来源的身份,也不应该共用一套没有边界的权限。
10 应用框架与身份平台
前面介绍了认证、授权、令牌、权限模型等概念,真正落地到项目时,自然就会遇到一个问题:这些能力是自己开发,还是使用现成的框架和平台?
实际上,Java 生态中已经有不少成熟方案,例如 Sa-Token、Spring Security、Apache Shiro、Keycloak、Casbin 等。
但它们并不是同一类产品,有的负责应用登录,有的负责统一身份认证,有的专门处理权限规则,还有的工作在 API 网关层。
因此,技术选型的重点不是简单比较"哪个更强",而是先明确:它负责解决什么问题,部署在哪一层,还需要业务系统补充哪些能力。

应用层:认证与鉴权框架
这类框架主要集成在业务应用内部,帮助开发人员处理登录状态、身份验证、权限判断等问题。
| 应用框架 | 主要特点与适用场景 | 需要额外关注的部分 |
|---|---|---|
| Sa-Token | Java 轻量级权限认证框架,适合快速实现登录、会话、角色权限及相关安全控制 | 业务数据权限、分布式会话管理,OAuth 2.0 等扩展能力需结合对应模块确认 |
| Spring Security | 与 Spring 生态深度集成,适合复杂安全控制、OAuth 2.0 / OIDC 接入及资源服务器建设 | 安全过滤链、身份与权限映射、业务资源校验及异常处理 |
| Apache Shiro | 提供认证、授权、会话等基础能力,适合已有 Shiro 技术体系的项目 | Realm 和权限规则治理、现代协议集成及依赖版本维护 |
其中,有两个概念需要特别区分:
-
认证框架不等于统一身份平台。例如,Spring Security 可以帮助业务应用完成登录认证和权限校验,但并不意味着引入它就自动建成了企业级 SSO 平台。
-
资源服务器不等于授权服务器。Spring Security 可以让业务 API 验证 JWT 或不透明访问令牌,但负责签发 OAuth 令牌的授权服务器,可以是另一个独立系统。
平台层:统一身份、权限策略与 API 网关
当多个业务系统需要共用身份体系、集中管理权限策略或统一保护 API 时,还会使用以下平台和组件。
| 平台或组件 | 主要职责与适用场景 |
|---|---|
| Keycloak / Apereo CAS | 建设统一身份认证与单点登录平台,提供身份联合及多应用接入能力,具体协议支持需结合版本和配置确认 |
| Spring Authorization Server | 基于 Spring 生态构建 OAuth 2.0 / OIDC 授权服务器,账号治理、管理界面及运维能力需要按需建设 |
| Casbin / jCasbin | 基于权限模型和策略执行访问控制,支持 RBAC、ABAC 等规则,适合在应用中集成权限判断 |
| OPA(Open Policy Agent) | 通用策略引擎,可将授权策略从业务代码中分离,适合统一管理复杂策略 |
| OpenFGA | 基于关系模型实现细粒度授权,适合文档共享、项目成员关系等 ReBAC 场景 |
| Kong / Higress 等 API 网关 | 在 API 入口统一执行身份认证、令牌校验、访问限制等通用安全策略,具体能力取决于版本和插件 |
这些组件可以根据实际需要组合使用,并不要求全部引入。
例如,一套企业级文件中心可以采用以下分工:
-
Keycloak:提供统一登录和令牌签发能力。
-
API 网关:验证入口凭证,执行通用访问控制。
-
Spring Security:在文件服务内部建立可信身份上下文,执行接口级权限校验。
-
Casbin 或 OpenFGA:根据实际复杂度,管理角色权限或文件共享关系等细粒度授权规则。
-
业务服务:结合文件所属租户、业务状态、经办关系等数据,完成最终的资源权限判断。
这只是一个组合示例,并不是所有系统都需要部署完整的技术栈。对于业务简单的系统,使用 Spring Security 或 Sa-Token 配合业务权限校验,可能就足够了;只有在权限规则复杂、跨系统共享需求明显时,才有必要进一步引入独立的策略服务。
另外,无论采用什么框架或平台,都要明确身份由谁认证、令牌由谁签发和验证、会话由谁维护、权限由谁判断、退出和撤销由谁处理,避免多个组件职责重叠,或者出现无人负责的安全空白。
技术选型的关键,不是把所有安全组件堆在一起,而是让每个组件各司其职,同时确保认证和鉴权在整条调用链路中没有遗漏。
结语
从账号密码、Passkey,到 Session、JWT、OAuth 2.0,再到 RBAC、ABAC、API 网关,看似一大堆技术名词,其实归根结底就是解决几个问题:
-
你是谁? ------ 认证,确认调用方的身份。
-
你凭什么访问? ------ 验证凭证,确认请求是否可信。
-
你能做什么? ------ 授权,明确允许执行的操作和访问范围。
-
这次操作能放行吗? ------ 鉴权,结合具体资源和业务规则作出判断。
实际开发中,安全问题往往不是因为少用了某个框架,而是因为忽略了权限边界。Token 有效,不代表有权访问;拥有接口权限,不代表能操作所有数据;来自内部系统的请求,也不代表天然可信。
因此,设计认证与鉴权体系时,不必一味追求技术复杂度,而应坚持几个基本原则:身份可信、权限最小、默认拒绝、全程校验、可追溯、可撤销。
对于开发人员来说,真正重要的不是记住多少协议和框架,而是理解它们各自解决什么问题,在合适的场景选择合适的方案,并把安全控制落实到每一次真实的业务操作中。
好的认证与鉴权设计,不是让系统变得更复杂,而是让每一次访问都有依据、每一项权限都有边界。
本文的引用仅限自我学习如有侵权,请联系作者删除。
参考知识