Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions packages/auditd_manager/changelog.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,9 @@
# newer versions go on top
- version: 1.16.1
changes:
- description: Fix socket type selection and documentation.
type: bugfix
link: https://github.com/elastic/integrations/pull/8558
- version: 1.16.0
changes:
- description: ECS version updated to 8.11.0.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,20 +3,16 @@ condition: ${host.platform} == 'linux'

type: audit/auditd
include_raw_message: true
{{#if multicast}}
socket_type: multicast
{{else}}
socket_type: unicast
socket_type: '{{socket_type}}'
immutable: {{immutable}}
{{/if}}
resolve_ids: {{resolve_ids}}
failure_mode: {{failure_mode}}
{{#if audit_rules}}
audit_rules: {{escape_string audit_rules}}
{{/if}}
{{#if audit_rule_files.length}}
audit_rule_files:
{{#each audit_rule_files as |file i|}}
{{#each audit_rule_files as |file|}}
- {{file}}
{{/each}}
{{/if}}
Expand All @@ -28,7 +24,7 @@ tags:
{{#if preserve_original_event}}
- preserve_original_event
{{/if}}
{{#each tags as |tag i|}}
{{#each tags as |tag|}}
- {{tag}}
{{/each}}
{{#contains "forwarded" tags}}
Expand Down
33 changes: 20 additions & 13 deletions packages/auditd_manager/data_stream/auditd/manifest.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,26 +6,33 @@ streams:
template_path: auditd.yml.hbs
description: Collect auditd events
vars:
- name: multicast
type: bool
- name: socket_type
title: Multicast socket type
show_user: true
required: true
multi: false
default: false
type: select
options:
- text: auto
value: ''
- text: unicast
value: unicast
- text: multicast
value: multicast
default: ''
description: |
This setting controls if the socket type used to receive events is multicast.
This setting should be disabled when `elastic-agent` is the primary userspace
daemon for receiving audit events and managing the rules. Only a single process
can receive audit events if this is disabled, so any other daemons should be
stopped (e.g. stop `auditd`).
This setting controls the socket type used to receive events. This setting should
be set to `unicast` when `elastic-agent` is the primary userspace daemon for receiving
audit events and managing the rules. Only a single process can receive audit events
when using unicast sockets, so any other daemons should be stopped (e.g. stop `auditd`).

This setting can be enabled with kernel versions 3.16 and newer. By setting it
`elastic-agent` will receive an audit event broadcast that is not exclusive
Multicast can be enabled with kernel versions 3.16 and newer. By setting it to
`multicast` `elastic-agent` will receive an audit event broadcast that is not exclusive
to a single process. This is ideal for situations where `auditd` is running and
managing the rules.

If it is set to `true`, but the kernel version is less than 3.16 it will be
automatically disabled.
If `auto` is selected, `elastic-agent` will attempt to use multicast sockets, falling
back to unicast if multicast is not available.
- name: immutable
type: bool
title: Immutable
Expand All @@ -34,7 +41,7 @@ streams:
default: false
description: |
This boolean setting sets the audit config as immutable (`-e 2`).
This option can only be used if `multicast` is disabled since `elastic-agent`
This option can only be used if socket type is not `multicast` since `elastic-agent`
needs to manage the rules to be able to set it.

Please note that with this setting enabled, after Elastic Agent restarts or
Expand Down
2 changes: 1 addition & 1 deletion packages/auditd_manager/manifest.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
format_version: "3.0.0"
name: auditd_manager
title: "Auditd Manager"
version: "1.16.0"
version: "1.16.1"
description: "The Auditd Manager Integration receives audit events from the Linux Audit Framework that is a part of the Linux kernel."
type: integration
categories:
Expand Down