NodeJS开发API与SDK时如何引导用户安全传递API密钥

你当前的实现存在几个明确的安全隐患：

• 传输层泄露风险：如果没有强制全链路HTTPS，密钥作为请求参数明文传输时，中间人可以直接窃听拿到完整密钥；就算启用了HTTPS，如果把密钥放在URL Query参数中传递，密钥会被代理服务器、CDN、Web服务器的访问日志、浏览器历史记录明文留存，泄露概率极高。
• 缺少请求完整性校验：仅校验密钥是否合法，无法识别被篡改的请求，中间人截获请求后可以修改请求参数、请求体内容，只要携带合法密钥后端就会正常执行；同时没有防重放机制，攻击者截获合法请求后可以重复发起请求，造成接口被恶意刷取。
• 客户端存储风险：如果你的SDK是给浏览器、移动端这类不可信公开环境使用，直接把静态API密钥传入SDK的方式，会让密钥很容易被逆向、抓包拿到，导致接口被盗刷。
• 你当前后端存储密钥的思路（接收密钥后哈希、和数据库预存的哈希值比对）方向是对的，但如果使用MD5、SHA1这类弱哈希算法，且没有给每个密钥加独立盐值，一旦数据库泄露，攻击者可以通过彩虹表快速逆推出原始密钥。

按照优先级落地以下措施即可：

• 强制启用全链路HTTPS，禁用TLS1.0、TLS1.1等老旧不安全协议，只保留TLS1.2及以上版本，从传输层杜绝明文窃听、篡改的可能。
• 规范密钥传递位置：绝对不要把密钥放在URL Query参数中，统一放到标准Authorization请求头中，格式参考Bearer <你的API密钥>，最大程度避免密钥被日志系统留存。
• 调整SDK的使用逻辑：不要在每次调用业务方法时传入密钥，改为初始化SDK实例时一次性传入密钥配置，后续业务调用由SDK内部统一处理鉴权逻辑，减少业务代码中密钥散落、误传的风险，示例初始化代码如下：

// 推荐的SDK初始化方式
const client = new APIClient({
  apiKey: "key_randomKey"
})
// 业务调用无需再传密钥
client.messages.send({body: "Hello"})

• 优化密钥存储逻辑：后端生成API密钥时，必须使用密码学安全的随机数生成器，密钥长度不低于32字节，保证密钥熵足够；存储密钥时使用Argon2id、bcrypt这类慢哈希算法，给每个密钥生成独立的随机盐值后再做哈希存储，禁止明文、弱哈希存储密钥。
• 增加签名与防重放机制：如果是服务端对服务端的调用场景，SDK侧发起请求时，需要将当前时间戳、唯一随机请求串（nonce）、请求方法、请求路径、请求体的哈希值与API密钥拼接后做HMAC-SHA256签名，将签名、时间戳、nonce一并放到请求头传递；后端收到请求后首先校验时间戳与服务器时间差是否超过5分钟，再校验nonce是否在最近5分钟内已经被使用过，最后校验签名是否匹配，从根源上防止请求篡改、重放攻击。
• 做好密钥生命周期管理：支持密钥快速轮换、主动作废，给密钥设置最长有效期，禁止永久有效密钥；如果SDK运行在浏览器、移动端等不可信环境，不要直接下发长期静态API密钥，改为通过服务端接口换取有效期15分钟以内的临时鉴权凭证，降低凭证泄露后的影响范围。
• 全链路日志脱敏：所有网关、服务、错误监控系统的日志中，必须对Authorization头等携带密钥的字段做脱敏处理，禁止打印完整密钥内容。

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