要满足等保2.0三级要求,Dify知识库必须实现文档存储加密、向量数据加密、传输层mTLS及凭证零信任控制。需配置AES-256-GCM加密文档、升级Weaviate至1.23+启用落盘加密、Nginx SSL终止、服务间mTLS认证,并开启运行时凭证沙箱与最小权限RBAC。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Dify知识库真正满足等保2.0三级对“重要数据”的强制性保护要求,必须在数据落盘前完成加密、在跨组件传输时启用双向认证通道,否则上传的工艺图纸、质检标准等文档一旦被拖库或抓包,将直接触发合规一票否决。
知识库原始文档的存储加密配置
进入Dify部署目录下的dify/docker子目录,打开docker-compose.yml文件,在services.dify-api.environment区块中添加两行环境变量:
DIFY_ENCRYPTION_KEY=【32位随机AES-256密钥,必须用openssl rand -base64 32生成】
DIFY_ENCRYPTION_ALGORITHM=AES-256-GCM
这一步不可跳过——Dify默认不启用文件内容加密,所有PDF/Word上传后以明文形式存入MinIO,即使启用了SSL传输也毫无意义。密钥必须严格保管,丢失即永久无法解密已存文档。
保存后执行docker-compose up -d --force-recreate dify-api重启服务,新上传的文档将自动加密写入MinIO,旧文档需手动触发重载流程才能加密。
向量数据库嵌入数据的加密防护
方法一:启用Weaviate的内置加密模块(推荐)
编辑docker-compose.yml中weaviate服务的environment部分,加入:
ENABLE_MODULES: "backup-s3,text2vec-transformers,rbac"
AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: "false"
CLUSTER_AUTHENTICATION_ENABLED: "true"
⚠️ 注意:Weaviate 1.23+版本才支持向量数据落盘加密,低于此版本必须升级,否则向量库本身不提供加密能力,仅靠网络层TLS无法满足等保三级“存储加密”条款。
方法二:在Dify应用层拦截向量写入流
修改dify/api/core/model_runtime/embedding/base.py,在invoke方法返回前插入AES-256加密逻辑,使用与文档加密相同的DIFY_ENCRYPTION_KEY,对embeddings列表中的每个float32数组序列化为bytes后加密再存入Weaviate。
API调用链路的传输加密加固
第一步:确认Nginx反向代理已启用SSL终止
检查/etc/nginx/conf.d/dify.conf中是否包含ssl_certificate和ssl_certificate_key指向有效证书,且listen 443 ssl http2已启用。
第二步:强制Dify内部服务间通信走mTLS
在docker-compose.yml的dify-api与weaviate服务间增加networks隔离段,并为Weaviate配置客户端证书校验:
WEAVIATE_AUTHENTICATION_APIKEY_ENABLED: "true"
WEAVIATE_AUTHENTICATION_APIKEY_USERS: "dify-api:【32字符API密钥】"
第三步:禁用所有HTTP明文端口暴露
将docker-compose.yml中weaviate服务的ports字段从- "8080:8080"改为# - "8080:8080"注释掉,仅保留Dify API通过Nginx 443端口对外暴露。
凭证与密钥的零信任读取控制
进入Dify控制台 → 【设置】→【系统】→【安全策略】,开启「运行时凭证沙箱」开关。
该功能启用后,所有自定义节点调用GetCredential接口时,Dify会强制验证调用上下文的RBAC权限,并仅解密当前工作空间内授权访问的凭证条目。
【必须执行】在【成员管理】中为每个开发角色分配最小权限集,例如禁止developer角色拥有secrets:read权限,否则其编写的自定义节点可绕过沙箱直接读取生产数据库密码。
验证方式:用开发账号登录后,在Workflow中新建一个Python节点,尝试执行GetCredential("DB_PASSWORD"),应返回permission denied错误。











