| ID | Technique | Tactic |
|---|---|---|
| T1552.003 | Shell History | Credential Access |
Detection: Linux Shell History Access Via Command Line Utility
Description
The following analytic detects attempts to read shell history files (bash, zsh, fish, etc.). A history file is a log file that records all the commands executed in a shell on a Linux or Unix-based operating system. A malicious actor who gains access to a user's shell history file can potentially obtain sensitive information and use it to compromise the user's system and data.
Search
1
2| tstats `security_content_summariesonly`
3 count min(_time) as firstTime
4 max(_time) as lastTime
5
6from datamodel=Endpoint.Processes where
7
8Processes.process_name IN (
9 "cat",
10 "fmt",
11 "head",
12 "less",
13 "more",
14 "nano",
15 "sort",
16 "tail",
17 "uniq",
18 "vi",
19 "vim"
20)
21Processes.process IN (
22 "*.bash_history*",
23 "*.history*",
24 "*.sh_history*",
25 "*.zhistory*",
26 "*.zsh_history*",
27 "*fish_history*"
28)
29
30by Processes.process Processes.vendor_product Processes.user_id Processes.process_hash
31 Processes.parent_process_name Processes.parent_process_exec Processes.action Processes.dest
32 Processes.process_current_directory Processes.process_path Processes.process_integrity_level
33 Processes.original_file_name Processes.parent_process Processes.parent_process_path
34 Processes.parent_process_guid Processes.parent_process_id Processes.process_guid
35 Processes.process_id Processes.user Processes.process_name
36
37
38| `drop_dm_object_name(Processes)`
39
40| `security_content_ctime(firstTime)`
41
42| `security_content_ctime(lastTime)`
43
44| `linux_shell_history_access_via_command_line_utility_filter`
Data Source
| Name | Platform | Sourcetype | Source |
|---|---|---|---|
| Sysmon for Linux EventID 1 | 'sysmon:linux' |
'Syslog:Linux-Sysmon/Operational' |
Macros Used
| Name | Value |
|---|---|
| security_content_ctime | convert timeformat="%Y-%m-%dT%H:%M:%S" ctime($field$) |
| linux_shell_history_access_via_command_line_utility_filter | search * |
linux_shell_history_access_via_command_line_utility_filter is an empty macro by default. It allows the user to filter out any results (false positives) without editing the SPL.
Annotations
Default Configuration
This detection is configured by default in Splunk Enterprise Security to run with the following settings:
| Setting | Value |
|---|---|
| Disabled | true |
| Cron Schedule | 0 * * * * |
| Earliest Time | -70m@m |
| Latest Time | -10m@m |
| Schedule Window | auto |
| Creates Finding (Notable) | No |
| Creates Intermediate Finding (Risk Event) | Yes |
Implementation
The detection is based on data that originates from Endpoint Detection and Response (EDR) agents. These agents are designed to provide security-related telemetry from the endpoints where the agent is installed. To implement this search, you must ingest logs that contain the process GUID, process name, and parent process. Additionally, you must ingest complete command-line executions. These logs must be processed using the appropriate Splunk Technology Add-ons that are specific to the EDR product. The logs must also be mapped to the Processes node of the Endpoint data model. Use the Splunk Common Information Model (CIM) to normalize the field names and speed up the data modeling process.
Known False Positives
Legitimate system administrators and automated scripts may access shell history files for auditing or troubleshooting purposes. Filter based on known administrative accounts and approved tooling in your environment.
Associated Analytic Story
Intermediate Findings
| Message | Entity Field | Entity Type | Risk Score |
|---|---|---|---|
| Potential shell history access [$process$] by [$user$] on [$dest$] via [$process_name$]. | dest | system | 20 |
| Potential shell history access [$process$] by [$user$] on [$dest$] via [$process_name$]. | user | user | 20 |
Threat Objects
| Field | Type |
|---|---|
| process_name | process_name |
Detection Testing
| Test Type | Status | Dataset | Source | Sourcetype |
|---|---|---|---|---|
| Validation | ✅ Passing | N/A | N/A | N/A |
| Unit | ✅ Passing | Dataset | Syslog:Linux-Sysmon/Operational |
sysmon:linux |
| Integration | ✅ Passing | Dataset | Syslog:Linux-Sysmon/Operational |
sysmon:linux |
Replay any dataset to Splunk Enterprise by using our replay.py tool or the UI.
Alternatively you can replay a dataset into a Splunk Attack Range
Source: GitHub |
Version: 1