Security¶
Java、Python、Node.js、.NET、PHP 的 Beacon Security 是现有零代码软件包中的可选能力; Ruby 通过可选 gem 分发,需要显式配置 Rack/SDK。Security 默认关闭。
| 语言 | 本指南采用的版本 | 运行时范围 | 部署方式 |
|---|---|---|---|
| Java | 1.3.4 | 完整 Java Agent | 单个 Agent JAR |
| Python | 1.2.4 | 标准 GIL 的 CPython 3.11–3.14 | 现有 beacon 命令 |
| Node.js | 2.0.1 | Node.js 22.22.3+ 或 24.11.1+ | 现有软件包加 ESM 预加载 |
| .NET | 1.1.1,实验性 | CoreCLR .NET 8–10:Linux glibc x64、Windows x64、macOS ARM64 | 现有 beacon-dotnet run 命令 |
| PHP | 1.3.0,实验性 | PHP 8.2–8.4,已验证 Linux glibc x86_64 | 现有安装器与 Agent 运行时 |
| Ruby | 1.1.0 / gem 0.1.0 | Linux CRuby 3.3/3.4/4.0 CI,3.3.12 Collector 验收 | GitHub gem 与 Rack 中间件 |
启用后,Security 通过应用现有的 OpenTelemetry Logs 管道发送安全发现和运行时软件 清单。运行时 SBOM 在 Security 生命周期中默认开启;进程本地诊断文件仍保持关闭, 除非显式启用。
安全发现表示有边界的已建模数据流观测或候选风险,并不确认应用存在漏洞。请先选择 应用运行时对应的指南,并在扩大配置范围前验证已导出的 Logs 记录。
解读安全发现¶
参见安全发现与证据,了解代码风险、请求攻击证据与利用结果的区别, 以及逐请求计数、Trace 关联和证据采样。该页列出了 Java、Node.js、Python 的最低版本与 schema v1/v2 差异;不能据此推断 PHP、.NET 或 Ruby 具有相同覆盖;.NET 已发布范围见 .NET Security。Ruby v2 findings 始终保留 unknown 攻击证据与近似关联精度, 具体覆盖见 Ruby Security。
安全发现的导出策略¶
Java 1.3.4、Node.js 2.0.1 和 Python 1.2.4 默认过滤 no_evidence 事件,没有收到事件不代表没有检测到风险。设置 BEACON_SECURITY_EXPORT_NO_EVIDENCE_ENABLED=true 可恢复导出,默认值为 false。参见安全发现与证据,了解状态含义、同请求升级与投递限制。
接入 DataKit¶
先按公共配置开启 DataKit OpenTelemetry 采集器,再完成对应语言的安装。Security 通过 OTLP Logs 上报,在观测云「日志」中验证记录。以下语言示例假设应用与 DataKit 位于同一主机;跨主机或容器部署时替换接收地址。Ruby 仍需单独验证 DataKit 接收结果。
Java¶
参阅 Java Security,了解启用步骤、参数与覆盖范围。
Python¶
参阅 Python Security,了解启用步骤、参数与覆盖范围。
Node.js¶
参阅 Node.js Security,了解启用步骤、参数与覆盖范围。
.NET¶
参阅 .NET Security,了解启用步骤、参数与覆盖范围。
PHP¶
参阅 PHP Security,了解启用步骤、参数与覆盖范围。
Ruby¶
参阅 Ruby Security,了解启用步骤、参数与覆盖范围。