跳转至

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,了解启用步骤、参数与覆盖范围。

文档评价

文档内容是否对您有帮助?