# 实验8 · 共享安全通道与审批留痕

> 对应模块 M3 ｜ 2 学时 ｜ 产出物：一键共享脚本 + 审计留痕截图
> 场景：业务部门说"把客户名单发给合作方"——你作为数据安全岗，怎么让这个动作**合规、留痕、可审计**

## 实验目标
实现一个"共享导出"闭环：**审批登记 → 水印植入 → 最小化字段导出 → 通道传输 → 全程写审计索引**，并演示"没有审批单就导不出"的拦截。

## 前置条件
- 实验7 完成（复用 KMS）
- OpenSearch 可用：`curl http://192.168.32.130:9200` 返回集群信息
- 审批留痕写入索引 `fds-audit`（与控制台访问记录同索引）

## 实验步骤

### Step 1：设计审批单数据结构（15 分钟）
新建 `share.py`，先抄骨架：
```python
import requests, json, datetime as dt, hashlib, csv

OS = "http://192.168.32.130:9200"

def audit(action: str, detail: dict):
    """每个关键动作都写一条审计——这是'留痕'的落点"""
    requests.post(f"{OS}/fds-audit/_doc", json={
        "@timestamp": dt.datetime.utcnow().isoformat(),
        "user": "stu-你的名字", "action": action, **detail}, timeout=5)

def make_approval(applicant, purpose, fields, rows, expire_hours=24):
    """审批单：谁/为什么/哪些字段/多少行/有效期——五要素缺一不可"""
    ap = {"applicant": applicant, "purpose": purpose,
          "fields": fields, "rows": rows, "expire_hours": expire_hours,
          "status": "PENDING"}
    aid = hashlib.sha256(json.dumps(ap, sort_keys=True).encode()).hexdigest()[:12]
    ap["approval_id"] = aid
    audit("share_approval_created", ap)
    return ap

def approve(ap: dict, approver: str):
    ap["status"] = "APPROVED"; ap["approver"] = approver
    audit("share_approval_approved", {"approval_id": ap["approval_id"],
                                      "approver": approver})
```
思考题写进报告：为什么 approval_id 用内容哈希而不是自增？（提示：审批单不可篡改）

### Step 2：导出函数——带四道闸（30 分钟）
```python
def export_for_share(ap: dict, df, watermark_secret: str):
    """四道闸：状态→字段→行数→水印"""
    # 闸1：未审批不放行
    if ap.get("status") != "APPROVED":
        audit("share_denied", {"approval_id": ap["approval_id"], "reason": "未审批"})
        raise PermissionError("共享导出被拒：无有效审批单")
    # 闸2：字段最小化——超出审批字段一律砍掉
    extra = set(df.columns) - set(ap["fields"])
    if extra:
        audit("share_field_trimmed", {"approval_id": ap["approval_id"],
                                      "trimmed": sorted(extra)})
        df = df[list(ap["fields"])]
    # 闸3：行数上限
    df = df.head(ap["rows"])
    # 闸4：每行带溯源标识（生产为水印，此处为标记列，实验14 升级为真水印）
    df = df.copy(); df["_share_id"] = ap["approval_id"]
    audit("share_exported", {"approval_id": ap["approval_id"],
                             "rows": len(df), "fields": list(df.columns)})
    return df
```

### Step 3：跑通两条路径（20 分钟）
```python
if __name__ == "__main__":
    import pymysql, pandas as pd
    c = pymysql.connect(host='192.168.32.130', port=3306, user='root',
                        password='fds_root_2026', database='bank_biz')
    df = pd.read_sql("SELECT id, name, phone, id_number FROM customers LIMIT 200", c)

    # 路径1：未审批 → 应被拦截
    ap1 = make_approval("stu-你的名字", "合作方营销测试",
                        ["name", "phone"], 200)
    try:
        export_for_share(ap1, df, "OP0033")
    except PermissionError as e:
        print("拦截成功:", e)

    # 路径2：审批后 → 导出，且超范围字段被砍
    approve(ap1, "dept-manager")
    out = export_for_share(ap1, df, "OP0033")
    out.to_csv("exp08_共享导出.csv", index=False, encoding="utf-8-sig")
    print(out.columns.tolist())   # 预期：没有 id_number（未在审批单内）
    print(len(out))               # 预期 200
```

### Step 4：到审计看板验证留痕（15 分钟）
1. 打开 http://192.168.32.130:5601 → Discover → 索引模式 `fds-audit*`
2. 查询 `user: "stu-你的名字"`，时间范围最近 15 分钟
3. 预期按序看到 4 条：`share_approval_created` → `share_denied` → `share_approval_approved` → `share_field_trimmed` + `share_exported`
4. 截图——**这张图就是"全程留痕"的证据**，也是你面试时最好讲的素材

### Step 5：口述题（直播课抽查）
用 1 分钟讲清楚你的四道闸分别防什么：
状态闸防未批先用 / 字段闸防超范围要数 / 行数闸防一次捞走 / 水印闸防事后无法定责。

## 验收自查
- [ ] 拦截路径与放行路径都跑通
- [ ] 导出文件没有审批单之外的列
- [ ] 看板能看到完整事件链，截图
- [ ] 思考题（哈希审批单）有书面回答

## 评分要点（10 分制）
四道闸实现 4 分｜双路径验证 2 分｜审计链完整可查 3 分｜思考题 1 分

## 常见问题
| 问题 | 处理 |
|---|---|
| 写 audit 报 timeout | OpenSearch 忙；重跑即可，timeout=5 已放宽 |
| 看板查不到记录 | 时间范围改成"最后1小时"；确认索引模式是 `fds-audit*` |
| 想清空审计重跑 | `curl -X DELETE http://192.168.32.130:9200/fds-audit`（教学环境允许） |

## 提交物
`share.py` + `exp08_共享导出.csv` + 看板留痕截图 + 思考题答案
