Skip to content

Commit

Permalink
[AuditdManager] Reverting Session Data option (#11420)
Browse files Browse the repository at this point in the history
* reverting session_data toggle

* updating PR changelog

* fixing change type

* reverting kibana changes
  • Loading branch information
opauloh authored Oct 15, 2024
1 parent efe898c commit c76f80f
Show file tree
Hide file tree
Showing 6 changed files with 13 additions and 83 deletions.
23 changes: 3 additions & 20 deletions packages/auditd_manager/_dev/build/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,21 +5,11 @@ is a part of the Linux kernel.

This integration is available only for Linux.

## Session View powered by Auditd Manager
## Session View powered by Auditd Manager [BETA]

The Auditd Manager is one of the integrations that can power the [Session View](https://www.elastic.co/guide/en/security/current/session-view.html) utility for the Elastic Security Platform. This feature provides a visual representation of session and process execution data, organized according to the Linux process model to help you investigate process, user, and service activity on your Linux infrastructure.
The `add_session_metadata` processor for Auditd Manager powers the [Session View](https://www.elastic.co/guide/en/security/current/session-view.html) utility for the Elastic Security Platform.

### Enabling Session Data Capture

There are two ways to enable session data capture for the Session View feature:

#### Method 1: Using the Toggle Switch (Recommended)

1. Navigate to the Auditd Manager integration configuration in Kibana.
2. Locate the "Session data" toggle switch.
3. Turn the switch on to enable session data capture.

#### Method 2: Manual Configuration
To enable the `add_session_metadata` processor for Auditd Manager:

1. Navigate to the Auditd Manager integration configuration in Kibana.
2. Add the `add_session_metadata` processor configuration under the **Processors** section of Advanced options.
Expand All @@ -39,13 +29,6 @@ There are two ways to enable session data capture for the Session View feature:

Changes are applied automatically, and you do not have to restart the service.

### Important Notes

- Using the toggle switch (Method 1) automatically applies these configurations, making it the simpler option for most users.
- When enabling session data capture, be aware that it will collect extended process data, which may have privacy and storage implications.
- You can disable session data capture at any time by turning off the toggle switch or removing the manual configurations.
- If you switch between methods or disable the feature, ensure that any conflicting configurations are removed to avoid unexpected behaviour.

## How it works

This integration establishes a subscription to the kernel to receive the events
Expand Down
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.18.1"
changes:
- description: "Reverting Session data option"
type: bugfix
link: https://github.com/elastic/integrations/issues/11420
- version: "1.18.0"
changes:
- description: "Added Session data option"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,18 +7,9 @@ socket_type: '{{socket_type}}'
immutable: {{immutable}}
resolve_ids: {{resolve_ids}}
failure_mode: {{failure_mode}}
{{#if session_data}}
audit_rules: "{{escape_multiline_string audit_rules}}
{{escape_multiline_string "
# Session data audit rules
-a always,exit -F arch=b64 -S execve,execveat -k exec
-a always,exit -F arch=b64 -S exit_group
-a always,exit -F arch=b64 -S setsid"}}"
{{else}}
{{#if audit_rules}}
audit_rules: {{escape_string audit_rules}}
{{/if}}
{{/if}}
{{#if audit_rule_files.length}}
audit_rule_files:
{{#each audit_rule_files as |file|}}
Expand All @@ -42,12 +33,4 @@ publisher_pipeline.disable_host: true
{{#if processors}}
processors:
{{processors}}
{{#if session_data}}
{{session_data_processors}}
{{/if}}
{{else}}
{{#if session_data}}
processors:
{{session_data_processors}}
{{/if}}
{{/if}}
24 changes: 0 additions & 24 deletions packages/auditd_manager/data_stream/auditd/manifest.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,19 +33,6 @@ streams:
If `auto` is selected, `elastic-agent` will attempt to use multicast sockets, falling
back to unicast if multicast is not available.
- name: session_data
type: bool
title: Session data
show_user: true
multi: false
default: false
description: |
Turn this on to capture the extended process data required for Session View.
Session View provides you a visual representation of session and process execution data.
Session View data is organized according to the Linux process model to help you
investigate process, user, and service activity on your Linux infrastructure.
[Learn more](https://www.elastic.co/guide/en/security/current/session-view.html)
- name: immutable
type: bool
title: Immutable
Expand Down Expand Up @@ -190,14 +177,3 @@ streams:
description: |
Processors are used to reduce the number of fields in the exported event or to enhance the event with metadata.
This executes in the agent before the logs are parsed. See [Processors](https://www.elastic.co/guide/en/beats/filebeat/current/filtering-and-enhancing-data.html) for details.
- name: session_data_processors
type: yaml
title: Session data processors
required: false
show_user: false
multi: false
description: |
These processors will be appended to the processors configuration if Session Data is enabled.
default: >2-
- add_session_metadata:
backend: "auto"
23 changes: 3 additions & 20 deletions packages/auditd_manager/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,21 +5,11 @@ is a part of the Linux kernel.

This integration is available only for Linux.

## Session View powered by Auditd Manager
## Session View powered by Auditd Manager [BETA]

The Auditd Manager is one of the integrations that can power the [Session View](https://www.elastic.co/guide/en/security/current/session-view.html) utility for the Elastic Security Platform. This feature provides a visual representation of session and process execution data, organized according to the Linux process model to help you investigate process, user, and service activity on your Linux infrastructure.
The `add_session_metadata` processor for Auditd Manager powers the [Session View](https://www.elastic.co/guide/en/security/current/session-view.html) utility for the Elastic Security Platform.

### Enabling Session Data Capture

There are two ways to enable session data capture for the Session View feature:

#### Method 1: Using the Toggle Switch (Recommended)

1. Navigate to the Auditd Manager integration configuration in Kibana.
2. Locate the "Session data" toggle switch.
3. Turn the switch on to enable session data capture.

#### Method 2: Manual Configuration
To enable the `add_session_metadata` processor for Auditd Manager:

1. Navigate to the Auditd Manager integration configuration in Kibana.
2. Add the `add_session_metadata` processor configuration under the **Processors** section of Advanced options.
Expand All @@ -39,13 +29,6 @@ There are two ways to enable session data capture for the Session View feature:

Changes are applied automatically, and you do not have to restart the service.

### Important Notes

- Using the toggle switch (Method 1) automatically applies these configurations, making it the simpler option for most users.
- When enabling session data capture, be aware that it will collect extended process data, which may have privacy and storage implications.
- You can disable session data capture at any time by turning off the toggle switch or removing the manual configurations.
- If you switch between methods or disable the feature, ensure that any conflicting configurations are removed to avoid unexpected behaviour.

## How it works

This integration establishes a subscription to the kernel to receive the events
Expand Down
4 changes: 2 additions & 2 deletions packages/auditd_manager/manifest.yml
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
format_version: "3.0.0"
name: auditd_manager
title: "Auditd Manager"
version: "1.18.0"
version: "1.18.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:
- security
- auditd
conditions:
kibana:
version: "^8.16.0 || ^9.0.0"
version: "^8.16.0"
screenshots:
- src: /img/overview.png
title: Overview Dashboard
Expand Down

0 comments on commit c76f80f

Please sign in to comment.