cingulara/openrmf-msg-audit

openrmf-msg-audit

镜像概述和主要用途

openrmf-msg-audit是OpenRMF工具的消息服务，用于监听和记录OpenRMF系统中的所有可审计操作。该服务专门处理以“openrmf.audit.”为前缀的审计记录，实现审计事件的读取与存储。

核心功能和特性

• 监听OpenRMF系统中的可审计操作事件
• 处理以“openrmf.audit.”为前缀的所有审计记录
• 与NATS消息系统集成，接收审计事件消息
• 将审计记录持久化存储到MongoDB数据库

使用场景和适用范围

适用于OpenRMF工具生态中审计日志的集中收集与管理，为系统管理员提供操作审计追踪能力，确保OpenRMF平台内所有关键操作可记录、可查询。

使用方法和配置说明

运行NATS Docker镜像

需先运行NATS服务器作为消息 broker：

bash
docker run --rm --name nats-main -p 4222:4222 -p 6222:6222 -p 8222:8222 nats:2.1.2-linux

• 默认配置，运行NATS服务器2.x版本（截至2019年12月）
• 内存运行模式，不包含流处理功能（流处理需单独配置）

环境要求

• .NET Core 3.x 运行时
• 添加NATS客户端包：dotnet add package NATS.Client
• 执行dotnet restore拉取所有依赖库
• C# NATS客户端库（https://github.com/nats-io/csharp-nats%EF%BC%89

制作本地Docker镜像

通过以下命令构建本地镜像：

bash
make build
make latest

数据库配置

创建数据库用户

1. 连接MongoDB（假设已安装MongoDB）：

   bash
   ~/mongodb/bin/mongo 'mongodb://root:myp2ssw0rd@localhost'
   

2. 切换到admin数据库并创建用户：

   bash
   use admin
   db.createUser({ user: "openrmfaudit" , pwd: "openrmf1234!", roles: ["readWriteAnyDatabase"]});
   

3. 创建审计数据库和集合：

   bash
   use openrmfaudit
   db.createCollection("Audits");
   

连接数据库

使用创建的用户连接到openrmfaudit数据库：

bash
~/mongodb/bin/mongo 'mongodb://openrmfaudit:openrmf1234!@localhost/openrmfaudit?authSource=admin'

查看审计记录

列出已插入/更新的审计记录：

bash
db.Audits.find();