CDP 审计

这个软件包允许服务向CDP审计流写出审计信息.

安装

npm i @defra/cdp-auditing

使用量

Cdp-审计库并不十分复杂.

基本审计

向审计流程发送信息,只需导入审计库并拨打 audit() 函数.

import { audit } from '@defra/cdp-auditing'
audit('This is a test of auditing')
// {"log.level":"audit","time":"2025-07-04T11:46:33.278Z","msg":"This is a test of auditing"}

审计结构化数据

也可以将结构化数据写入审计流. 传入的值应该像Json一样可以序列.

audit({ id: '1234', event: 'login', outcome: 'denied' }, 'Login failed')
// {"log.level":"audit","time":"2025-07-04T11:46:33.278Z","id":"1234","event":"login","outcome":"denied","msg":"Login failed"}

audit({ id: '1234', event: 'login', outcome: 'denied' })
// {"log.level":"audit","time":"2025-07-04T11:46:33.278Z","id":"1234","event":"login","outcome":"denied"}

当本地运行时,审计信息会被打印到控制台上,以便您看到哪些数据会进行审计.

默认情况下可以进行审计。 要开启或关闭审计,您可以拨打:

import { audit, enableAuditing } from '@defra/cdp-auditing'

// Turn auditing off
enableAuditing(false)

// Re-enable auditing
enableAuditing()
// or
enableAuditing(true)

CDP平台上的审计工作

审计基本上只是预先配置的标准记录器,以完成以下工作:

• 写到控制台/ studout
• 以 JSON 写出所有信件
• 确保所有信件包含ECS样式 log.level 设置为 audit

在CDP平台上运行的服务部署有日志收集辅助车(FluentBit).

日志侧车根据它们过滤信件 log.level 字段。 信件带有 "log.level": "audit" 为: 已过滤出并发送到审计流,而所有其他日志级别则被发送到OpenSearch管道.