fischer-agentkit/docs/compliance/dengbao-level3/00-overview.md

等保三级认证文档 — 总览

1. 认证目标与范围

1.1 认证目标

本套文档用于 Fischer AgentKit（以下简称 "AgentKit"）通过 GB/T 22239-2019 《信息安全技术 网络安全等级保护基本要求》第三级（等保三级）测评准备。

目标：在政企 POC 采购关闭前完成认证 readiness，使 AgentKit 作为应用系统 具备部署到等保三级信息系统的合规条件。

1.2 认证范围

AgentKit 作为一个应用系统纳入等保三级测评，覆盖：

• 应用软件本身（FastAPI 后端 + Vue 前端 + Tauri 桌面客户端）
• 部署形态：Kubernetes（客户内网）+ Redis + PostgreSQL（含 pgvector）
• 数据处理：用户输入、LLM 调用、记忆存储、终端命令执行

不在范围内（由客户/平台侧负责）：

• 物理机房环境（客户机房）
• K8s 宿主机操作系统内核加固
• 网络骨干设施（防火墙、入侵检测系统、堡垒机）
• PKI 证书签发机构（CA）
• HSM/KMS 硬件设备

AgentKit 文档中明确标注「依赖客户侧」与「AgentKit 实现」的边界，避免越界承诺。

1.3 文档结构

本套文档按 GB/T 22239-2019 三级要求 6 个维度组织：

文件	维度	主要内容
00-overview.md	—	总览（本文档）
01-physical.md	物理安全	部署假设（客户机房）、物理访问、环境监控、电力
02-network.md	网络安全	网络架构、边界防护（Ingress TLS）、访问控制（NetworkPolicy）、入侵防范、安全审计（OTel）
03-host.md	主机安全	容器镜像安全、K8s node 基线、身份鉴别（SA token）、访问控制（RBAC）、安全审计、入侵防范
04-application.md	应用安全	身份鉴别（SSO 多 IDP）、访问控制（RBAC 3 级 + 权限位）、安全审计（OTel + audit.py）、通信完整性（TLS + JWT）、软件容错、资源控制
05-data.md	数据安全	数据完整性（PG + pgvector）、数据保密性（PII 脱敏 + 国密 P1）、备份恢复、剩余信息保护（session revoke）
06-management.md	管理安全	密钥轮换 runbook、break-glass 告警、变更管理、应急响应、安全评估
control-points.yaml	—	控制点清单 + AgentKit 实现映射（已实现 / P0 / P1 / 待评估）

2. AgentKit 架构摘要

2.1 技术栈

• 后端：Python 3.11+、FastAPI、Uvicorn、Pydantic v2、SQLAlchemy 2（async）
• 前端：Vue 3、TypeScript、Vite 5、Ant Design Vue 4、Pinia
• 桌面端：Tauri 2.x（Rust 外壳 + Python sidecar）
• 基础设施：Redis（总线/缓存/状态）、PostgreSQL + pgvector（情景记忆）
• 可观测性：OpenTelemetry（OTLP gRPC 导出，U1 已强制依赖）
• 部署：Helm Chart（K8s 内网部署，U5）

2.2 部署形态

客户内网 K8s 集群
  ├── Ingress (nginx, TLS 终止)  ← 唯一对外入口
  │     └── TLS 证书（cert-manager 或手动）
  ├── AgentKit Pod (非 root, UID 1001)
  │     ├── FastAPI serve (:8001)  — API
  │     └── FastAPI gui (:8002)    — Web GUI
  ├── Redis (内部, requirepass)
  ├── PostgreSQL + pgvector (内部, 密码)
  └── OTel Collector (内部, bearer token)
        ↑ OTLP gRPC (mTLS: 待评估)

密钥通过 Sealed Secrets 或 External Secrets Operator 注入（禁止明文 Kubernetes Secret + Git 提交，KTD-4 / R2a）。共 10 个 secret slot， 每个含轮换周期（90~365 天）。

2.3 关键安全子系统映射

子系统	模块	等保维度
OTel 可观测性	src/agentkit/telemetry/	网络/主机/应用审计
PII 脱敏	src/agentkit/llm/pii_filter.py	数据保密性
SSO 多 IDP	src/agentkit/server/auth/providers/、idp_registry.py	应用身份鉴别
SCIM 2.0	src/agentkit/server/auth/scim/router.py	应用账户生命周期
RBAC 审计	src/agentkit/server/auth/audit.py	应用安全审计
终端安全 6 层	src/agentkit/server/auth/terminal_security.py	应用访问控制
RBAC 权限	src/agentkit/server/auth/permissions.py	应用访问控制
JWT 会话	src/agentkit/server/auth/jwt_utils.py、denylist.py	应用身份鉴别 + 剩余信息保护
密码哈希	src/agentkit/server/auth/password.py	应用身份鉴别
Helm 部署	deploy/helm/agentkit/	网络/主机/管理
密钥轮换	docs/deployment/key-rotation-runbook.md	管理安全

3. 各维度实现状态概览

下表汇总各维度控制点的实现状态。状态定义：

• 已实现：代码/配置已落地，有对应文件可查
• P0：认证 readiness 必需，本次 POC 采购关闭前需补齐
• P1：下一阶段补齐，文档中标注为参考
• 待评估：依赖客户侧或需进一步评估方案

维度	控制点数	已实现	P0	P1	待评估
物理安全	6	0	0	0	6
网络安全	8	4	2	1	1
主机安全	7	4	2	0	1
应用安全	8	8	0	0	0
数据安全	8	6	1	1	0
管理安全	7	4	1	1	1
合计	44	26	6	3	9

应用安全是 AgentKit 自身责任范围，已全部实现。物理安全完全依赖客户机房， 故全部为「待评估」。网络/主机/数据/管理维度的 P0 项（共 6 个）是认证 readiness 的关键补齐项，详见 control-points.yaml。

P0 关键补齐项清单：

• NET-03 NetworkPolicy 模板
• NET-07 审计日志保留 180 天（KTD-9）
• HST-03 容器日志标准化采集
• HST-07 镜像漏洞扫描（Trivy/CI 集成）
• DAT-03 PostgreSQL 备份恢复 runbook
• MGT-02 CI/CD 规范文档化

4. 与既有交付的引用关系

本套文档不重复实现细节，只映射到既有交付物：

既有交付	等保映射	引用文档
U1 OTel（telemetry/）	应用/网络审计	02-network.md §5、04-application.md §4
U2 PII 脱敏（pii_filter.py）	数据保密性	05-data.md §2
U3 DR-fixes（bitable）	应用容错	04-application.md §5
U4 SSO/SCIM/Audit	应用身份鉴别/审计	04-application.md §1/§4、06-management.md §2
U5 K8s Helm Chart	网络/主机/管理	02-network.md、03-host.md、06-management.md
R7a 终端安全 6 层	应用访问控制	04-application.md §2

5. 文档使用说明

1. 测评机构按 control-points.yaml 逐条核对，每条含 id / dimension / title / requirement / implementation / status / references。
2. references 字段给出 AgentKit 代码文件绝对路径，使用 file:/// 链接格式。
3. 状态为 P0 的控制点需在认证前补齐，对应文件中标有「P0 补齐项」段落。
4. 状态为 P1 的控制点在文档中标注为「P1 参考」，不阻碍三级认证但需写入整改计划。
5. 状态为「待评估」的控制点依赖客户侧环境，需在客户机房测评时单独核对。