You need to enable JavaScript to run this app. 在Delphi REST API中使用jose-jwt校验Azure AD客户端令牌的方法
优惠活动
大模型
产品
解决方案
定价
更多

在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 20:36:06