ghcr.io/intuitem/ciso-assistant-community/frontend:v3.18.0-amd64

为项目点亮星标🌟，以获取发布通知并助力社区发展！

intuitem.com · SaaS免费试用 · 路线图 · 文档 · 语言 ·

---

· 框架

CISO Assistant 为网络安全管理和GRC（治理、风险与合规）实践提供了全新视角：

• 设计为中央枢纽，通过对象间的智能链接连接多个网络安全概念，
• 作为多范式工具构建，可适应不同背景、方法论和期望，
• 明确将合规与网络安全控制解耦，实现跨平台复用，
• 倡导复用和互联，而非重复工作，
• 采用API优先方法开发，支持UI交互和外部自动化，
• 内置丰富的标准、安全控制和威胁库，
• 提供开放格式，可自定义和复用您自己的对象和框架，
• 包含内置的风险评估和整改跟踪工作流，
• 通过简单语法和灵活工具支持自定义框架，
• 提供跨多种渠道和格式（UI、CLI、Kafka、报告等）的丰富导入/导出功能。

我们的愿景是打造网络安全管理的一站式平台——通过简化和互操作性实现GRC现代化。

作为与网络安全和IT专业人员合作的从业者，我们曾面临同样的问题：工具碎片化、数据重复，以及缺乏直观的集成解决方案。CISO Assistant 源于这些经验教训，我们正围绕务实、常识性原则构建社区。

我们不断根据用户和客户的反馈进行改进。CISO Assistant 就像一只章鱼🐙，不断长出新的“触手”——为网络安全团队带来清晰度、自动化和生产力，同时减少数据输入和输出的工作量。

---

快速开始 🚀

[!TIP] 最简单的入门方式是通过此处提供的云实例免费试用。

或者，在您的工作站或服务器上安装好_Docker_和_Docker-compose_后：

克隆仓库：

git clone --single-branch -b main https://github.com/intuitem/ciso-assistant-community.git

并运行启动脚本

./docker-compose.sh # Linux/MacOS
./docker-compose.ps1 # Windows

如果您正在寻找其他自托管安装选项，请查看配置生成器和文档。

[!NOTE] docker-compose脚本使用预构建的Docker镜像，支持大多数标准硬件架构。 如果您使用Windows，请确保已安装带WSL2的Docker Desktop并触发PowerShell脚本。它将代表您配置Docker Desktop。

可以调整docker compose文件以传递额外参数，以适应您的设置（例如邮件发送器设置）。

[!WARNING] 如果您收到关于镜像平台与主机平台不匹配的警告或错误，请提交包含详细信息的issue，我们将很快添加支持。您也可以改用docker-compose-build.sh（见下文）为您的特定架构构建镜像。

[!IMPORTANT] 不要直接将main分支代码用于生产环境，因为它是上游合并分支，在我们的开发过程中可能包含破坏性变更。请使用tags获取稳定版本或预构建镜像。

---

功能

即将推出的功能列在路线图上。

CISO Assistant 由Intuitem开发和维护，这是一家专注于网络安全、云以及数据/AI的公司。

---

核心概念

以下是CISO Assistant中一些构建块的摘要，用于说明鼓励复用的解耦概念：

有关完整详细信息，请查看数据模型文档。

---

解耦概念

CISO Assistant 的核心是解耦原则，它支持强大的用例并显著节省时间：

• 跨范围或框架复用过去的评估，
• 同时针对多个框架评估单个范围，
• 让CISO Assistant处理报告和一致性检查，以便您可以专注于整改，
• 将控制措施的实施与合规跟踪分离。

以下是解耦原则及其优势的说明：

系统架构

最终用户文档

查看 上的在线文档。

设置本地AI引擎

在此处了解更多：AI引擎

支持的框架 🐙

