7、网络安全-认证鉴权

文章目录


前言


刚做开发时,觉得认证鉴权很简单:登录成功发个 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。

整个登录过程可以简单理解为:

  1. 跳转统一登录 :用户访问业务系统,BFF 将浏览器重定向到统一身份平台,并携带客户端标识、回调地址、scope=openid 等参数。

  2. 完成身份认证:用户在统一身份平台登录,认证成功后,浏览器携带授权码(Authorization Code)返回业务系统。

  3. 换取令牌:BFF 在服务端使用授权码换取 ID Token、Access Token 等令牌。

  4. 建立本地会话:BFF 验证 ID Token,确认用户身份后,建立业务系统自己的登录会话。

  5. 访问业务资源:后续调用文件 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 的调用过程如下:

  1. 证明客户端身份:后台服务通过 HTTPS 请求授权服务器,使用 Client Secret、私钥签名或 mTLS 等受支持的方式完成客户端认证。

  2. 申请访问令牌 :指定 grant_type=client_credentials,申请 file:read 等权限范围(Scope)。

  3. 获取并使用令牌 :授权服务器验证客户端身份及允许的授权范围,签发 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 确实是你有权使用的。

它的主要工作过程是:

  1. 客户端生成并持有一组公私钥。

  2. 授权服务器将访问令牌与客户端公钥绑定。

  3. 客户端调用 API 时,除了携带访问令牌,还需要使用私钥生成 DPoP 签名证明。

  4. 资源服务器验证令牌与公钥的绑定关系,以及证明中的请求方法、目标地址、时间和防重放信息。

这样一来,即使攻击者拿到了 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 进一步约束具体业务数据,是一种常见的组合方式。

在一次请求中组合权限模型

以员工下载文件为例,假设系统要求:员工必须具有文件读取权限、属于相同租户,并且是申请单经办人或有效共享对象。

那么,一次完整的权限校验可以分为三步:

  1. 检查功能权限(RBAC) :用户是否具备 file:read 权限?

  2. 检查业务属性(ABAC):用户与文件是否属于同一租户?文件当前状态是否允许下载?

  3. 检查业务关系(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 入口统一执行身份认证、令牌校验、访问限制等通用安全策略,具体能力取决于版本和插件

这些组件可以根据实际需要组合使用,并不要求全部引入。

例如,一套企业级文件中心可以采用以下分工:

  1. Keycloak:提供统一登录和令牌签发能力。

  2. API 网关:验证入口凭证,执行通用访问控制。

  3. Spring Security:在文件服务内部建立可信身份上下文,执行接口级权限校验。

  4. Casbin 或 OpenFGA:根据实际复杂度,管理角色权限或文件共享关系等细粒度授权规则。

  5. 业务服务:结合文件所属租户、业务状态、经办关系等数据,完成最终的资源权限判断。

这只是一个组合示例,并不是所有系统都需要部署完整的技术栈。对于业务简单的系统,使用 Spring Security 或 Sa-Token 配合业务权限校验,可能就足够了;只有在权限规则复杂、跨系统共享需求明显时,才有必要进一步引入独立的策略服务。

另外,无论采用什么框架或平台,都要明确身份由谁认证、令牌由谁签发和验证、会话由谁维护、权限由谁判断、退出和撤销由谁处理,避免多个组件职责重叠,或者出现无人负责的安全空白。

技术选型的关键,不是把所有安全组件堆在一起,而是让每个组件各司其职,同时确保认证和鉴权在整条调用链路中没有遗漏。


结语

从账号密码、Passkey,到 Session、JWT、OAuth 2.0,再到 RBAC、ABAC、API 网关,看似一大堆技术名词,其实归根结底就是解决几个问题:

  • 你是谁? ------ 认证,确认调用方的身份。

  • 你凭什么访问? ------ 验证凭证,确认请求是否可信。

  • 你能做什么? ------ 授权,明确允许执行的操作和访问范围。

  • 这次操作能放行吗? ------ 鉴权,结合具体资源和业务规则作出判断。

实际开发中,安全问题往往不是因为少用了某个框架,而是因为忽略了权限边界。Token 有效,不代表有权访问;拥有接口权限,不代表能操作所有数据;来自内部系统的请求,也不代表天然可信。

因此,设计认证与鉴权体系时,不必一味追求技术复杂度,而应坚持几个基本原则:身份可信、权限最小、默认拒绝、全程校验、可追溯、可撤销。

对于开发人员来说,真正重要的不是记住多少协议和框架,而是理解它们各自解决什么问题,在合适的场景选择合适的方案,并把安全控制落实到每一次真实的业务操作中。

好的认证与鉴权设计,不是让系统变得更复杂,而是让每一次访问都有依据、每一项权限都有边界。


本文的引用仅限自我学习如有侵权,请联系作者删除。

参考知识

写给开发者的认证与鉴权全教程


相关推荐
一条Go4 小时前
Pod 终端与日志:为什么浏览器建连要先换一张 60 秒的票
后端·架构·github
真上帝的左手6 小时前
26. AI-大语言模型-基础
人工智能·ai·架构·llm·大语言模型
挖掘狂人7 小时前
ThreadLocal 会内存泄露吗?
java·安全·架构
AAA修煤气灶刘哥7 小时前
Agent 都能干活了,软件还需要那么多按钮吗?
人工智能·后端·架构
伯奥克客服21 小时前
2026年视频综合一体机架构选型:从接口协议到流媒体底层的深度技术解析
架构·音视频
stark张宇1 天前
分布式事务方案设计与选型思考:2PC、TCC
分布式·架构
dahaihua3331 天前
用 SysML 表达航电系统架构(附建模示例)
设计模式·重构·系统架构·集成测试·需求分析·学习方法
zdr尽职尽责1 天前
Unity 3C 动画系统:从「蜘蛛网」到可维护的动画架构
unity·架构·游戏引擎
Decay__1 天前
SQLServer 监控体系构建 —— sql_exporter + Prometheus + Grafana 全栈实战
运维·数据库·sql·mysql·架构