OmniCortex 文档

🇨🇳简体中文

🇺🇸English

🇨🇳简体中文

🇺🇸English

Appearance

敏感凭据扫描引擎 (secrets) ​

敏感凭据扫描引擎（secrets）是 OmniCortex 安全围栏体系中专为防止核心商业机密与代码凭证外泄而设计的核心防护驱动。该引擎直接运行于网关进程中，内置了业界工业级开源标杆 Gitleaks 经过严格审计的庞大规则库，专注于在人机对话、代码补全、文档生成等大模型交互场景中，毫秒级识别、拦截或动态脱敏暴露的敏感凭据。

在大模型广泛渗透研发全流程的背景下，员工复制粘贴代码片段时夹带 API 密钥、私钥证书或数据库连接串已成为企业最严峻的数据安全风险。secrets 引擎无需配置外部审计服务，以完全离线、高并发、极低开销的方式，为企业大模型落地提供开箱即用的敏感凭据安全防火墙。

一、 运行形态与部署依赖 ​

评估维度特性表现
运行形态内置运行 (In-Process)，直接作为网关的原生驱动编译运行，随网关实例启动即可直接工作。
网络环境依赖完全零外部网络依赖，所有凭据特征规则与扫描逻辑均在网关本地内存中执行，无需调用任何外网或第三方服务。
凭据与鉴权完全免凭据，无需申请或配置任何外部安全厂商的账号、API Key 或访问令牌。
开销与稳定性极低内存与计算开销，具备优异的高并发吞吐能力，对实时流式会话与代码补全几乎不产生感知延迟。

二、 能力边界与处置动作 ​

1. 防护阶段覆盖 ​

  • 输入侧防护 (Input Phase)：全面审查开发者发送的提示词（Prompt）、提交的代码块以及多轮历史上下文。在请求发出前掐断凭据泄露，防止企业私有凭据被发送至公有商用模型；
  • 输出侧防护 (Output Phase)：实时审查大模型生成的返回内容。防止大模型在代码示例生成、配置补全中意外吐露或合成真实的测试凭据、内部数据库连接信息；
  • 流式输出感知：原生支持打字机流式输出的即时感知与动态掩码改写，确保在流式长连接交互中依然能够精准截断外泄风险。

2. 支持的处置动作矩阵 ​

处置动作支持情况动作生效表现与业务影响
刚性阻断 (block)✅ 支持一旦识别到真实凭据立即终止推理链路，向客户端返回标准安全阻断响应并标明泄露的凭据家族，防止有害请求继续流转。
动态脱敏 (redact)✅ 支持命中凭据后将泄露字符动态替换为安全掩码（如 [REDACTED_SECRET] 或 ******），保障研发代码审查与问答继续进行的同时消除泄密风险。
仅检测审计 (detect_only)✅ 支持旁路静默观察，不对输入或输出做任何阻断与修改，仅在全量安全审计日志中记录凭据暴露线索，用于企业合规风险感知与策略灰度。

三、 典型业务应用场景 ​

  • 场景一：AI 研发助手与代码问答防泄密 工程师在使用智能编程助手或向大模型询问“帮我重构这段代码”时，无意中将包含了生产环境 AWS Access Key、GitHub PAT、私钥证书或数据库连接串的代码片段复制到了输入框。secrets 引擎在网关侧即刻将其阻断或脱敏，杜绝私有凭证流出内网。
  • 场景二：自动化 CI/CD 与 Agent 任务安全拦截 在企业内部自动化工作流中，大模型 Agent 或自动化脚本处理的日志文件、环境配置中偶发包含明文密码或临时 Token。引擎充当守护闸门，防止系统凭据在跨应用调度中发生扩散泄露。
  • 场景三：技术支持与知识库文档清洗 企业在向公有云大模型上传技术文档或在工单交互中，自动剔除文档正文中历史遗留的真实客户私有密钥、测试账号密码及生产 Webhook 地址，确保知识资产的合规安全。

四、 规则体系与自定义扩展能力 ​

1. 开箱即用规则库 (覆盖 10 大核心凭据家族) ​

secrets 引擎内置了 220+ 细粒度生产级凭据检测器，深度覆盖全球主流云厂商、DevOps 工具链与现代软件技术栈：