1. ISO 27001:2013 和 27001:2022 🌐
2. NIST 网络安全框架（CSF）v1.1 🇺🇸
3. NIST 网络安全框架（CSF）v2.0 🇺🇸
4. NIS2 🇪🇺
5. SOC2 🇺🇸
6. PCI DSS 4.0.1 💳
7. CMMC v2 🇺🇸
8. PSPF 🇦🇺
9. 通用数据保护条例（GDPR）：GDPR.EU 提供的全文和清单 🇪🇺
10. Essential Eight 🇦🇺
11. NYDFS 500（含 2023-11 修订版）🇺🇸
12. DORA（法案、RTS、ITS 和 GL）🇪🇺
13. NIST 人工智能风险管理框架 🇺🇸🤖
14. NIST SP 800-53 rev5 🇺🇸
15. OIV 规则 - “国家民事活动”领域（2019）🇫🇷
16. CCB 网络基础框架 🇧🇪
17. NIST SP-800-66（HIPAA）🏥
18. HDS/HDH 🇫🇷
19. OWASP 应用安全验证标准（ASVS）4 🐝🖥️
20. RGS v2.0 🇫🇷
21. AirCyber ✈️🌐
22. 网络弹性法案（CRA）🇪🇺
23. TIBER-EU 🇪🇺
24. NIST 隐私框架 🇺🇸
25. TISAX（VDA ISA）v5.1 和 v6.0 🚘
26. ANSSI 安全 hygiene 指南 🇫🇷
27. 基本网络安全控制措施（ECC）🇸🇦
28. CIS 控制措施 v8* 🌐
29. CSA CCM（云控制矩阵）* ☁️
30. 联邦数据保护法（FADP）🇨🇭
31. NIST SP 800-171 rev2（2021）🇺🇸
32. ANSSI：生成式人工智能系统安全建议 🇫🇷🤖
33. NIST SP 800-218：安全软件开发框架（SSDF）🖥️
34. GSA FedRAMP rev5 ☁️🇺🇸
35. 法国网络合规框架（3CF）v1（2021）✈️🇫🇷
36. ANSSI：SecNumCloud ☁️🇫🇷
37. 法国网络合规框架（3CF）v2（2024）✈️🇫🇷
38. ANSSI：网络危机管理自我评估工具 💥🇫🇷
39. BSI：IT-Grundschutz-Kompendium 🇩🇪
40. NIST SP 800-171 rev3（2024）🇺🇸
41. ENISA：5G 安全控制矩阵 🇪🇺
42. OWASP 移动应用安全验证标准（MASVS）🐝📱
43. 敏捷安全框架（ASF）- 基准版 - 由 intuitem 提供 🤗
44. ISO 27001:2013 🌐（用于遗留系统和迁移）
45. 欧盟人工智能法案 🇪🇺🤖
46. FBI CJIS 🇺🇸👮
47. 运营技术网络安全控制措施（OTCC）🇸🇦
48. 安全控制框架（SCF）🇺🇸🌐
49. NCSC - 网络评估框架（CAF）v3.2 🇬🇧
50. 加州消费者隐私法（CCPA）🇺🇸
51. 加州消费者隐私*** 🇺🇸
52. NCSC Cyber Essentials 🇬🇧
53. 摩洛哥国家信息系统安全指令（DNSSI）🇲🇦
54. Part-IS ✈️🇪🇺
55. ENS 国家安全框架 🇪🇸
56. 韩国 ISA ISMS-P 🇰🇷
57. 瑞士 ICT 最低标准 🇨🇭
58. Adobe 通用控制框架（CCF）v5 🌐
59. BSI 云计算合规标准目录（C5）🇩🇪
60. 突尼斯 ANCS 信息系统安全审计框架 🇹🇳
61. ECB ***市场基础设施网络弹性监督期望 🇪🇺
62. Mindeststandard-des-BSI-zur-Nutzung-externer-Cloud-Dienste（2.1 版）🇩🇪
63. 成熟度评估表 - 基础级（DGA）🇫🇷
64. NIS2 技术和方法要求 2024/2690 🇪🇺
65. 沙特阿拉伯货币管理局（SAMA）网络安全框架 🇸🇦
66. 数据安全指南（CNIL）🇫🇷
67. 国际***贸易条例（ITAR）🇺🇸
68. 联邦贸易委员会（FTC）客户信息保护标准 🇺🇸
69. OWASP 大语言模型治理与安全清单 🌐
70. ANSSI：敏感或限制传播信息系统架构建议 🇫🇷
71. CIS Kubernetes v1.10 基准 🌐
72. De tekniske minimumskrav for statslige myndigheder 🇩🇰
73. Google SAIF 框架 🤖
74. ANSSI：信息系统安全管理建议 🇫🇷
75. 审慎标准 CPS 230 - 运营风险管理（APRA）🇦🇺
76. 审慎标准 CPS 234 - 信息安全（APRA）🇦🇺
77. 车辆网络安全审计（VCSA）v1.1 🚘
78. Cisco 云控制框架（CCF）v3.0 ☁️🌐
79. FINMA - 2023/01 号通知 - 运营风险与弹性 - 银行 🇨🇭
80. 后量子密码学（PQC）迁移路线图（2025 年 5 月）🔐
81. 云主权框架 - 1.2.1 - 2025 年 10 月 🇪🇺
82. ISO 22301:2019 概要 - 业务连续性管理体系 🌐
83. CCB 网络基础框架 2025 🇧🇪
84. 安全事件检测服务提供商（PDIS）- 要求框架 🇫🇷
85. 供应商尽职调查 - 简易基准 - intuitem 🌐
86. Active Directory（AD）控制点 - ANSSI 🇫🇷
87. ISO 42001:2023 概要 - 人工智能管理体系（含附录 A）🤖🌐
88. 印度数字个人数据保护法（DPDPA）- 2023 🇮🇳
89. E-ITS（爱沙尼亚国家网络安全标准）- 2024 🇪🇪
90. Microsoft 云安全基准 v1 - ☁️🌐
91. ***信息安全基准 2（BIO2）🇳🇱
92. ANSSI：MonAideCyber 问卷 🇫🇷
93. ITSP.10.171 - 在非加拿大***系统和组织中保护特定信息 🇨🇦
94. CISA 供应商供应链风险管理（SCRM）模板 🇺🇸
95. 欧洲可持续发展报告标准（ESRS）🇪🇺
96. ITIL 4 管理实践 🌐
97. NOREA - DORA 控制框架 v3.0 🇪🇺
98. NIS-1 法国转化版 🇫🇷
99. PSSI État 🇫🇷
100. 认证文件清单 🇫🇷
101. EBIOS RM v3.1 标签规范 🇫🇷
102. SecNumCloud v3.2 附录 2：委托方建议 ☁️🇫🇷
103. CCB 网络基础小型版 - 自我评估 🇧🇪
104. Mitre ATT&CK v18.1 - 威胁目录 🌐
105. Mitre D3FEND - 参考控制措施 🌐
106. OWASP Top 10 Web - 威胁目录 🐝🌐
107. OWASP MAS 威胁建模指南 - 威胁目录 🐝📱
108. CISA 网络安全绩效目标（CPG）v2.0 🇺🇸
109. ANSSI：法国 NIS2 ***网络框架（ReCyF）🇫🇷
110. 法国网络合规框架（3CF）v3.1（2026）✈️🇫🇷
111. OIV 规则 - “航空运输”领域（2016）✈️🇫🇷
112. IEC 62443 系列 — 第 2-1、2-4、3-2、3-3、4-1、4-2 部分 🏭🌐
113. CER 指令（关键实体韧性）🇪🇺
114. EUDI ARF — 欧盟数字身份***高级要求（附录 2.02）🇪🇺
115. UK Defence Standard 05-138 Issue 4 🇬🇧
116. HAS 框架 - 机构质量认证 🇫🇷🏥
117. 个人数据保护法（PDPL）🇸🇦
118. NCSC - 网络评估框架（CAF）v4.0 🇬🇧
119. Algemene Beveiligingseisen voor Rijksoverheidsopdrachten（ABRO）2026 🇳🇱

