Analyze from audit log

[jw3]

todo

• [x] add user guide section for general usage
• [x] add user guide content for configuring auditd
• [x] add audit log tests for python

---

Add support for analyzing from kernel audit logs

Adds an "audit" analyze event source that reads fanotify events from libaudit to be displayed in the analyzer. The records are read into the common Event structure that allows them to flow through the same API as the events from syslog and debug logs.

The entrypoint to this functionality is found in the Analyze menu and behaves similar to syslog where there is not a prompt to provide a path to the log file. The backend uses the libaudit API to locate and parse the system audit log.

This currently only has runtime support in the Kernel on Fedora Rawhide (fc39), so while the backend is always built the frontend is disabled on all other platforms.

It is anticipated that rhel 8 and 9 will both contain the required audit support at some point in the future. The build is currently wired into both of them with the feature flag disabled, hiding the functionality in the UI.

The audit support is implemented using bindgen to create native bindings to libaudit and auparse. To enable this our build requirements have grown to include clang and the audit dev libs to support building the bindings with bindgen. These bindings are generated at compile time and are excluded from version control.

Also adds

• Adds LogType enum in place of some magic strings
• Plumbs feature support into the python build.
• Improves the make header-check to support piping the output

Requires

• Kernel >= 6.3
• Audit >= 3.1
• fapolicyd >= 1.2

It may be possible to move the feature flag to a runtime check, allowing upgraded systems to use the audit feature. This is not within the scope of this PR. Given that that there is no support outside of fc39, there is some time to refine audit related capability before it has wide applicability.

Reference

• https://github.com/linux-audit/audit-kernel/commit/032bffd494e3924cc8b854b696ef9b5b7396b883
• https://github.com/linux-audit/audit-userspace/commit/d1aec22f62b1cd95c16b26b67a9268ed27713f84
• https://lore.kernel.org/linux-fsdevel/20230207120921.7pgh6uxs7ze7hkjo@quack3/
• https://github.com/linux-application-whitelisting/fapolicyd/issues/84
• https://github.com/linux-application-whitelisting/fapolicyd/commit/ee9c99a8ac9a13e42a97979fe774b6a412c8d9c6

Closes #294

[jw3]

Testing on FC 39 will require 1.2 version of fapolicyd due to #885

dnf install https://kojipkgs.fedoraproject.org//packages/fapolicyd/1.2/5.fc39/x86_64/fapolicyd-1.2-5.fc39.x86_64.rpm

[jw3]

Init auditd rules

cp /usr/share/audit/sample-rules/43-module-load.rules /etc/audit/rules.d/audit.rules