Ansible Rolle: aisbergg.beats

Diese Ansible-Rolle kann verschiedene Beats-Datenversender aus der offiziellen Beats-Familie installieren und konfigurieren. Folgende Beats werden von dieser Rolle unterstützt:

• auditbeat
• filebeat
• functionbeat
• heartbeat
• metricbeat
• packetbeat

Anforderungen

Keine.

Rollenvariablen

Abhängigkeiten

Keine.

Beispiel-Playbook

- hosts: all
  vars:
    # Auditbeat-Service installieren und verwalten
    auditbeat_install_state: present
    auditbeat_service_enabled: true
    auditbeat_service_state: started

    auditbeat_config:
      # Protokolle an zentralen Protokollsammler übertragen
      output.logstash:
        hosts:
          - graylog1.example.org:5555
          - graylog2.example.org:5555
        loadbalance: true
        slow_start: true

      logging.level: warning
      logging.to_files: false
      logging.metrics.enabled: false

      auditbeat.modules:
        # https://www.elastic.co/guide/en/beats/auditbeat/current/auditbeat-module-auditd.html
        # ersetzt das Auditd-Programm (sollte nicht parallel zu Auditd ausgeführt werden)
        - module: auditd
          resolve_ids: true
          failure_mode: silent
          backlog_limit: 8196
          rate_limit: 0
          include_raw_message: false
          include_warnings: false
          audit_rule_files: [ '${path.config}/audit.rules.d/*.conf' ]
          # entnommen von: https://github.com/Neo23x0/auditd/blob/master/audit.rules
          audit_rules: |
            # Selbst-Audit -----------------------------------------------------------

            ## Audit der Audit-Logs
            ### Erfolgreiche und erfolglose Versuche, Informationen aus den Audit-Referenzen zu lesen
            -w /var/log/audit/ -k auditlog

            ## Auditd-Konfiguration
            ### Änderungen an der Audit-Konfiguration, die stattfinden, während die Audit-Sammlung aktiv ist
            -w /etc/audit/ -p wa -k auditconfig
            -w /etc/libaudit.conf -p wa -k auditconfig
            -w /etc/audisp/ -p wa -k audispconfig

            ## Überwachung der Nutzung von Audit-Verwaltungstools
            -w /sbin/auditctl -p x -k audittools
            -w /sbin/auditd -p x -k audittools
            -w /usr/sbin/augenrules -p x -k audittools

            # Filter -----------------------------------------------------------------

            ### Wir setzen diese frühzeitig ein, da Audit ein "First Match Wins"-System ist.

            ## Ignoriere SELinux AVC-Datensätze
            -a always,exclude -F msgtype=AVC

            ## Ignoriere aktuelle Arbeitsverzeichnis-Datensätze
            -a always,exclude -F msgtype=CWD

            ## Ignoriere EOE-Datensätze (End Of Event)

        # https://www.elastic.co/guide/en/beats/auditbeat/current/auditbeat-module-file_integrity.html
        - module: file_integrity
          paths:
            - /bin
            - /usr/bin
            - /sbin
            - /usr/sbin
            - /etc
          exclude_files:
            - '(?i)\.sw[nop]$'
            - '~$'
            - '/\.git($|/)'
            - '/etc/mtab'
          scan_at_start: true
          scan_rate_per_sec: 50 MiB
          max_file_size: 300 MiB
          hash_types: [blake2b_256]
          recursive: true

        # https://www.elastic.co/guide/en/beats/auditbeat/current/auditbeat-module-system.html
        - module: system
          datasets:
            - package # Installierte, aktualisierte und entfernte Pakete
          period: 30m # Die Frequenz, mit der die Datensätze nach Änderungen suchen

        - module: system
          datasets:
            - host    # Allgemeine Host-Informationen, z.B. Uptime, IPs
            - login   # Benutzeranmeldungen, -abmeldungen und Systemstarts.
            - process # Gestartete und gestoppte Prozesse
            - user    # Benutzerinformationen
          state.period: 6h
          user.detect_password_changes: true
          # Dateimuster der Anmeldedateien.
          login.wtmp_file_pattern: /var/log/wtmp*
          login.btmp_file_pattern: /var/log/btmp*

  roles:
    - aisbergg.beats

Lizenz

MIT

Autoreninformation

Andre Lehmann (aisberg@posteo.de)