buluma.auditd

Ansible 角色 auditd

在您的系统上安装和配置 auditd。

GitHub 版本 问题 拉取请求 下载
github 版本 问题 拉取请求 Ansible 角色

示例 Playbook

此示例取自 molecule/default/converge.yml,并在每次推送、拉取请求和发布时进行测试。

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: buluma.auditd
      auditd_start_service: false
      auditd_local_events: "no"
      auditd_rules:
        - file: /var/log/audit/
          keyname: auditlog
        - file: /etc/audit/
          permissions:
            - write
            - attribute_change
          keyname: auditconfig
        - file: /etc/libaudit.conf
          permissions:
            - write
            - attribute_change
          keyname: auditconfig
        - file: /etc/audisp/
          permissions:
            - write
            - attribute_change
          keyname: audispconfig
        - file: /sbin/auditctl
          permissions:
            - execute
          keyname: audittools
        - file: /sbin/auditd
          permissions:
            - execute
          keyname: audittools
        - syscall: open
          action: always
          filter: exit
          filters:
            - auid!=4294967295
            - auid!=unset
          keyname: my_keyname
          arch: b32
        - syscall: adjtimex
          action: always
          filter: exit
          keyname: time_change
        - syscall: settimeofday
          action: always
          filter: exit
          keyname: time_change
        - action: always
          filter: exit
          filters:
            - path=/bin/ping
            - perm=x
            - auid>=500
            - auid!=4294967295
          keyname: privileged

需要准备机器。在 CI 中,可以使用 molecule/default/prepare.yml 来完成此操作:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: buluma.bootstrap

请查看 完整解释和示例,了解如何使用这些角色。

角色变量

变量的默认值设置在 defaults/main.yml 中:

---
# auditd 的默认文件

# 以下变量在 auditd.conf 的手册页中有说明
# https://linux.die.net/man/5/auditd.conf
auditd_buffer_size: 32768
auditd_fail_mode: 1
auditd_maximum_rate: 60
auditd_enable_flag: 1
auditd_local_events: "yes"
auditd_write_logs: "yes"
auditd_log_file: /var/log/audit/audit.log
auditd_log_group: root
auditd_log_format: RAW
auditd_flush: incremental_async
auditd_freq: 50
auditd_max_log_file: 8
auditd_num_logs: 5
auditd_priority_boost: 4
auditd_disp_qos: lossy
auditd_dispatcher: /sbin/audispd
auditd_name_format: none
auditd_max_log_file_action: rotate
auditd_space_left: "75"  # 这可以是数字('25')或百分比('25%')
auditd_space_left_action: syslog
auditd_verify_email: "yes"
auditd_action_mail_acct: root
auditd_admin_space_left: 50
auditd_admin_space_left_action: suspend
auditd_disk_full_action: suspend
auditd_disk_error_action: suspend
auditd_use_libwrap: "yes"
auditd_tcp_listen_queue: 5
auditd_tcp_max_per_addr: 1
auditd_tcp_client_max_idle: 0
auditd_enable_krb5: "no"
auditd_krb5_principal: auditd
auditd_distribute_network: "no"

# 您可以选择使用此角色来管理规则。
# 将 auditd_manage_rules 设置为 false 将不会管理规则。
auditd_manage_rules: true

# 有些规则需要设置特定的架构。
auditd_default_arch: b64

# 您可以选择是否启动 auditd 服务。
# 在 CI 中尤其有用,以避免启动服务。
auditd_start_service: true

要求

已使用角色的状态

以下角色用于准备系统。您可以用其他方式准备系统。

需求 GitHub 版本
buluma.bootstrap Ansible Molecule 版本

上下文

此角色是多个兼容角色的一部分。有关更多信息,请查看 这些角色的文档

这里是相关角色的概述:

依赖关系

兼容性

此角色已在这些 容器镜像 上测试:

容器 标签
EL 8, 9
Debian 所有
Fedora 所有
opensuse 所有
Ubuntu 所有

所需的 Ansible 最低版本为 2.12,测试已进行如下操作:

  • 先前版本。
  • 当前版本。
  • 开发版本。

如果发现问题,请在 GitHub 注册。

变更日志

角色历史

许可证

Apache-2.0

作者信息

Shadow Walker

关于项目

Install and configure auditd on your system.

安装
ansible-galaxy install buluma.auditd
许可证
apache-2.0
下载
18.3k
拥有者
DevOps Engineer