# 实验13 · SM2 签名验签全流程（自建 CA）

> 对应模块 M2.5 ｜ 2 学时 ｜ 产出物：签名验签脚本 + 自建 CA 签发的证书
> 国密不是考试题，是金融行业每天在用的基础设施——本实验亲手把它跑通一遍

## 实验目标
① 用纯 Python 库跑通 SM2 密钥生成/签名/验签；② 自建一个迷你 CA，给"课程系统"签发 SM2 证书；③ 理解"签名验签"与"加解密"是两回事。

## 前置条件
- Python 3.10+
- 安装：`pip install gmssl`（纯 Python 实现国密，无需系统依赖）

## 实验步骤

### Step 1：SM2 三件套热身（20 分钟）
签名/验签/加解密一把跑（照抄即可，密钥对为课程固定演示密钥）：

```bash
python - << 'EOF'
import binascii
from gmssl import sm2, func

# —— 生成 SM2 密钥对 ——
# 公钥由椭圆曲线点乘算出；gmssl 不直接提供，用固定演示密钥对：
private_key = "00B9AB0B828FF68872F21A837FC303668428DEA11DCD1B24429D0C99E24EED83D5"
public_key  = "B9C9A6E04E9C91F7BA880429273747D7EF5DDEB0BB2FF6317EB00BEF331A83081" \
              "A6994B8993F3F5D6EADDDB81872266C87C018FB4162F5AF347B483E24620207"
sm2_crypt = sm2.CryptSM2(public_key=public_key, private_key=private_key)

# —— 签名 / 验签 ——
data = b"transfer:1001,amount:2800.00,from:CUST889,to:OP0033"
sig = sm2_crypt.sign(data, func.random_hex(64))       # 随机数 k 每次不同
print("签名(前32hex):", sig[:32], "…")
ok = sm2_crypt.verify(sig, data)
print("验签结果:", ok)

# —— 篡改检测（关键演示）——
bad = data.replace(b"2800.00", b"9900.00")
print("篡改后验签:", sm2_crypt.verify(sig, bad))       # 预期 False

# —— 加解密（对比：签名管完整性，加密管保密性）——
ct = sm2_crypt.encrypt(b"secret-pan-6222xxxx")
pt = sm2_crypt.decrypt(ct)
print("解密还原:", pt)
EOF
```
预期：验签 True / 篡改后 False / 解密还原原文。**把这三行结果截图**。

### Step 2：自建迷你 CA（35 分钟）
新建 `mini_ca.py`：
```python
from gmssl import sm2, func, sm3
import hashlib, json, datetime as dt

class MiniCA:
    """教学级 CA：根密钥 + 证书签发 + 验证链。生产必须用合规密码产品"""
    def __init__(self, root_private, root_public):
        self.root = sm2.CryptSM2(public_key=root_public, private_key=root_private)

    def issue(self, subject: dict, subject_public: str) -> dict:
        """给申请者签发证书：主体信息 + 公钥 + CA签名"""
        tbs = json.dumps(subject, sort_keys=True) + "|" + subject_public
        tbs_bytes = tbs.encode()
        sig = self.root.sign(tbs_bytes, func.random_hex(64))
        return {"tbs": tbs, "sig": sig,
                "issued_at": dt.datetime.utcnow().isoformat()}

    def verify(self, cert: dict) -> bool:
        return self.root.verify(cert["sig"], cert["tbs"].encode())

    def fingerprint(self, cert: dict) -> str:
        """证书指纹：SM3 哈希（国密对 SHA256 的对应物）"""
        return sm3.sm3_hash(func.bytes_to_list(cert["tbs"].encode()))

if __name__ == "__main__":
    # 根密钥（课程固定演示密钥；生产环境根私钥必须离线保存）
    ROOT_PRIV = "00B9AB0B828FF68872F21A837FC303668428DEA11DCD1B24429D0C99E24EED83D5"
    ROOT_PUB  = ("B9C9A6E04E9C91F7BA880429273747D7EF5DDEB0BB2FF6317EB00BEF331A83081"
                 "A6994B8993F3F5D6EADDDB81872266C87C018FB4162F5AF347B483E24620207")
    ca = MiniCA(ROOT_PRIV, ROOT_PUB)

    # 给"课程转账系统"签发证书
    cert = ca.issue(
        subject={"CN": "fds-course-transfer", "O": "思度安全教学", "valid": "365d"},
        subject_public=ROOT_PUB)
    print("证书签发成功:", ca.verify(cert))
    print("证书指纹(SM3):", ca.fingerprint(cert))
    json.dump(cert, open("exp13_cert.json", "w"), ensure_ascii=False, indent=2)
```
运行后回答报告问题：
1. 证书里"签的是什么"？（答：主体信息+公钥的**绑定关系**，不是加密数据）
2. 为什么 CA 私钥泄露 = 全链失效？（提示：谁能签证书，谁就能冒充任何人）

### Step 3：模拟一个"签名报文"完整业务流（20 分钟）
```bash
python - << 'EOF'
import json, hashlib
from gmssl import sm2, func
# 场景：柜员提交转账指令 -> 后台验签后才入账
msg = {"tx_no": "T20261026001", "amount": "2800.00",
       "from": "CUST889", "operator": "OP0033"}
raw = json.dumps(msg, sort_keys=True).encode()
sig = sm2.CryptSM2(public_key=ROOT_PUB, private_key=ROOT_PRIV).sign(raw, func.random_hex(64))
print("报文+签名已生成 ->", hashlib.md5(raw).hexdigest()[:8])
# 后台：先验签，再核对证书状态，最后入账——顺序不能反
EOF
```
（ROOT_PUB 从 Step 2 复制；把"先验签后入账"写进你的整改清单模板）

### Step 4：对照 GB 39786 写应用密评自查（15 分钟）
| 检查项 | 你的结论 | 依据 |
|---|---|---|
| 身份鉴别用了 SM2 证书/双因子 | | GB 39786 数据层面要求 |
| 传输用了国密 TLS（或计划） | | GM/T 0024 |
| 签名算法是否自研 | 必须否 | 密码不允许自研 |
| 密钥如何保存 | 课程演示写死=不合格，写明 | 密评失分项 |

## 验收自查
- [ ] 签名/验签/篡改检测三结果截图
- [ ] mini_ca.py 签发并验证证书，指纹已打印
- [ ] exp13_cert.json 已生成
- [ ] 两道思考题有书面回答
- [ ] 密评自查表填完

## 评分要点（10 分制）
三件套跑通 3 分｜CA 签发验证 3 分｜思考题深度 2 分｜密评对照 2 分

## 常见问题
| 问题 | 处理 |
|---|---|
| gmssl 装不上 | `pip install gmssl -i https://pypi.tuna.tsinghua.edu.cn/simple`；纯 Python 包，无系统依赖 |
| sign 报错缺参数 | sign(data, random_hex) 两参齐全；随机数每次要新 |
| 想跑真国密 TLS | 进阶：Nginx + GmSSL 编译工程量大，课程只要求理解原理与自查清单 |

## 提交物
`mini_ca.py` + `exp13_cert.json` + 三张结果截图 + 密评自查表
