接口安全兩大支柱：性能安全與數據安全體系化建設
微服務架構下，接口暴露面劇增，安全不再是單點防護，而是系統工程。本文結合 7 年服務端經驗，從性能安全（防刷、限流、冪等）與數據安全（鑒權、加密、審計）兩個維度，構建可落地的接口安全體系。
一、性能安全：守住系統可用性底線
1.1 冪等性設計原則
冪等性：同一請求多次執行，業務結果一致。分類處理：
| 接口類型 | 是否需冪等 | 實現方案 |
|---|
| 查詢（GET） | 天然冪等 | 無需額外處理 |
| 刪除（DELETE） | 天然冪等 | 無需額外處理 |
| 全量更新 | 冪等 | UPDATE SET col=val |
| 增量更新 | 非冪等 | 需業務冪等鍵 |
| 新增（POST） | 非冪等 | 業務主鍵唯一索引 + 去重表 |
| 組合操作 | 非冪等 | 分布式事務/狀態機保證 |
1.2 客戶端與網關層防護
- 客戶端：非冪等接口禁用自動重試（Dubbo `retries=0`、Feign `retryer=NeverRetry`），用戶端提示「請勿重複提交」。
- 網關：
- 限流：令牌桶/漏桶（Sentinel/Resilience4j），維度：用戶/接口/IP/租戶。
- 熔斷：錯誤率/耗時閾值觸發降級，防止雪崩。
- 黑白名單：動態封禁惡意 IP/用戶。
- 請求體大小限制：防大包攻擊。
1.3 業務層冪等實現模式
- 唯一索引法：業務表加 `uk_biz_key`，捕獲 `DuplicateKeyException` 返回成功。
- 去重表/Redis SETNX：請求攜帶 `idempotencyKey`（UUID/業務單號），Redis `SETNX key 1 EX 86400` 成功才執行業務。
- 狀態機法：訂單狀態 `NEW→PAID→SHIPPED`，更新時 `WHERE status=NEW`，CAS 模式。
- Token 預發放：敏感操作前端申請一次性 Token，後端驗證消費。
二、數據安全：守住信息不洩露、不篡改、可審計
2.1 鑒權與授權體系
- 網關統一鑒權：JWT/Opaque Token 校驗、簽名驗證、過期檢查、黑名單撤銷。
- 細粒度授權：RBAC（角色-權限）+ ABAC（屬性基礎），SpEL 表達式動態判斷 `@PreAuthorize("hasPermission(#order, 'UPDATE')")`。
- 服務間信任：mTLS 雙向認證、Service Mesh Sidecar 透明化、內網零信任。
2.2 傳輸與存儲加密
- 全鏈路 HTTPS：TLS 1.2+、強加密套件、HSTS、Certificate Pinning（移動端）。
- 敏感字段加密：手機/身份證/銀行卡 AES-GCM 加密存儲，密鑰輪換由 KMS 管理。
- 日誌脫敏：切面統一攔截，正則替換手機中間 4 位、身份證後 6 位、卡號前 6 後 4。
2.3 簽名防篡改與重放攻擊
// 簽名算法示例
String signContent = HttpMethod + "\n" + Path + "\n" + Timestamp + "\n" + Nonce + "\n" + BodyHash;
String signature = HMAC_SHA256(signContent, secretKey);
// Header: X-Signature, X-Timestamp, X-Nonce, X-AppId
- Timestamp 有效窗口 5 分鐘，防重放。
- Nonce 唯一性：Redis `SETNX nonce 1 EX 300`。
- Body Hash：`SHA256(RequestBody)` 確保內容完整性。
2.4 審計與合規
- 全鏈路 TraceId 串聯，關鍵操作（登錄、支付、權限變更）寫入不可變審計日志（Kafka→ES/ClickHouse）。
- 定期滲透測試、代碼掃描（SAST/DAST）、依賴漏洞掃描（OWASP Dependency-Check）。
- 符合等保 2.0、GDPR、個信保法合規要求。
三、落地清單
| 層級 | 必做項 | 建議項 |
|---|
| 網關 | 限流、鑒權、黑白名單、請求大小限制 | 熔斷降級、請求緩存、WAF 規則 |
| 業務 | 冪等鍵設計、參數校驗、敏感字段脫敏 | 業務風控引擎、行為分析、蜜罐接口 |
| 數據 | HTTPS、敏感字段加密、審計日志 | 字段級權限、數據水印、隱私計算 |
| 運維 | 漏洞掃描、滲透測試、應急預案 | 混沌工程、紅藍對抗、零信任落地 |
四、總結
接口安全無銀彈，唯體系。性能安全保可用，數據安全保機密/完整/可審計。從網關硬殼到業務軟甲，再到數據核心加密，層層設防，才能在高併發、微服務、開放生態下穩健演進。
