3.10. 管理审计日志记录

您可以为管理接口启用审计日志，它会记录使用管理控制台、管理 CLI 或使用管理 API 的自定义应用执行的所有操作。审计日志条目以 JSON 格式存储。默认情况下禁用审计日志。

您可以将审计日志记录配置为输出到文件或 syslog 服务器。

注意

由于 JBoss EAP 中没有经过身份验证的会话，因此无法对登录和注销事件进行审计。相反，当从用户收到操作时，会记录审计消息。

独立服务器审计日志记录

虽然默认禁用，但默认的审计日志配置会写入到文件中。 

<audit-log>
    <formatters>
        <json-formatter name="json-formatter"/>
    </formatters>
    <handlers>
        <file-handler name="file" formatter="json-formatter" path="audit-log.log" relative-to="jboss.server.data.dir"/>
    </handlers>
    <logger log-boot="true" log-read-only="false" enabled="false">
        <handlers>
            <handler name="file"/>
        </handlers>
    </logger>
</audit-log>

此配置可以通过以下管理 CLI 命令读取： 

/core-service=management/access=audit:read-resource(recursive=true)

请参阅启用审计日志记录，为单机服务器启用审计日志记录。

受管域审计日志记录

虽然默认为禁用，默认的审计日志记录配置会为每个主机和每台服务器写入一个文件。 

<audit-log>
    <formatters>
        <json-formatter name="json-formatter"/>
    </formatters>
    <handlers>
        <file-handler name="host-file" formatter="json-formatter" relative-to="jboss.domain.data.dir" path="audit-log.log"/>
        <file-handler name="server-file" formatter="json-formatter" relative-to="jboss.server.data.dir" path="audit-log.log"/>
    </handlers>
    <logger log-boot="true" log-read-only="false" enabled="false">
        <handlers>
            <handler name="host-file"/>
        </handlers>
    </logger>
    <server-logger log-boot="true" log-read-only="false" enabled="false">
        <handlers>
            <handler name="server-file"/>
        </handlers>
    </server-logger>
</audit-log>

此配置可以通过以下管理 CLI 命令读取： 

/host=HOST_NAME/core-service=management/access=audit:read-resource(recursive=true)

请参阅启用审计日志记录，为受管域启用审计日志记录。

3.10.1. 启用管理审计日志记录

JBoss EAP 预配置了审计日志记录的文件处理程序，但审计日志记录默认为禁用。启用审计日志记录的管理 CLI 命令取决于您是以单机服务器还是在受管域中运行。如需文件处理程序属性，请参阅管理审计日志记录属性。

以下说明启用 NATIVE 和 HTTP 审计日志记录。要配置 JMX 审计日志，请参阅 启用 JMX 管理审计日志。

要设置 syslog 审计日志记录，请参阅发送管理审计日志记录到 Syslog 服务器。

启用单机服务器审计日志记录

可以使用以下命令启用审计日志记录： 

/core-service=management/access=audit/logger=audit-log:write-attribute(name=enabled,value=true)

默认情况下，这会将审计日志写入 EAP_HOME/standalone/data/audit-log.log。

启用受管域审计日志记录

受管域的默认审计日志记录配置已预先配置为为每个主机和每一服务器写入审计日志。

可以使用以下命令，为每个主机启用审计日志记录： 

/host=HOST_NAME/core-service=management/access=audit/logger=audit-log:write-attribute(name=enabled,value=true)

默认情况下，这会将审计日志写入 EAP_HOME/domain/data/audit-log.log。

可以使用以下命令，为每个服务器启用审计日志记录： 

/host=HOST_NAME/core-service=management/access=audit/server-logger=audit-log:write-attribute(name=enabled,value=true)

默认情况下，这会将审计日志写入 EAP_HOME/domain/servers/SERVER_NAME/data/audit-log.log。