@datadog/native-appsec

中文文档
12.0.0发布于 2026/11/10Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 5072.8万

Libdwaf 的节点绑定

中文使用文档

dd- native-appsec-js (英语)

节点.js 绑定 自由妇女。 。 。 .

支持的平台

此软件包支持以下平台:

  • 节点.js 版本 : 18岁及以上
  • 操作系统:
    • macOS 14.2.1及以上(捆绑的libdwaf的最低目标)
      • x64 (韩语)
      • 军火64
    • 窗口
      • 编号x86
      • x64 (韩语)
    • 链接
      • x64 有 glibc
      • x64 有黏膜
      • 军火64

因此,不支持的平台包括:

  • Linux x86 函数
  • 手臂32
  • 第十六届
  • 太平洋共同体理事会

请随意 联系支持 如果您想请求支持一个新的平台.

向本地应用程序迁移 12

这个版本捆绑了libddwaf 2.2.0并更改了评价API. context.run(data, timeout) 现在直接收到地址映射。 前一个 { persistent, ephemeral } 信封不再被支持 。 关于范围数据, 创建子连接符 context.createSubcontext(),称为 run(data, timeout) 方法,并处理 finally。子文本继承父数据并保存 它自己的数据和评价在当地产生影响。 它能活过父母.

createContext() 返回时 null 没有活动规则的,包括后面 删除所有配置。 被拒绝的同道替代也可以删除 上一个配置; 呼叫者必须检查诊断和配置 在决定是否恢复后退规则时,路径。 拒绝的映射配置 全部从建构器中移除,包括路径和任何部分装入 内容。 顶级解析失败报告于 diagnostics.error。 。 。 . 如果重建没有产生手柄, 新的环境也会返回 null; 绑定 不区分一个空规则组和其他构建失败,也不保留一个陈旧的手柄.

持续时间为纳秒;超时输入为微秒. 动作是按动作类型键取的映射.

责任

本地应用程序dd- trace-js (英语)
原生手柄、分配器、最后敲定器和安全调配请求和运行寿命,包括明确处置
背景和子背景评价原始持续/范围大的投入路线、评价命令和共享的暂停预算
初步结果、诊断和截断测量成果汇总、封锁、报告和遥测
配置绑定和参数验证远程配置、倒置政策和已知地址过滤

Dd-trace-js 依赖性升级必须随同 API 迁移一起进行. 长期和范围评价的混合需要明确的成果汇总和 在跟踪器中共享时间预算。 本地约束并不推断这些政策.

转换和配置限制

评价数据限于每串4096字节,每个容器256个条目, 和20级的巢穴。 字符串截取保留了完整的UTF-8代码点. 截断量度计报告原尺寸. dd -trace -js拥有出口这些测量.

配置容器不受请求大小限制。 利布德瓦夫2.1级 大型容器 API 支持超过65535条目的配置阵列和地图.

调压器配置直接传递给libdwaf. 具有约束力的报告 构建器结果和诊断没有额外的正则克ex验证.

版本与发布记录

@datadog/native-appsec 共发布 53 个版本,首次发布于 2021/09/23;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
12.0.0latest2026/11/10今天
11.0.32026/10/051 个月前
11.0.22026/08/132 个月前
11.0.12026/02/198 个月前
11.0.02025/11/031 年前
10.3.02025/10/151.1 年前

关于 @datadog/native-appsec 的常见问题

@datadog/native-appsec 是什么?

Libdwaf 的节点绑定

如何安装 @datadog/native-appsec?

在项目目录运行 npm install @datadog/native-appsec,或使用 pnpm add / yarn add / bun add。

@datadog/native-appsec 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@datadog/native-appsec 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@datadog/native-appsec 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@datadog/native-appsec 可以商用吗?

@datadog/native-appsec 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@datadog/native-appsec 的下载量有多少?

根据 npm 官方下载统计,@datadog/native-appsec 在 2026/10/12 – 2026/11/10 这 30 天内被下载 50,727,775 次,日均约 1,690,926 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@datadog/native-appsec 还在维护吗?

最新版本 12.0.0 发布于 2026/11/10(今天);至今共发布 53 个版本,其中过去 12 个月发布了 4 个;首次发布于 2021/09/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。