buluma.auditd

Rola Ansible auditd

Zainstaluj i skonfiguruj auditd na swoim systemie.

GitHub Wersja Problemy Prośby o złączenie Pobrania
github Version Issues PullRequests Ansible Role

Przykładowy Playbook

Ten przykład pochodzi z molecule/default/converge.yml i jest testowany przy każdym pushu, prośbie o złączenie i wydaniu.

---
- name: Zbieżność
  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

Maszyna musi być przygotowana. W CI jest to robione za pomocą molecule/default/prepare.yml:

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

  roles:
    - role: buluma.bootstrap

Zobacz także pełne wyjaśnienie i przykład dotyczące użycia tych ról.

Zmienne roli

Domyślne wartości dla zmiennych ustawione są w defaults/main.yml:

---
# domyślny plik dla auditd

# Poniższe zmienne są opisane w dokumentacji man dla 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"  # Może być liczbą ('25') lub procentem. ('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"

# Możesz zdecydować, czy zarządzać regułami za pomocą tej roli, czy nie.
# Ustawienie auditd_manage_rules na false nie będzie zarządzało regułami.
auditd_manage_rules: true

# Niektóre reguły wymagają ustawienia specyficznej architektury.
auditd_default_arch: b64

# Możesz zdecydować, czy uruchomić usługę auditd, czy nie.
# Głównie przydatne w CI, aby uniknąć uruchamiania usługi.
auditd_start_service: true

Wymagania

Stan używanych ról

Poniższe role są używane do przygotowania systemu. Możesz przygotować swój system w inny sposób.

Wymaganie GitHub Wersja
buluma.bootstrap Ansible Molecule Version

Kontekst

Ta rola jest częścią wielu zgodnych ról. Zobacz dokumentację tych ról tutaj w celu uzyskania dodatkowych informacji.

Oto przegląd powiązanych ról:

dependencies

Kompatybilność

Ta rola była testowana na tych obrazach kontenerów:

kontener tagi
EL 8, 9
Debian wszystkie
Fedora wszystkie
opensuse wszystkie
Ubuntu wszystkie

Minimalna wersja Ansible wymagana to 2.12, testy były przeprowadzane na:

  • poprzedniej wersji.
  • aktualnej wersji.
  • wersji deweloperskiej.

Jeśli znajdziesz problemy, zgłoś je w GitHub

Dziennik zmian

Historia roli

Licencja

Apache-2.0

Informacje o autorze

Shadow Walker

O projekcie

Install and configure auditd on your system.

Zainstaluj
ansible-galaxy install buluma.auditd
Licencja
apache-2.0
Pobrania
18.3k
Właściciel
DevOps Engineer