开发自定义审计发布器

本节说明了如何使用 Java 创建新的自定义审计发布器。

随 Identity Manager 提供的控制台、文件和 JDBC 自定义发布器实现了 AuditLogPublisher 接口。可以在 REF 工具包中找到这些发布器的源代码。也可以在 REF 工具包中找到 Javadoc 格式的接口文档。（有关接口的详细信息，请参阅 Javadoc。）

REF（Resource Extension Facility，资源扩充工具）工具包是在产品 CD 上的 /REF 目录中提供的，或者是随安装映像提供的。

建议开发者扩展 AbstractAuditLogPublisher 类。此类可以解析配置并确保已将所有必需选项提供给发布器。（请参见 REF 工具包中的发布器示例。）

发布器必须具有一个无参数的构造函数。

发布器生命周期

以下步骤介绍发布器的生命周期：

1. 实例化对象。

2. 使用 setFormatter() 方法设置格式化程序（如果有）。

3. 使用 configure( Map) 方法提供选项。

4. 使用 publish( Map, LoggingErrorHandler) 方法发布事件。

5. 使用 shutdown() 方法终止发布器。

Identity Manager 启动以及更新审计配置时都执行步骤 1-3。如果调用关闭之前没有生成审计事件，则不会执行步骤 4。

在同一发布器对象上仅调用一次 configure(Map)。（发布器无需准备运行中的配置更改）。更新审计配置后，将先关闭当前发布器，然后再创建新发布器。

步骤 3 中的 configure() 方法可能会抛出 WavesetException。在这种情况下，将忽略发布器，并且对于此发布器不再会执行其他调用。

发布器配置

发布器可以没有选项，也可以具有多个选项。getConfigurationOptions() 方法将返回发布器支持的选项列表。这些选项可以使用 PublisherOption 类（有关此类的详细信息，请参见 Javadoc）进行封装。审计配置查看器在构建发布器的配置接口时将调用此方法。

Identity Manager 将在服务器启动时以及审计配置更改之后使用 configure( Map) 方法配置发布器。

开发格式化程序

REF 工具包包括以下格式化程序的源代码：

• XmlFormatter。将审计事件格式化为 XML 字符串。

• UlfFormatter。根据通用日志记录格式 (Universal Logging Format, ULF) 格式化审计事件。Sun Application Server 使用此格式。

格式化程序必须实现 AuditRecordFormatter 接口。此外，格式化程序必须具有一个无参数的构造函数。有关详细信息，请参阅 REF 工具包中的 Javadoc。

注册发布器/格式化程序

#ID#Configuration:SystemConfiguration 对象的审计属性列出了所有已注册的发布器和格式化程序。仅这些发布器和格式化程序可在审计配置用户界面中使用。