“认证已经配好了”,可能是五种不同的机制
三个问题看懂客户的认证方案:凭证放在哪,服务器是否保存状态,谁为用户身份担保。
要点速览
- Base64 是编码,不是加密。Basic Auth 和 API Key 都必须通过 HTTPS 传输。
- Session 要求服务器记住状态,并且绑定域名。JWT 无需存储,但使用前必须校验签名。
- JWT 签名只证明数据没有被篡改,不负责保密。要知道用户是谁,需要 OIDC。
驻场第一周,你接到任务:把一个 Agent 接入客户的内部系统。客户那边的工程师发来消息:“直接调 API 就行,认证已经配好了。”第一个请求返回 401,你这才意识到,“已经配好了”可能指五种完全不同的机制。
API Key、Basic Auth、Session Cookie、JWT 和 OIDC 解决的是不同的问题,出错的方式也各不相同。看错了机制,很容易做出一个在笔记本上能跑、到生产环境就出问题的集成。更糟的是,凭证可能在没人察觉的情况下写进日志。
这项技能不需要背规范,而是能看着一个请求回答三个问题:凭证放在哪里,服务器是否需要记住什么,谁为用户身份担保。
Basic Auth 看起来像隐藏了密码,其实没有
Basic Auth 是 HTTP 内置的认证方案。客户端把用户名和密码拼成 username:password 字符串,做 base64 编码,再按 Twilio 文档描述的格式放进请求头:先写 Authorization: Basic,后面跟上这串 base64 字符。
问题在哪,用一个测试账号亲手试一下最快:
echo -n 'user:pass' | base64
# dXNlcjpwYXNz
echo 'dXNlcjpwYXNz' | base64 -d
# user:pass
不需要密钥,也没有什么可破解的,因为 base64 是编码,不是加密。Postman 明确指出,Basic Auth 凭证既没有哈希,也没有加密。Swagger 文档建议只在配合其他安全机制(例如 HTTPS)时使用 Basic Auth。
API Key 的风险和 Basic Auth 属于同一类。Postman 将 API Key 定义为发给注册用户的标识符,并强调它必须通过 HTTPS 传输才安全。
所以在客户现场,第一件事很简单:确认每个接受 API Key 或 Basic Auth 的端点都走 HTTPS,包括那些“只在内网用”的端点。
Session 还是 Token:区别在于谁来记
接下来两种机制的差异在架构上,不只是格式。Authgear 将 Session 认证描述为有状态:服务器在内存中保存状态,浏览器持有 Cookie。JWT 则是无状态的,后端不需要存储 Token。
Okta 对基于 Token 的认证也是同样的解释:验证一次身份,签发一个 Token,此后服务器不再保留会话记录。Authgear 还指出,存储在服务器端的 Session 更难扩展。
设想客户有一个使用 Session Cookie 的内部 Web 应用,而你需要让运行在另一个域名上的 Agent 调用这个应用的后端。Cookie 通常只在同一个域名或其子域名下有效,你的 Agent 很难“借用”用户的会话。
实际结论是:不要试图模拟浏览器去拿 Cookie。问客户后端是否支持为不在浏览器中运行的客户端签发 Token。如果不支持,这一项应该从一开始就写进范围,而不是留到以后靠变通方案解决。
打开一个 JWT,看看它并不保密
JWT 由三部分组成,用点号分隔:header、payload 和 signature。你可以取出中间那部分,像解码 Basic Auth 一样解码它:
TOKEN='xxxxx.yyyyy.zzzzz'
echo "$TOKEN" | cut -d. -f2 | base64 -d
# 可能需要在末尾补上 '=' 字符,才能正确填充
(注释提示,可能需要在末尾补 = 字符来完成填充。)
根据 jwt.io 的说明,签名用于验证消息在传输中没有被修改。它证明的是数据完整性,并不隐藏数据。任何拿到 Token 的人都能读取 payload。因此,不要把机密信息放进只签名、未加密的 JWT。
反过来的问题同样容易被忽略:接收方必须校验 Token。Auth0 文档要求,收到的 JWT 在使用前必须先验证签名。如果你的代码只解码 payload、直接读取 user_id 而不做校验,任何人都可以自己写一个 Token 冒充别人。
JWT 不告诉你用户是谁,OIDC 才会
很多工程师看到客户用 JWT,就以为身份问题已经解决了。实际上 JWT 只是一种 Token 格式。OpenID Connect Core 规范将 OIDC 描述为 OAuth 2.0 之上的一个简单身份层,回答“这个用户是谁”的正是这一层。
这个区别决定了需求调研时该怎么提问。不要问“你们用 JWT 吗?”,而要问“由哪个系统签发用户身份?我们的 Agent 以谁的身份登录?”
| 机制 | 凭证位置 | 服务器是否保存状态? | 首先要检查的风险 |
|---|---|---|---|
| Basic Auth | Authorization: Basic 请求头 |
否 | 端点没有走 HTTPS |
| API Key | 由 API 自行定义 | 否 | 没有 HTTPS 时密钥暴露 |
| Session | Cookie | 是 | 跨域调用,难以扩展 |
| JWT | 客户端持有的 Token | 否 | 未校验签名,payload 中放了机密 |
| OIDC | OAuth 2.0 之上的身份层 | 取决于实现 | 把 Token 格式和身份混为一谈 |
写第一行代码前的五分钟例行检查
先通过 DevTools 或代理抓取客户应用发出的真实请求,查看 Authorization 请求头和 Cookie,这样就知道凭证放在哪里。接着试着解码:如果是 Basic,你会直接看到用户名;如果是 JWT,你会看到 payload。
然后问客户两个问题:服务器是否保存 Session?凭证过期后由谁重新签发?最后把所有信息写成一份简短的“认证地图”,请客户团队确认。这份文档会成为日后排查问题的依据。
FDE 的常见错误
最常见的错误是把 base64 编码当成加密,然后把完整的 Authorization 请求头写进调试日志。第二种是解码 JWT 获取用户信息,却跳过签名校验。第三种是试图为另一个域名上的客户端复用 Session Cookie,而 Cookie 本身就绑定在一个域名上。
最难发现的错误出在沟通上:在范围文档里写一句“使用 JWT”,就以为一切都清楚了。在有人能回答“身份从哪里来”之前,项目最难的部分其实还没碰。
本周练习:选一个你正在集成的系统,按上表的四列写一份认证地图,看看团队犯了其中哪些错误。
如果想把这个练习用在前线部署工程师(FDE)岗位的求职材料里,不要把客户真实的认证地图带出去,可以在个人项目上重做一份,或者做彻底的脱敏处理。
下次再有人说“认证已经配好了”,你就知道接下来该问什么了。
这篇文章对你有帮助吗?
感谢你的反馈!
8 个信源
- Basic Authentication (Swagger)
- Basic Authentication (Twilio) · 2025-09-25
- What Is API Authentication? Benefits, Methods & Best Practices | Postman
- Session vs Token Authentication: Which Should You Choose? · 2026-02-28
- JSON Web Token Introduction - jwt.io
- JSON Web Tokens (Auth0 Docs)
- What Is Token-Based Authentication? (Okta) · 2026-08-28
- Final: OpenID Connect Core 1.0 incorporating errata set 2 · 2023-12-15