社区贡献

添加自定义库

库可以表示一个框架、威胁目录、一组参考控制措施，甚至是自定义风险矩阵。

现在可以直接从 Excel 文件加载库。无需事先手动将其转换为 YAML——上传 Excel 文件时，内部会处理转换过程。

查看 tools 目录及其专用 README，其中描述了 Excel 格式库源文件的预期格式。excel 子目录包含用作现有库源的示例 XLSX 文件，可作为创建自定义库的模板。

要从 Excel 文件加载库，请转到 Governance → Library 页面，点击 Load，然后选择您的 Excel 源文件。导入过程中会报告任何验证或解析错误。

可选：将库转换为 YAML

虽然可以直接加载 Excel 文件，但仍可使用外部 Python 脚本将库源文件转换为 YAML：

• convert_library_v2.py 帮助您从简单的 Excel 文件生成库。将项目按预期格式结构化后，运行该脚本以生成相应的 YAML 文件。
• tools 目录还包含针对特定框架的专用转换器（例如，CIS 或 CCM 控制措施）。

创建映射库

为便于创建框架之间的映射，可使用 prepare_mapping_v2.py 工具。它基于两个现有的 YAML 格式框架库生成 Excel 文件。填写映射后，生成的 Excel 文件可：

• 直接加载到应用程序中，或

• 使用 convert_library_v2.py 转换为 YAML。

• Python 3.14+

• pip 25.3+

• uv 0.9+

• node 24+

• npm 10.2+

• pnpm 10.30+

• yaml-cpp（brew install yaml-cpp libyaml 或 apt install libyaml-cpp-dev）

[实验性] 无WSL2的Windows开发额外要求

如果您希望在不使用WSL2的情况下开发项目，需要安装 MSYS2，将 MSYS2 UCRT64 二进制文件添加到您的系统PATH环境变量（通常二进制文件位于 C:\msys64\ucrt64\bin），然后通过 MSYS2 UCRT64 使用 pacman 安装以下依赖：

