# 实验7 · 字段级加密 + 自研 KMS

> 对应模块 M3 / M2.5 ｜ 2 学时 ｜ 产出物：加密落库的客户表 + KMS 操作记录
> 核心考点：密文可以进库，密钥永远不进库——"密钥和密文同库同表"是密评第一条失分项

## 实验目标
用课程自研 KMS（http://192.168.32.130:8100）对 customers 表的手机号做信封式字段加密并落库，验证密钥轮换前后均可解密、错误密钥不可解。

## 前置条件
- KMS 服务健康：`curl http://192.168.32.130:8100/health` 返回 200
- 已装 `pip install pymysql requests`
- KMS 接口速查（也可开 http://192.168.32.130:8100/docs 在线调）：
  - `POST /keys`  body `{"key_id":"xxx"}` 创建
  - `GET /keys` 列表；`POST /keys/{id}/rotate` 轮换
  - `POST /encrypt` body `{"key_id":"xxx","plaintext_b64":"..."}`
  - `POST /decrypt` body `{"key_id":"xxx","ciphertext_b64":"..."}`

## 实验步骤

### Step 1：先手工体验一轮（10 分钟）
```bash
curl -s -X POST http://192.168.32.130:8100/keys -H "Content-Type: application/json" -d '{"key_id":"exp07-key"}'
python - << 'EOF'
import requests, base64
p = base64.b64encode("13812345678".encode()).decode()
e = requests.post("http://192.168.32.130:8100/encrypt",
                  json={"key_id":"exp07-key","plaintext_b64":p}).json()
print("密文:", e["ciphertext_b64"][:32], "…")
d = requests.post("http://192.168.32.130:8100/decrypt",
                  json={"key_id":"exp07-key","ciphertext_b64":e["ciphertext_b64"]}).json()
print("解密:", base64.b64decode(d["plaintext_b64"]).decode())
EOF
```

### Step 2：批量加密落库（核心步骤，30 分钟）
新建 `encrypt_col.py`：
```python
import pymysql, requests, base64

KMS = "http://192.168.32.130:8100"
KEY = "exp07-key"

def enc(v: str) -> str:
    r = requests.post(f"{KMS}/encrypt", json={
        "key_id": KEY, "plaintext_b64": base64.b64encode(v.encode()).decode()}).json()
    return r["ciphertext_b64"]

src = pymysql.connect(host='192.168.32.130', port=3306, user='root',
                      password='fds_root_2026', database='bank_biz')
dst = pymysql.connect(host='192.168.32.130', port=3307, user='root',
                      password='fds_root_2026', database='bank_shadow')
cur = dst.cursor()
cur.execute("""CREATE TABLE IF NOT EXISTS customers_enc (
  id INT PRIMARY KEY,
  phone_cipher TEXT    COMMENT 'KMS密文',
  key_version VARCHAR(8) COMMENT '加密时所用密钥版本')""")

rows = pymysql.connect(host='192.168.32.130', port=3306, user='root',
                       password='fds_root_2026', database='bank_biz') \
             .cursor().execute("SELECT COUNT(*) FROM customers")
import pandas as pd
df = pd.read_sql("SELECT id, phone FROM customers LIMIT 500", src)
for _, r in df.iterrows():
    cur.execute("REPLACE INTO customers_enc VALUES (%s,%s,%s)",
                (int(r["id"]), enc(str(r["phone"])), "v1"))
dst.commit()
print("已加密落库", len(df), "行")
```

### Step 3：密钥轮换验证（20 分钟）——本实验采分核心
```bash
# 1) 轮换密钥
curl -s -X POST http://192.168.32.130:8100/keys/exp07-key/rotate
# 2) 用 v1 旧密文仍然解密成功（新旧版本共存）
python - << 'EOF'
import pymysql, requests, base64
c = pymysql.connect(host='192.168.32.130', port=3307, user='root',
                    password='fds_root_2026', database='bank_shadow')
cur = c.cursor(); cur.execute("SELECT id, phone_cipher FROM customers_enc LIMIT 3")
for cid, cipher in cur.fetchall():
    d = requests.post("http://192.168.32.130:8100/decrypt",
                      json={"key_id":"exp07-key","ciphertext_b64":cipher}).json()
    print(cid, "->", base64.b64decode(d["plaintext_b64"]).decode())
EOF
```
预期：轮换后旧密文仍解得开。回答报告问题：**为什么 KMS 要保留旧版本密钥？**
（答：轮换只影响新加密，存量密文要靠版本化旧密钥解——删旧版本=数据丢失）

### Step 4：错误密钥不可解（10 分钟）
```bash
curl -s -X POST http://192.168.32.130:8100/keys -d '{"key_id":"wrong-key"}' -H "Content-Type: application/json"
python - << 'EOF'
import requests
r = requests.post("http://192.168.32.130:8100/decrypt",
                  json={"key_id":"wrong-key","ciphertext_b64":"AAAA"})
print(r.status_code, r.text[:120])   # 预期报错，不是明文
EOF
```

### Step 5：对照密评失分项写结论（10 分钟）
对照 M2.5 讲稿"密评失分项 Top5"逐条检查你的实现并写进报告：
1. 密钥和密文同库同表？→ 否（密文在 MySQL，密钥只在 KMS 卷）✅
2. 密钥无轮换？→ 有 rotate 且版本共存 ✅
3. 明文出现在日志？→ 检查 encrypt_col.py 有没有 print 明文 ⚠ 引以为戒
4. 弱算法/自研算法？→ KMS 用标准实现，不自研算法 ✅
5. 密钥无访问控制？→ 课程 KMS 简化无鉴权，报告里写"生产需加 mTLS+RBAC" ⚠

## 验收自查
- [ ] customers_enc ≥ 500 行密文
- [ ] 轮换后旧密文可解，截图
- [ ] wrong-key 解密报错，截图
- [ ] 密评对照表 5 条全填

## 评分要点（10 分制）
批量加密落库 3 分｜轮换+共存验证 3 分｜错误密钥验证 2 分｜密评对照结论 2 分

## 常见问题
| 问题 | 处理 |
|---|---|
| KMS 502/连接拒绝 | `docker compose ps` 看 fds-kms 是否 healthy；`docker compose restart kms` |
| 批量加密太慢 | 500 行逐次 HTTP 属正常（约1分钟）；别用多线程打爆教学 KMS |
| 落库中文乱码 | 连接串加 charset='utf8mb4' |

## 提交物
`encrypt_col.py` + 两张验证截图 + 密评对照表
