Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.21

Documentation for other releases can be found by using the version selector in the top right of any doc page.

auditd

Manage Linux audit daemon rules.

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
rules_file		string		Path to the audit rules file. [default: `"/etc/audit/rules.d/audit.rules"`]
rules	true	array		List of audit rules to add or remove.
state		string	present absent	Whether the rules should be present or absent. [default: `"present"`]
reload		boolean		Whether to reload auditd after changes. [default: `true`]

Examples

- name: Add audit rules for identity files
  auditd:
    rules_file: /etc/audit/rules.d/audit.rules
    rules:
      - -w /etc/passwd -p wa -k identity
      - -w /etc/group -p wa -k identity
      - -w /etc/shadow -p wa -k identity
    state: present

- name: Add syscall audit rule
  auditd:
    rules_file: /etc/audit/rules.d/audit.rules
    rules:
      - -a always,exit -F arch=b64 -S execve -k exec
    state: present

- name: Remove specific audit rules
  auditd:
    rules_file: /etc/audit/rules.d/audit.rules
    rules:
      - -w /var/log -p wa -k logs
    state: absent

- name: Add rule without reload
  auditd:
    rules_file: /etc/audit/rules.d/audit.rules
    rules:
      - -w /etc/ssh/sshd_config -p wa -k ssh
    state: present
    reload: false