pacman -S mingw-w64-ucrt-x86_64-file mingw-w64-ucrt-x86_64-pango

安装依赖后，还需添加以下两个系统环境变量：

MAGIC=magic.mgc 文件的完整路径（通常为 `C:\msys64\ucrt64\share\misc\magic.mgc`）
WEASYPRINT_DLL_DIRECTORIES=MSYS2 UCRT64 二进制文件的路径（同上）

由于Windows的默认编码不是 UTF-8 而是 cp1252，某些打印 UTF-8 字符（如表情符号）的Python脚本可能在某些情况下导致后端崩溃或故障（例如库导入）。 为避免此项目出现该问题，通过添加以下两个用户环境变量强制使用 UTF-8 编码：

PYTHONUTF8=1
PYTHONIOENCODING=utf-8:replace

[!NOTE]

已知问题

• Windows上的 libmagic 库（MIME检测）在读取Excel文件（.xlsx）的前 2048 位时难以识别文件类型，导入Excel库时通常返回 application/octet-stream（后端会显示警告消息 [warning ] Invalid MIME type）。得益于 backend/library/views.py:StoredLibraryViewSet.upload_library 中的回退方法，这不会阻止Excel文件的导入。

运行后端

1. 克隆仓库。

git clone git@github.com:intuitem/ciso-assistant-community.git
cd ciso-assistant-community

2. 在父文件夹中创建一个文件（例如 ../myvars），通过复制并修改以下代码来存储环境变量，将 " " 替换为您的私有值。注意不要将此文件提交到git仓库。

必填变量

后端的所有变量都有便捷的默认值。

推荐变量

export DJANGO_DEBUG=True

# 默认URL设置为 http://localhost:5173，但您可以更改，例如使用caddy代理启用https
export CISO_ASSISTANT_URL=https://localhost:8443

# 例如使用Mailhog设置开发邮件服务器
export EMAIL_HOST_USER=''
export EMAIL_HOST_PASSWORD=''
export DEFAULT_FROM_EMAIL=ciso-assistant@ciso-assistantcloud.com
export EMAIL_HOST=localhost
export EMAIL_PORT=1025
export EMAIL_USE_TLS=True # true表示使用STARTTLS
export EMAIL_USE_SSL=False # true表示使用SMTPS

其他变量

# CISO Assistant默认使用SQLite，但您可以通过声明以下变量来设置PostgreSQL
export POSTGRES_NAME=ciso-assistant
export POSTGRES_USER=ciso-assistantuser
export POSTGRES_PASSWORD=
export POSTGRES_PASSWORD_FILE= # 指定密码的另一种方式
export DB_HOST=localhost
export DB_PORT=5432 # 可选，默认值为5432

# CISO Assistant默认使用文件系统存储后端。
# 一次只能激活一个云存储后端（USE_S3和USE_AZURE互斥）。

# --- AWS S3 ---
# 您可以通过声明以下变量使用S3存储桶
# 启动CISO Assistant前必须创建S3存储桶
export USE_S3=True
export AWS_STORAGE_BUCKET_NAME=
export AWS_S3_REGION_NAME= # 可选，例如 us-east-1

# S3认证选项1：访问密钥（适用于独立部署或S3兼容服务）
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
export AWS_S3_ENDPOINT_URL= # S3兼容服务（如MinIO）必填

# S3认证选项2：IRSA（适用于Kubernetes/EKS部署）
# 在启用IAM Roles for Service Accounts (IRSA)的EKS上运行时，
# 这些环境变量由Pod的服务账户自动注入。
# 无需显式配置——只需确保设置USE_S3=True和AWS_STORAGE_BUCKET_NAME。
# export AWS_WEB_IDENTITY_TOKEN_FILE=/var/run/secrets/eks.amazonaws.com/serviceaccount/token
# export AWS_ROLE_ARN=arn:aws:iam::123456789012:role/ciso-assistant-s3-role

# --- Azure Blob Storage ---
# 您可以使用Azure Blob Storage容器代替S3。
# 启动CISO Assistant前必须创建容器。
# export USE_AZURE=True
# export AZURE_CONTAINER= # 默认：ciso-assistant-container
# export AZURE_CUSTOM_DOMAIN= # 可选，例如 cdn.example.com
# export AZURE_LOCATION= # 可选，容器内的路径前缀（例如 "media"）

# Azure认证选项1：账户密钥
# export AZURE_ACCOUNT_NAME=
# export AZURE_ACCOUNT_KEY=