凭据家族典型覆盖凭据类别业务防护重点与价值
云基础设施凭据AWS Access Key / Bedrock 密钥、Azure AD Client Secret、GCP API Key、阿里云 AccessKey、腾讯云密钥、Cloudflare、DigitalOcean 等防止企业公有云算力账号与存储桶被越权盗用
代码托管与 CI/CDGitHub PAT / OAuth / App Token、GitLab Token、Bitbucket、Docker Hub、Travis CI、Drone CI、Codecov 等防止内部私有代码仓库与自动化流水线被越权拉取
AI 与大模型平台OpenAI API Key、Anthropic 密钥、Cohere、HuggingFace Token、Perplexity 等防止企业托管或付费订阅的高价值大模型密钥外泄
包管理与制品库npm、PyPI、RubyGems、NuGet、JFrog Artifactory、Clojars 等防止开发者拥有发布权限的内部私有依赖源遭到篡改投毒
基础设施与密钥库HashiCorp Vault Token、Terraform Cloud Token、Kubernetes Secret YAML、1Password 服务凭证、Age 密钥等守住企业底层核心基础设施与敏感凭证中枢
监控与数据资产Datadog、Grafana、New Relic、Sentry、ClickHouse、Databricks、Confluent 等杜绝企业内部生产可观测指标与大数据引擎凭据暴露
协同与即时通讯Slack Bot Token / Webhook、Discord Token、Microsoft Teams Webhook、Telegram Bot Token 等防止企业内部协同通道与审批流被外部未授权注入信息
金融支付与电商Stripe、Square、Plaid、Coinbase、Shopify、Flutterwave 等严格保护企业商户资金渠道与金融级安全网关
CRM 与邮件服务HubSpot、Intercom、Zendesk、SendGrid、Mailchimp 等防范企业客户通讯录与外部通知服务被恶意盗发
通用密码与证书文件RSA/EC/PGP 私钥证书文件 (Private Key)、PKCS#12、通用 JWT、标准 Authorization 头杜绝最常见的未加密对称/非对称证书与通用 Token 扩散

2. 智能降噪与防误报能力表现 ​

为了避免开发者在提问“如何配置 AWS Access Key”或展示测试示例代码时产生频繁误拦截，secrets 引擎具备两项关键降噪表现：

  • 信息熵智能动态判定 (enable_entropy_checks)： 引擎不仅比对前缀字符格式，还会对疑似凭据的随机性程度进行动态检验。对于类似 AKIAIOSFODNN7EXAMPLE 这类公开文档中常见的占位符或低随机性词汇，引擎会自动识别并放行，仅对真实具备高随机性的有效密钥触发拦截。
  • 白名单精准抑制机制： 支持配置测试密钥与固定示例字串白名单。对于研发团队已公开的合法测试 Token 或固定测试样例，可一键将其列入白名单，保障开发与测试流程顺畅无阻。

3. 灵活的自定义管理能力 ​

管理员可在控制台检测能力库中针对不同业务环境，灵活开启或关闭特定的凭据家族或检测器，按需为不同应用配置精准的凭据风控标准。

五、 关键配置项说明 ​

管理员在配置 secrets 引擎时，可结合业务场景调节以下核心参数：

配置项参数类型默认值业务配置含义与建议
信息熵校验开关 (enable_entropy_checks)布尔值true是否启用信息熵动态判定。建议保持开启，可大幅过滤无害的文档示例与开发测试占位符。
单次检查文本上限 (max_input_bytes)整数 (字节)1048576 (1 MiB)单次请求最大允许扫描的文本大小（系统硬上限 10 MiB），超出时自动拒绝，保护网关算力。
单次最大命中上限 (max_findings)整数 (个)256单次检测允许的最大发现违规数量（系统硬上限 10,000），击穿阈值时触发熔断报错。
脱敏掩码提示符 (mask / redact_hint)字符串[REDACTED_SECRET]执行脱敏改写时替换的提示占位符，支持自定义为符合企业审计要求的掩码。

六、 适用边界与编排建议 ​

1. 推荐适用场景 ​

  • 研发团队 AI 编程助手与 Copilot 工具集成：研发人员高频输入代码片段、配置文件与 Shell 脚本的交互场景；
  • DevOps 与自动化运维工作流：涉及流水线日志归档、自动化系统监控与工单处理的大模型调用链；
  • 零外部网络环境：完全无外网访问条件或对推理延迟有极高要求的内网私有算力环境。

2. 不适用或不建议单独依赖的场景 ​

💡 责任链编排建议

在防线责任链编排中，secrets 引擎常作为代码与研发场景的基石输入防线。管理员可在防线工作台中将其与特定开发团队的虚拟密钥绑定，或利用条件表达式仅针对代码类模型开启深度凭据审查。具体的多引擎组合编排与分流机制，详见 防线工作台：责任链编排与流量分流。