在Delphi REST API中使用jose-jwt校验Azure AD客户端令牌的方法
Delphi基于jose-jwt校验Azure AD令牌的实现方案
核心报错根因
触发Key is not RSA key in PEM format报错的核心原因是格式不匹配:Azure AD公开分发的公钥是JSON Web Key结构化格式,不是jose-jwt库原生支持的PEM编码RSA公钥结构,直接传入原始JWK内容会被库的密钥格式校验拦截。
完整操作流程
- 第一步:提取令牌匹配标识
对客户端传入的Azure AD Bearer令牌做Base64Url解码,取出令牌Header段中的kid字段值,作为后续匹配公钥的唯一标识。 - 第二步:匹配对应公钥参数
从Azure AD公开的JWKS公钥集合中,按照提取到的kid值定位到对应的公钥条目,取出公钥的两个核心RSA参数:Base64Url编码的模数n、公钥指数e。 - 第三步:转换为库支持的PEM格式RSA公钥
这一步是格式适配的核心环节:- 分别对
n和e的Base64Url编码内容做解码,得到原始二进制数据 - 按照PKCS#8标准的RSA公钥ASN.1结构,把两个参数拼接成完整的公钥二进制结构
- 将拼接好的二进制结构做Base64编码,套上标准PEM格式的首尾标记,最终格式参考:
-----BEGIN PUBLIC KEY----- (按每行64字符拆分的Base64编码公钥内容) -----END PUBLIC KEY-----
n、e参数拼装公钥,不要直接使用JWK条目中附带的X509证书链内容,不同版本jose-jwt的RSA模块对证书链提取公钥的兼容性存在差异,拼装得到的裸RSA公钥适配性最好。 - 分别对
- 第四步:完成令牌合法性校验
按照jose-jwt的原生RSA校验逻辑执行操作:- 初始化令牌校验器,指定RS256为签名校验算法(Azure AD v2.0默认采用RS256算法对访问令牌签名)
- 把转换完成的PEM格式RSA公钥传入校验器,完成令牌签名的合法性验证
- 签名通过后必须补充校验Azure AD令牌特有的声明规则,才算完成完整的合法性校验:
- 校验令牌的
iss(发行方)字段和对应注册应用的发行方配置完全匹配 - 校验令牌的
aud(受众)字段和你在Azure平台注册的应用Client ID完全一致 - 校验令牌的
exp(过期时间)字段值大于当前服务器时间 - 校验令牌的
nbf(生效时间)字段值小于等于当前服务器时间
- 校验令牌的
常见实操注意事项
- 不要混用jose-jwt的非对称校验和对称校验逻辑:RSA非对称校验和HMAC对称校验的密钥初始化流程完全独立,混用会直接触发格式报错。
- 公钥需要做本地缓存存储:不要每次校验令牌都实时拉取JWKS公钥集合,避免网络波动导致服务不可用。公钥本身有效期较长,以
kid为缓存键存储即可,遇到本地没有匹配kid的令牌时,再触发一次JWKS集合的拉取和缓存更新。 - 注意单租户、多租户应用的发行方声明差异:两类应用的
iss字段值规则不同,不要硬编码错配校验规则。
内容的提问来源于stack exchange,提问作者Miguel Stokes
相关产品推荐
相关产品推荐

