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

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

原文: https://fdetimes.net/zh/guides/api-key-basic-auth-session-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 字符。

问题在哪，用一个测试账号亲手试一下最快：

```bash
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 一样解码它：

```bash

TOKEN='xxxxx.yyyyy.zzzzz'

echo "$TOKEN" | cut -d. -f2 | base64 -d

# 可能需要在末尾补上 '=' 字符，才能正确填充

```

（注释提示，可能需要在末尾补 `=` 字符来完成填充。）

根据 jwt.io 的说明，签名用于验证消息在传输中没有被修改。它证明的是数据完整性，并不隐藏数据。任何拿到 Token 的人都能读取 payload。因此，不要把机密信息放进只签名、未加密的 JWT。

反过来的问题同样容易被忽略：接收方必须校验 Token。Auth0 文档要求，收到的 JWT 在使用前必须先验证签名。如果你的代码只解码 payload、直接读取 `user_id` 而不做校验，任何人都可以自己写一个 Token 冒充别人。

**要点:** Base64 只是编码，什么也保护不了。签名能证明数据没有被篡改，但不负责保密。

## 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）岗位的求职材料里，不要把客户真实的认证地图带出去，可以在个人项目上重做一份，或者做彻底的脱敏处理。

下次再有人说“认证已经配好了”，你就知道接下来该问什么了。

**本周动手试试:**

- 在你使用的某个内部应用上打开 DevTools，找到某个请求的 Authorization 请求头或 Cookie，把它准确归入五种机制中的一种
- 从测试环境取一个 JWT，对 payload 做 base64 解码，记下不应该暴露的字段
- 为当前项目写一页“认证地图”：每个系统用哪种机制，凭证存在哪里，过期后由谁重新签发

## 信源

- [Basic Authentication (Swagger)](https://swagger.io/docs/specification/authentication/basic-authentication/)

- [Basic Authentication (Twilio)](https://www.twilio.com/docs/glossary/what-is-basic-authentication)

- [What Is API Authentication? Benefits, Methods & Best Practices | Postman](https://www.postman.com/api-platform/api-authentication/)

- [Session vs Token Authentication: Which Should You Choose?](https://www.authgear.com/post/session-vs-token-authentication)

- [JSON Web Token Introduction - jwt.io](https://jwt.io/introduction)

- [JSON Web Tokens (Auth0 Docs)](https://auth0.com/docs/secure/tokens/json-web-tokens)

- [What Is Token-Based Authentication? (Okta)](https://www.okta.com/uk/identity-101/what-is-token-based-authentication/)

- [Final: OpenID Connect Core 1.0 incorporating errata set 2](https://openid.net/specs/openid-connect-core-1_0.html)
