敏感参数不要放在 URL 里---->从 `validateLogin` 与短信验证码接口看 GET / POST 的安全边界
关键词:GET、POST、URL 泄露、Nginx 日志、token、手机号、短信验证码、接口设计
1. 摘要
很多接口在功能上“GET 也能实现”,但从安全角度看,只要参数里包含敏感信息,就不应该放在 URL 上。
典型的两类参数:
- 登录 token:一旦泄露,攻击者可以直接复用登录态;
- 手机号:属于个人敏感信息,泄露后可能被用于骚扰、撞库、精准诈骗,短信接口本身还可能被恶意刷取。
本文结合两个真实改造场景说明:
validateLogin的 token 参数从 GET 改为 POST;- 短信验证码发送接口的手机号参数从 GET query 改为 POST body。
核心结论不是“POST 比 GET 更安全”这么简单,而是:
敏感参数不能进入 URL;POST 只是让参数离开 URL 的第一步。
2. URL 会留下哪些痕迹
一个看似普通的请求:
GET /sys/validateLogin?token=eyJhbGciOiJIUzI1NiJ9.xxxxx HTTP/1.1
Host: example.com
URL 中的 token 可能出现在至少以下位置:
| 位置 | 说明 |
|---|---|
| Nginx / Apache access log | 默认 $request 会记录完整请求行,包含 query string |
| 网关 / WAF / CDN 日志 | 大多数网关默认记录完整 URL |
| APM / 链路追踪 | 很多组件把 URL 作为 span name 或 tag |
| 浏览器历史记录 | 前端直接发起的请求 URL 可能被记录 |
| 浏览器 Network 面板 | 开发、排障、录屏时容易暴露 |
| Referer | 页面 URL 中的敏感参数会随后续资源请求带出 |
| 书签 / 分享 / 截图 | URL 被复制、截图、发群聊 |
| 代理、负载均衡、安全审计系统 | 只要经过,就可能落盘 |
也就是说,参数放在 URL 里,等于默认交给了整条链路的所有日志系统。而这些日志的访问权限,通常远大于业务数据库。
3. 案例一:validateLogin 的 token 从 GET 改为 POST
3.1 改造前的请求
GET /sys/validateLogin?token=eyJhbGciOiJIUzI1NiJ9.xxxxx HTTP/1.1
Nginx access log 中可能出现:
10.0.0.12 - - [10/Nov/2026:23:20:11 +0800] "GET /sys/validateLogin?token=eyJhbGciOiJIUzI1NiJ9.xxxxx HTTP/1.1" 200 128
这条日志意味着:
- 任何能看日志的人都能拿到一个仍在有效期内的登录 token;
- token 可能被复制到测试工具、工单、聊天记录中;
- 日志轮转、备份、归档会继续扩大暴露面;
- 如果 token 同时代表某个企业/账号的登录态,影响范围不止一个接口。
3.2 改造后的请求
POST /sys/validateLogin HTTP/1.1
token: eyJhbGciOiJIUzI1NiJ9.xxxxx
Content-Type: application/json
Nginx 默认 access log 只看到:
10.0.0.12 - - [10/Nov/2026:23:20:11 +0800] "POST /sys/validateLogin HTTP/1.1" 200 128
URL 里不再有 token。
3.3 为什么不是“把 GET 改 POST,但 token 还放 query”
POST /sys/validateLogin?token=eyJhbGciOiJIUzI1NiJ9.xxxxx
这只是换了 HTTP 方法,token 仍然在 URL 里,Nginx 日志仍然会记录。方法不是重点,参数位置才是重点。
正确的方向是:
- 方法用 POST;
- 敏感参数放到请求头或请求体;
- 服务端不再从 query 读取敏感参数。
3.4 token 放在 header 还是 body
两种都可以,取决于接口语义和调用方:
- 请求头:适合“认证凭证”类信息,如
token、Authorization; - 请求体:适合业务参数或需要和请求体一起传输的数据。
这次 validateLogin 采用请求头传递 token,同时把企业信息获取拆到独立接口,登录校验接口只负责校验,避免 token 和业务数据混在一个响应里。
4. 案例二:短信验证码接口的手机号不能走 GET
4.1 常见写法
GET /api/agent/profit/sendSms?phone=13812345678 HTTP/1.1
或:
GET /api/huichuxing/driver/sendSms?phone=13812345678 HTTP/1.1
日志中会直接出现:
GET /api/agent/profit/sendSms?phone=13812345678 HTTP/1.1
手机号是个人敏感信息,泄露风险和 token 不同,但同样严重:
- 手机号可用于骚扰、诈骗、撞库;
- 结合业务系统,可推断某手机号是否注册、是否某企业员工;
- 短信发送有成本,URL 被爬虫、监控、链接预览访问会造成资损;
- 日志、工单、截图中的手机号很难彻底回收。
4.2 推荐写法
POST /api/agent/profit/sendSms HTTP/1.1
Content-Type: application/json
{
"phone": "13812345678"
}
Nginx 默认日志只看到:
POST /api/agent/profit/sendSms HTTP/1.1
手机号不再进入 URL。
4.3 短信接口还有一个语义问题
短信发送是有副作用的操作:
- 会产生真实短信费用;
- 会改变用户收到的验证码状态;
- 可能触发风控、频控、黑名单。
按照 HTTP 语义,这类操作本来就不应该是 GET。GET 被设计为安全、幂等、可缓存的读取操作,浏览器、爬虫、预取器、监控探针都可能主动发起 GET 请求。
用 POST 表达“发送短信”这个动作,既符合语义,也降低被误触发的概率。
5. GET 与 POST 的对比
| 维度 | GET | POST |
|---|---|---|
| 参数位置 | URL query | 请求体 |
| 默认日志 | 请求行包含完整 query | 请求行通常不包含 body |
| 浏览器历史 | 容易记录完整 URL | 通常不记录 body |
| 缓存 | 可被浏览器/代理缓存 | 默认不缓存 |
| 幂等语义 | 应为安全、幂等 | 可表达有副作用的操作 |
| 敏感信息 | 不建议放 | 相对更适合放 |
| 长度限制 | 受 URL 长度限制 | 基本不受 URL 长度限制 |
| CSRF | 通常不涉及 | 需要关注 CSRF(Cookie 鉴权场景) |
注意:POST 不是加密。
- POST 请求体仍然可能被网关、WAF、APM、业务日志记录;
- 没有 HTTPS 时,GET 和 POST 都能被中间人看到;
- 真正的安全需要“HTTPS + 参数不落 URL + 日志脱敏 + 最小化记录”。
6. 设计原则:敏感参数“三不”
6.1 不进 URL
包括:
- token、access_token、refresh_token;
- 手机号、身份证号、银行卡号;
- 密码、验证码、短信票据;
- 邮箱、地址等个人敏感信息。
统一原则:
URL 只放资源标识和分页、筛选等非敏感参数。
6.2 不进默认日志
即使参数已经不在 URL,也要检查:
- 业务代码是否
log.info("param: {}", request); - 网关/WAF 是否记录完整 body;
- APM 是否采集请求体;
- 异常堆栈是否打印了敏感字段。
推荐:
- token 只打印前缀或哈希;
- 手机号脱敏为
138****5678; - 验证码、密码永不打印;
- 统一日志脱敏工具,而不是每个接口各写一套。
6.3 不被缓存
认证、短信、登录类接口应返回:
Cache-Control: no-store
避免浏览器、代理、CDN 缓存敏感响应。
7. 落地建议
7.1 接口改造
对于敏感参数接口:
- 方法改为
POST; - 参数改为
@RequestBodyDTO 或请求头; - 删除
@RequestParam读取敏感字段的入口; - 保留一段兼容期时,也要同时支持新旧方式并监控调用量,避免长期双入口。
示例:
@PostMapping("/sendSms")
public Result<Void> sendSms(@RequestBody SendSmsRequest request) {
String phone = request.getPhone();
...
}
public class SendSmsRequest {
private String phone;
}
7.2 Nginx / 网关日志
默认日志格式通常包含:
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" "$http_user_agent"';
其中 $request 包含 query string。建议:
- 对敏感接口不记录
$args; - 使用
map对特定 URI 做条件日志; - 或统一在日志采集侧对
token、phone等字段脱敏; - 不要把“日志脱敏”当成唯一防线,源头不落 URL 才是根本。
7.3 迁移策略
前端/调用方需要同步改造时:
- 后端先发布同时支持新旧方式,但新方式优先;
- 前端切换后观察旧方式调用量;
- 旧方式归零后下线;
- 对旧 GET 入口返回明确的迁移提示,而不是长期静默兼容。
8. 常见误区
误区一:POST 就一定安全
POST 只是把参数从 URL 移到 body。若 body 被网关日志、APM、业务日志记录,仍然会泄露。
误区二:放在 header 就一定安全
Header 也可能被某些代理、网关、调试工具记录。敏感 header 同样要脱敏。
误区三:内网接口不需要管
内网日志、测试环境、开发机、工单系统同样可能外泄;内部威胁和误操作是真实风险。
误区四:GET 改 POST 只是改注解
如果方法改了但参数还在 query,等于没改。必须同时检查参数位置、日志、缓存和调用方。
9. 检查清单
接口上线前可以逐项确认:
10. 结论
GET 改 POST 不是形式主义,而是把敏感参数从“默认会被记录的地方”移到“可以控制的地方”。
- token 放 URL:等于把登录凭证交给日志系统;
- 手机号放 URL:等于把个人敏感信息交给日志系统,还可能被爬虫和预取器利用;
- 敏感参数进 body/header + 日志脱敏 + HTTPS:才是完整的防线。
先做到“敏感参数不进 URL”,再谈日志治理、缓存控制和最小化采集,顺序不能反。
当看到一些不好的代码时,会发现我还算优秀;当看到优秀的代码时,也才意识到持续学习的重要!--buguge
本文来自博客园,转载请注明原文链接:https://www.cnblogs.com/buguge/p/23673953
浙公网安备 33010602011771号