敏感参数不要放在 URL 里---->从 `validateLogin` 与短信验证码接口看 GET / POST 的安全边界

关键词:GET、POST、URL 泄露、Nginx 日志、token、手机号、短信验证码、接口设计


1. 摘要

很多接口在功能上"GET 也能实现",但从安全角度看,只要参数里包含敏感信息,就不应该放在 URL 上。

典型的两类参数:

  1. 登录 token:一旦泄露,攻击者可以直接复用登录态;
  2. 手机号:属于个人敏感信息,泄露后可能被用于骚扰、撞库、精准诈骗,短信接口本身还可能被恶意刷取。

本文结合两个真实改造场景说明:

  • validateLogin 的 token 参数从 GET 改为 POST;
  • 短信验证码发送接口的手机号参数从 GET query 改为 POST body。

核心结论不是"POST 比 GET 更安全"这么简单,而是:

敏感参数不能进入 URL;POST 只是让参数离开 URL 的第一步。


2. URL 会留下哪些痕迹

一个看似普通的请求:

http 复制代码
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 改造前的请求

http 复制代码
GET /sys/validateLogin?token=eyJhbGciOiJIUzI1NiJ9.xxxxx HTTP/1.1

Nginx access log 中可能出现:

text 复制代码
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 改造后的请求

http 复制代码
POST /sys/validateLogin HTTP/1.1
token: eyJhbGciOiJIUzI1NiJ9.xxxxx
Content-Type: application/json

Nginx 默认 access log 只看到:

text 复制代码
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"

http 复制代码
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 常见写法

http 复制代码
GET /api/agent/profit/sendSms?phone=13812345678 HTTP/1.1

或:

http 复制代码
GET /api/huichuxing/driver/sendSms?phone=13812345678 HTTP/1.1

日志中会直接出现:

text 复制代码
GET /api/agent/profit/sendSms?phone=13812345678 HTTP/1.1

手机号是个人敏感信息,泄露风险和 token 不同,但同样严重:

  • 手机号可用于骚扰、诈骗、撞库;
  • 结合业务系统,可推断某手机号是否注册、是否某企业员工;
  • 短信发送有成本,URL 被爬虫、监控、链接预览访问会造成资损;
  • 日志、工单、截图中的手机号很难彻底回收。

4.2 推荐写法

http 复制代码
POST /api/agent/profit/sendSms HTTP/1.1
Content-Type: application/json

{
  "phone": "13812345678"
}

Nginx 默认日志只看到:

text 复制代码
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 不被缓存

认证、短信、登录类接口应返回:

http 复制代码
Cache-Control: no-store

避免浏览器、代理、CDN 缓存敏感响应。


7. 落地建议

7.1 接口改造

对于敏感参数接口:

  1. 方法改为 POST;
  2. 参数改为 @RequestBody DTO 或请求头;
  3. 删除 @RequestParam 读取敏感字段的入口;
  4. 保留一段兼容期时,也要同时支持新旧方式并监控调用量,避免长期双入口。

示例:

java 复制代码
@PostMapping("/sendSms")
public Result<Void> sendSms(@RequestBody SendSmsRequest request) {
    String phone = request.getPhone();
    ...
}
java 复制代码
public class SendSmsRequest {
    private String phone;
}

7.2 Nginx / 网关日志

默认日志格式通常包含:

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 迁移策略

前端/调用方需要同步改造时:

  1. 后端先发布同时支持新旧方式,但新方式优先;
  2. 前端切换后观察旧方式调用量;
  3. 旧方式归零后下线;
  4. 对旧 GET 入口返回明确的迁移提示,而不是长期静默兼容。

8. 常见误区

误区一:POST 就一定安全

POST 只是把参数从 URL 移到 body。若 body 被网关日志、APM、业务日志记录,仍然会泄露。

误区二:放在 header 就一定安全

Header 也可能被某些代理、网关、调试工具记录。敏感 header 同样要脱敏。

误区三:内网接口不需要管

内网日志、测试环境、开发机、工单系统同样可能外泄;内部威胁和误操作是真实风险。

误区四:GET 改 POST 只是改注解

如果方法改了但参数还在 query,等于没改。必须同时检查参数位置、日志、缓存和调用方。


9. 检查清单

接口上线前可以逐项确认:

  • 敏感参数是否还出现在 URL query 中?
  • 是否为有副作用的操作使用了 POST?
  • Nginx/网关日志是否会记录完整 query?
  • 业务日志是否打印 token、手机号、验证码?
  • 响应是否设置了 Cache-Control: no-store?
  • 旧 GET 入口是否已下线或有明确迁移计划?
  • 前端/调用方是否已同步改造?
  • 是否仍然强制 HTTPS?

10. 结论

GET 改 POST 不是形式主义,而是把敏感参数从"默认会被记录的地方"移到"可以控制的地方"。

  • token 放 URL:等于把登录凭证交给日志系统;
  • 手机号放 URL:等于把个人敏感信息交给日志系统,还可能被爬虫和预取器利用;
  • 敏感参数进 body/header + 日志脱敏 + HTTPS:才是完整的防线。

先做到"敏感参数不进 URL",再谈日志治理、缓存控制和最小化采集,顺序不能反。

相关推荐
如夏倾城5 小时前
VRRP(虚拟路由器冗余协议Virtual Router Redundancy Protocol)
网络·python·网络协议·安全·智能路由器·负载均衡·信息与通信
衡石科技5 小时前
企业级 BI 的安全治理:衡石如何贯通认证、数据权限与审计
大数据·人工智能·安全·商业智能
web安全成长日记12 小时前
DNS解析全过程:从递归查询、根域与权威 DNS 到缓存 TTL|网络安全其实很简单
安全·web安全·缓存
FungLeo13 小时前
FengCMS · PHP+MySQL 升级实录 · 一个不懂PHP 的后端,三天 216次提交完成十三年老站安全升级(项目复盘)
mysql·安全·php·安全加固·fengcms
Keith Guo2 天前
openssl and key pair
安全·spsdk
jianqiang.xue2 天前
一天合入三笔CVE:RT-Thread的安全账本是怎么记的
安全
afumu2 天前
Go 写一个只监听 127.0.0.1 的控制服务:鉴权、白名单、危险命令拦截
后端·安全·go
艺杯羹2 天前
1Panel 装好后 ufw 仍是 inactive:一次服务器安全盲区复盘
服务器·数据库·安全·网络安全·系统架构·实战·1panel
QXWZ_IA2 天前
具身智能在油气行业规模化应用面临哪些技术挑战?
人工智能·安全