Bearer 令牌是在 HTTP Authorization 标头中以“Bearer <token>”发送的凭据;持有者即可使用,所以只能通过 HTTPS 传输并作为机密保存。
Bearer 方案是最简单的 HTTP 身份验证形式,最初在 RFC 6750 中为 OAuth 2.0 定义,如今的使用范围早已远超于此。客户端发送 Authorization: Bearer,后面跟上令牌;服务器只检查令牌,别的一概不查:请求本身不签名,持有令牌就是唯一需要的证明。顾名思义(bearer 即“持有者”),谁持有令牌,令牌就对谁有效,就像现金一样。
这使 Bearer 身份验证既方便又通用,但也把全部安全性寄托在两个环节上:传输加密,使令牌在传输途中无法被读取;以及两端对机密的妥善处理。与对每个请求签名的方案相比,Bearer 令牌集成起来要容易得多;对于服务器之间的调用,只要令牌限定了权限、定期轮换并按 IP 加以限制,其安全性也不相上下。令牌可以是不透明的(就像大多数 API 密钥),由服务器查找核对;也可以是自包含的(就像 JSON Web Token),由服务器验证;无论哪种,标头都完全一样。
示例
假设一名开发者在调试某个集成时,把一条完整的 cURL 命令连同正式密钥一起粘贴到公开的问题跟踪系统中。现在,任何复制了它的人都能用该账户的余额发送消息。编辑帖子无济于事,因为密钥可能已经被复制;撤销它并签发新密钥才有用。
常见错误
- 在 URL 查询字符串中传递令牌,令牌最终会出现在日志和浏览器历史记录中。
- 通过未加密的 HTTP 发送令牌,哪怕只有一次,哪怕是在测试中。
- 给令牌加上引号,或漏掉
Bearer后面的空格。 - 完整记录
Authorization标头。
在 SMSMeteor:每个 API 请求都携带 Authorization: Bearer sk_live_…,测试时则使用 sk_test_ 密钥。密钥的权限限定为 send、read 或两者兼有,并可附带 IP 允许名单;缺失、已撤销、权限不符或受 IP 限制的密钥会得到 401 unauthorized。反方向的流量采用不同的验证方式:发送到你的 Webhook 端点的事件带有 HMAC 签名。关于密钥的更多内容,请参阅 API 密钥词条和安全页面。