# Azure认证选项2：连接字符串
# export AZURE_CONNECTION_STRING=

# Azure认证选项3：托管身份（适用于Azure托管部署）
# 需要AZURE_ACCOUNT_NAME。Pod/VM分配的托管身份会自动使用。
# export AZURE_ACCOUNT_NAME=
# export AZURE_USE_MANAGED_IDENTITY=True

# 添加第二个备用邮件服务器（即将弃用，不推荐使用）
export EMAIL_HOST_RESCUE=
export EMAIL_PORT_RESCUE=587
export EMAIL_HOST_USER_RESCUE=
export EMAIL_HOST_PASSWORD_RESCUE=
export EMAIL_USE_TLS_RESCUE=True
export EMAIL_USE_SSL_RESCUE=False

# 您可以定义第一个超级用户的邮箱，便于自动化。系统会向超级用户发送密码初始化邮件
export CISO_SUPERUSER_EMAIL=

# 默认情况下，Django密钥在CISO Assistant每次启动时随机生成。这便于快速测试，
# 但不推荐用于生产环境，因为可能会破坏会话（详见
# 此[主题](https://stackoverflow.com/questions/15170637/effects-of-changing-djangos-secret-key)）。
# 要设置固定密钥，请使用环境变量DJANGO_SECRET_KEY。
export DJANGO_SECRET_KEY=...

# 运行不受信任代码的沙箱模式（例如库Excel文件）
# 警告：生产环境中必须启用沙箱。
export ENABLE_SANDBOX=True # 可选，生产环境（DJANGO_DEBUG=False）默认值为True，开发环境（DJANGO_DEBUG=True）默认值为False。

5. 推荐：安装pre-commit钩子。

pre-commit install

6. 如果要设置Postgres：

• 运行以下命令之一以进入Postgres：
  • psql as superadmin
  • sudo su postgres
  • psql
• 创建数据库“ciso-assistant”

create database ciso-assistant;

• 创建用户“ciso-assistantuser”并授予其访问权限

create user ciso-assistantuser with password ' ';

grant all privileges on database ciso-assistant to ciso-assistantuser;

[!NOTE] 前端无法自动推断主机，因此您需要设置ORIGIN变量，或者设置HOST_HEADER和PROTOCOL_HEADER变量。有关此复杂问题，请参见sveltekit文档。请注意，此方法不适用于"pnpm run dev"，这在生产环境中无需担心。

[!NOTE] Caddy需要接收SNI头。因此，对于您的公共URL（在CISO_ASSISTANT_URL中声明的URL），您需要使用FQDN，而不是IP地址，因为如果主机是IP地址，浏览器不会传输SNI。这是另一个复杂问题！

[!NOTE] docker-compose模板文件现在以非root模式启动后端、huey和前端。如果您使用旧的docker-compose.yml文件，建议进行更新。容器兼容root和非root两种模式。

非root Docker容器

docker-compose.yml现在依赖镜像中已有的非root用户1001:1001。旧部署使用root用户，该模式仍受支持。要迁移到非root模式，请在主机中执行以下步骤：

• docker compose down
• 更新docker-compose.yml文件
• sudo chown -R 1001:1001 db
• docker compose up -d

支持的语言 🌐

参考文件为en.json；覆盖率=每个区域设置文件中存在的参考键的比例。每日自动刷新——详细分类请参见https://intuitem.github.io/metrics/i18n/%E3%80%82

贡献者 🤝

技术栈 💜

• Django - Python Web开发框架
• SvelteKit - 前端框架
• eCharts - 图表库
• unovis - 辅助图表库
• Gunicorn - UNIX环境下的Python WSGI HTTP服务器
• Caddy - 最出色的反向代理
• Gitbook - 文档平台
• PostgreSQL - 开源关系型数据库管理系统
• SQLite - 开源关系型数据库管理系统
• Docker - 容器引擎
• inlang - 软件全球化生态系统
• Huey - 轻量级任务队列

安全性

我们已尽力遵循安全最佳实践。如发现任何问题，请报告至。

许可协议

本仓库包含CISO Assistant开源版本（社区版）和商业版本（专业版和企业版）的源代码，其中社区版采用AGPL v3许可协议发布，商业版采用intuitem商业软件许可协议发布。为简化管理，采用了单仓库的方式。

顶级"enterprise"目录中的所有文件均采用intuitem商业软件许可协议发布。

顶级"enterprise"目录之外的所有文件均采用AGPLv3许可协议发布。

详情参见LICENSE.md。有关商业版本的更多详情，您可以通过联系我们。

除非另有说明，所有文件均© intuitem。

活动