API 密钥与凭证管理

面向开发者的凭证形态之一:用于识别调用方而非认证具体用户;要支持签发、轮换、吊销与最小权限绑定,密钥只存哈希、不明文落库。

签发按应用签发,绑定权限范围与配额
存储服务端存哈希;仅在创建时展示一次明文
治理定期轮换、异常调用审计、离职与下线回收

密钥治理清单

环节做法
签发按应用与用途签发,绑定权限与配额
存储服务端只存哈希,明文仅展示一次
轮换到期前双密钥并行,平滑切换
吊销即时生效并保留历史调用审计
API Key 放进前端或仓库会泄露;公开场景优先用带用户上下文的 OAuth/OIDC 方案。

易错点

  • 密钥明文存库并出现在日志,泄露面扩大
  • 一个密钥全权限通用,无法按调用方审计与限流

数据来源与参考

  • OWASP API Security Top 10(2023):API2 Broken Authentication
  • Google API 设计指南:Authentication
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