如何使用Apple公钥验证JWT令牌

前置说明：你已经完成Apple公钥集合（JWKS）拉取、拿到客户端上报的ID Token（JWT格式），以下是公钥校验的完整可落地步骤，所有步骤需在业务字段校验（iss/aud/exp等）之前执行。

• 第一步：解析JWT头部拿到匹配参数
  把待校验的JWT字符串用.分割为3段，取第一段（Header段）做Base64URL解码，得到JSON格式的头部信息，提取两个核心字段：

  • kid：密钥ID，是JWT和公钥的匹配标识
  • alg：签名算法，Apple登录固定使用RS256，如果解析出的算法不是该值，直接判定令牌无效
    解码后的Header示例：

  {
    "kid": "AIDOPK1",
    "alg": "RS256"
  }
  

• 第二步：匹配JWKS中对应的公钥条目
  遍历拉取到的JWKS的keys数组，找到kid字段值和上一步提取的kid完全一致的条目，就是Apple给当前JWT签名对应的公钥参数。

  注意：Apple会定期轮换签名公钥，不要把公钥硬编码在本地永久缓存，校验时如果当前缓存的JWKS里找不到匹配的kid，重新拉取一次最新的JWKS再匹配即可。

• 第三步：基于JWK参数生成可用于校验的RSA公钥
  不要自己手写密码学转换逻辑，直接用对应技术栈的成熟JWT/JWK库完成转换：
  匹配到的JWK条目里已经包含了RSA公钥需要的所有参数，核心是n（模数）、e（公钥指数），直接把整个JWK对象传给库提供的JWK导入方法即可生成可用的公钥对象，不需要手动做字节组装。
  各主流技术栈直接用对应库即可，无需自己实现转换：

  • Node.js：使用jose库的importJWK方法导入
  • Java：使用auth0 java-jwt提供的JWK解析工具
  • Go：使用lestrrat-go/jwx库的jwk解析模块
  • Python：使用PyJWT配合cryptography库的JWK构造方法

• 第四步：执行JWT签名有效性校验
  把生成的公钥、待校验JWT原文、指定签名算法RS256（不要让库自动读取JWT头部的算法，避免算法篡改攻击）传入JWT库的校验方法：

  • 校验通过：证明JWT确实是Apple官方签发、传输过程中没有被篡改，可以进入后续的业务字段校验流程
  • 校验失败：直接判定令牌非法，拒绝本次登录请求
    Node.js环境下基于jose库的最简实现示例（库会自动完成kid匹配、公钥拉取/转换、校验全流程，不需要手动实现前三步）：

  import { createRemoteJWKSet, jwtVerify } from 'jose'
  // 初始化JWKS实例，传入Apple公钥接口地址即可
  const appleJWKS = createRemoteJWKSet(new URL('Apple官方公钥接口地址'))
  // 执行校验
  const { payload } = await jwtVerify(clientIdToken, appleJWKS, {
    algorithms: ['RS256'], // 强制指定算法，避免攻击
    issuer: 'Apple官方签发方标识',
    audience: '你自己的App Bundle ID'
  })
  

常见坑点：90%的自实现校验失败问题，都是手动转换公钥时Base64URL补位、字节序处理错误导致的，不要自己实现底层密码学逻辑，直接用成熟开源库的现成方法即可。

内容的提问来源于stack exchange，提问作者Zephyr