如何在MongoDB中安全存储OAuth2.0 refresh token

• 禁止明文存储：refresh token属于高敏感凭证，和账号密码安全等级一致，必须使用AES-256-GCM这类带完整性校验的对称加密算法加密后存储，严禁明文、哈希存储——注意哈希是单向运算，哈希后你无法取出原始令牌调用Twitter接口，完全不可用。
• 密钥与存储分离：加密密钥绝对不能和令牌存在同一个MongoDB实例里，要存放在独立的密钥管理服务、服务端环境变量或硬件安全模块中，密钥需按季度定期轮换，轮换时要兼容解密旧数据、批量重加密为新密钥加密的密文。
• 最小化存储原则：不需要持久化存储access token，Twitter的access token有效期仅2小时，需要调用接口时用refresh token实时换取即可，落库access token只会增加泄露风险无实际收益；令牌集合仅保留必要字段：关联用户ID、加密后的refresh token、加密密钥版本、令牌过期时间、授权scope、上次使用时间。
• 全链路访问控制：存储令牌的数据库必须开启TLS传输加密，禁止明文传输数据；所有对令牌集合的访问都要做权限收敛，非业务相关账号（运维、数据分析、测试账号）一律无访问权限；所有读写操作要留审计日志，记录操作主体、时间、操作类型，日志中禁止出现令牌明文/密文。
• 令牌生命周期管理：Twitter的OAuth2.0默认开启refresh token轮换，每次用refresh token换取新access token时，平台会返回新的refresh token，此时必须立刻将库中旧令牌替换为新加密后的新令牌，旧令牌直接作废；检测到令牌被用户撤销、过期或无效时，第一时间删除库中对应记录。

集合与索引设计 #

建议单独创建oauth_refresh_tokens集合存储Twitter授权凭证，单文档结构参考如下：

{
  _id: ObjectId("文档自增ID"),
  user_id: ObjectId("你的平台侧用户唯一ID"), // 绑定自有账号体系
  encrypted_refresh_token: BinData(0, "AES-256-GCM加密后的二进制密文"), // 用MongoDB二进制类型存储，不要转字符串存
  key_version: "v202406", // 标记加密使用的密钥版本，适配密钥轮换逻辑
  expires_at: ISODate("Twitter返回的refresh token过期时间"),
  scopes: ["tweet.write", "offline.access", "users.read"], // 记录授权范围，避免越权调用
  last_used_at: ISODate("上次调用接口换取access token的时间"),
  created_at: ISODate("首次授权时间")
}

索引配置：

• 给user_id字段创建唯一索引，保证一个平台用户仅对应一条有效的Twitter令牌记录
• 给expires_at字段创建TTL索引，设置自动删除过期超过7天的无效记录，自动清理脏数据

加解密逻辑实现 #

加解密逻辑统一在应用服务层实现，不要放到数据库侧执行：

• 加密时为每个refresh token单独生成12字节长度的随机初始化向量（IV），禁止使用固定IV；IV不需要保密，可以和GCM模式生成的16字节认证标签、密文按顺序拼接后，统一作为encrypted_refresh_token字段存入MongoDB
• 解密时先从二进制字段中拆分出IV、认证标签、密文，先做完整性校验，校验通过再解密出原始refresh token，防止密文被篡改
• 如果有条件可以直接启用MongoDB原生的客户端字段级加密（CSFLE），直接对encrypted_refresh_token字段做自动加解密，密钥托管在独立KMS中，就算数据库被拖库，没有密钥也无法解密字段内容，比应用层自行实现加密的安全等级更高

数据库安全配置 #

• 开启MongoDB静态加密（磁盘级加密），作为存储层的兜底安全防护，避免磁盘失窃导致数据泄露
• 数据库账号权限收敛：给业务服务分配的数据库账号，仅授予oauth_refresh_tokens集合的find、insert、update权限，禁止分配remove、drop、createIndex等高危权限
• 禁止公网暴露MongoDB实例，仅允许应用服务所在VPC的内网IP访问数据库，配置IP白名单拦截所有非信任来源的访问请求
• 数据库备份文件必须做二次加密，备份的访问权限收敛到仅核心运维人员可访问，避免备份文件泄露导致令牌批量泄露

避坑提醒：不要为了排查问题在业务日志、错误上报中打印refresh token的明文或者密文，调试阶段遇到相关字段必须做全打码处理。

内容的提问来源于stack exchange，提问作者Dashiell Rose Bark-Huss