FDE Times 数据在招 FDE 职位 924▲33 近 7 天在招职位数的变化(同口径比较):不计入本周新开始追踪的公司的职位近 7 天新增 80在招公司 196支持远程 25%美国薪资中位数 $200k招聘最多 Databricks 107
ENVI

前线部署工程师(FDE)的专业媒体

技能指南 · 指南

“认证已经配好了”,可能是五种不同的机制

三个问题看懂客户的认证方案:凭证放在哪,服务器是否保存状态,谁为用户身份担保。

分享微博

要点速览

  • Base64 是编码,不是加密。Basic Auth 和 API Key 都必须通过 HTTPS 传输。
  • Session 要求服务器记住状态,并且绑定域名。JWT 无需存储,但使用前必须校验签名。
  • JWT 签名只证明数据没有被篡改,不负责保密。要知道用户是谁,需要 OIDC。
一张分三行列出问题的信息图。问题一,凭证放在哪里:在 Authorization 请求头中(Basic 是 user:pass 的 base64 字符串,可立即解码),或在 Cookie 中(浏览器会话,通常绑定一个域名);Basic 和 API Key 必须走 HTTPS。问题二,服务器是否需要记住什么:Session 需要(有状态,更难扩展),Token 不需要(无状态);运行在其他域名上的 Agent 很难复用 Session Cookie。问题三,谁为身份担保:JWT 只是一种 Token 格式,不等同于 OIDC,后者是 OAuth 2.0 之上的身份层,图中用强调色标出;应询问客户由哪个系统签发身份。
看一个请求时要回答的三个问题:凭证放在哪里,服务器是否需要记住什么,谁为身份担保。JWT 只是一种 Token 格式,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 个信源
路线图上的下一篇 · 阶段 2: 全栈工程能力客户网络上演示崩了,问题不在代码407、504 和一行红色 CORS 报错分属不同层,按 DNS、代理、状态码、浏览器的顺序排查最快。