Skip to content

Commit e393772

Browse files
AegrahAegrah
committed
[New/Tuning] Linux Tunneling Rules
1 parent fcb6c3c commit e393772

File tree

2 files changed

+189
-4
lines changed

2 files changed

+189
-4
lines changed

‎rules/linux/command_and_control_linux_tunneling_and_port_forwarding.toml‎

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
[metadata]
22
creation_date = "2023/08/23"
3-
integration = ["endpoint", "crowdstrike", "sentinel_one_cloud_funnel"]
3+
integration = ["endpoint", "crowdstrike", "sentinel_one_cloud_funnel", "auditd_manager"]
44
maturity = "production"
5-
updated_date = "2025/06/30"
5+
updated_date = "2025/12/12"
66

77
[transform]
88
[[transform.osquery]]
@@ -44,6 +44,8 @@ index = [
4444
"logs-crowdstrike.fdr*",
4545
"logs-endpoint.events.process*",
4646
"logs-sentinel_one_cloud_funnel.*",
47+
"auditbeat-*",
48+
"logs-auditd_manager.auditd-*",
4749
]
4850
language = "eql"
4951
license = "Elastic License v2"
@@ -84,6 +86,7 @@ This rule looks for several utilities that are capable of setting up tunnel netw
8486
8587
### Related rules
8688
89+
- Potential Linux Tunneling and/or Port Forwarding via Command Line - 8c8df61f-ed2a-4832-87b8-ee30812606e0
8790
- Potential Protocol Tunneling via Chisel Client - 3f12325a-4cc6-410b-8d4c-9fbbeb744cfd
8891
- Potential Protocol Tunneling via Chisel Server - ac8805f6-1e08-406c-962e-3937057fa86f
8992
- Potential Protocol Tunneling via EarthWorm - 9f1c4ca3-44b5-481d-ba42-32dc215a2769
@@ -152,13 +155,14 @@ tags = [
152155
"Data Source: Elastic Endgame",
153156
"Data Source: Crowdstrike",
154157
"Data Source: SentinelOne",
158+
"Data Source: Auditd Manager",
155159
"Resources: Investigation Guide",
156160
]
157161
timestamp_override = "event.ingested"
158162
type = "eql"
159163

160164
query = '''
161-
process where host.os.type == "linux" and event.type == "start" and event.action in ("exec", "exec_event", "start", "ProcessRollup2") and (
165+
process where host.os.type == "linux" and event.type == "start" and event.action in ("exec", "exec_event", "start", "ProcessRollup2", "executed", "process_started") and (
162166
(
163167
// gost & pivotnacci - spawned without process.parent.name
164168
(process.name == "gost" and process.args : ("-L*", "-C*", "-R*")) or (process.name == "pivotnacci")) or (
@@ -172,7 +176,7 @@ process where host.os.type == "linux" and event.type == "start" and event.action
172176
// chisel
173177
(process.name : "chisel*" and process.args in ("client", "server")) or
174178
// iodine(d), dnscat, hans, ptunnel-ng, ssf, 3proxy & ngrok
175-
(process.name in ("iodine", "iodined", "dnscat", "hans", "hans-ubuntu", "ptunnel-ng", "ssf", "3proxy", "ngrok"))
179+
(process.name in ("iodine", "iodined", "dnscat", "hans", "hans-ubuntu", "ptunnel-ng", "ssf", "3proxy", "ngrok", "wstunnel"))
176180
) and process.parent.name in ("bash", "dash", "ash", "sh", "tcsh", "csh", "zsh", "ksh", "fish")
177181
)
178182
'''

‎rules/linux/command_and_control_potential_tunneling_command_line.toml‎

Lines changed: 181 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,181 @@
1+
[metadata]
2+
creation_date = "2025/12/12"
3+
integration = ["endpoint", "crowdstrike", "sentinel_one_cloud_funnel", "auditd_manager"]
4+
maturity = "production"
5+
updated_date = "2025/12/12"
6+
7+
[transform]
8+
[[transform.osquery]]
9+
label = "Osquery - Retrieve Listening Ports"
10+
query = "SELECT pid, address, port, socket, protocol, path FROM listening_ports"
11+
12+
[[transform.osquery]]
13+
label = "Osquery - Retrieve Open Sockets"
14+
query = "SELECT pid, family, remote_address, remote_port, socket, state FROM process_open_sockets"
15+
16+
[[transform.osquery]]
17+
label = "Osquery - Retrieve Information for a Specific User"
18+
query = "SELECT * FROM users WHERE username = {{user.name}}"
19+
20+
[[transform.osquery]]
21+
label = "Osquery - Investigate the Account Authentication Status"
22+
query = "SELECT * FROM logged_in_users WHERE user = {{user.name}}"
23+
24+
[[transform.osquery]]
25+
label = "Osquery - Retrieve Running Processes by User"
26+
query = "SELECT pid, username, name FROM processes p JOIN users u ON u.uid = p.uid ORDER BY username"
27+
28+
[[transform.osquery]]
29+
label = "Osquery - Retrieve Process Info"
30+
query = "SELECT name, cmdline, parent, path, uid FROM processes"
31+
32+
33+
[rule]
34+
author = ["Elastic"]
35+
description = """
36+
This rule monitors for potential tunneling and/or port forwarding activity on Linux systems via command line utilities. Attackers may use
37+
various tools to create covert communication channels, allowing them to bypass network security measures and maintain persistent access
38+
to compromised systems. By leveraging these utilities, attackers can tunnel traffic through legitimate protocols, making detection more
39+
challenging.
40+
"""
41+
from = "now-9m"
42+
index = [
43+
"endgame-*",
44+
"logs-crowdstrike.fdr*",
45+
"logs-endpoint.events.process*",
46+
"logs-sentinel_one_cloud_funnel.*",
47+
"auditbeat-*",
48+
"logs-auditd_manager.auditd-*",
49+
]
50+
language = "eql"
51+
license = "Elastic License v2"
52+
name = "Potential Linux Tunneling and/or Port Forwarding via Command Line"
53+
note = """## Triage and analysis
54+
55+
### Investigating Potential Linux Tunneling and/or Port Forwarding via Command Line
56+
57+
Attackers can leverage many utilities to clandestinely tunnel network communications and evade security measures, potentially gaining unauthorized access to sensitive systems.
58+
59+
This rule looks for several utilities that are capable of setting up tunnel network communications by analyzing process names or command line arguments.
60+
61+
> **Note**:
62+
> This investigation guide uses the [Osquery Markdown Plugin](https://www.elastic.co/guide/en/security/current/invest-guide-run-osquery.html) introduced in Elastic Stack version 8.5.0. Older Elastic Stack versions will display unrendered Markdown in this guide.
63+
> This investigation guide uses [placeholder fields](https://www.elastic.co/guide/en/security/current/osquery-placeholder-fields.html) to dynamically pass alert data into Osquery queries. Placeholder fields were introduced in Elastic Stack version 8.7.0. If you're using Elastic Stack version 8.6.0 or earlier, you'll need to manually adjust this investigation guide's queries to ensure they properly run.
64+
65+
#### Possible investigation steps
66+
67+
- Identify any signs of suspicious network activity or anomalies that may indicate protocol tunneling. This could include unexpected traffic patterns or unusual network behavior.
68+
- Investigate listening ports and open sockets to look for potential protocol tunneling, reverse shells, or data exfiltration.
69+
- $osquery_0
70+
- $osquery_1
71+
- Identify the user account that performed the action, analyze it, and check whether it should perform this kind of action.
72+
- $osquery_2
73+
- Investigate whether the user is currently logged in and active.
74+
- $osquery_3
75+
- Investigate the script execution chain (parent process tree) for unknown processes. Examine their executable files for prevalence and whether they are located in expected locations.
76+
- $osquery_4
77+
- $osquery_5
78+
- Investigate other alerts associated with the user/host during the past 48 hours.
79+
- If scripts or executables were dropped, retrieve the files and determine if they are malicious:
80+
- Use a private sandboxed malware analysis system to perform analysis.
81+
- Observe and collect information about the following activities:
82+
- Attempts to contact external domains and addresses.
83+
- Check if the domain is newly registered or unexpected.
84+
- Check the reputation of the domain or IP address.
85+
- File access, modification, and creation activities.
86+
87+
### Related rules
88+
89+
- Potential Linux Tunneling and/or Port Forwarding via SSH Option - ef395dff-be12-4a6e-8919-d87d627c2174
90+
- Potential Linux Tunneling and/or Port Forwarding - 6ee947e9-de7e-4281-a55d-09289bdf947e
91+
- Potential Protocol Tunneling via Chisel Client - 3f12325a-4cc6-410b-8d4c-9fbbeb744cfd
92+
- Potential Protocol Tunneling via Chisel Server - ac8805f6-1e08-406c-962e-3937057fa86f
93+
- Potential Protocol Tunneling via EarthWorm - 9f1c4ca3-44b5-481d-ba42-32dc215a2769
94+
- Suspicious Utility Launched via ProxyChains - 6ace94ba-f02c-4d55-9f53-87d99b6f9af4
95+
- ProxyChains Activity - 4b868f1f-15ff-4ba3-8c11-d5a7a6356d37
96+
97+
### False positive analysis
98+
99+
- If this activity is related to new benign software installation activity, consider adding exceptions — preferably with a combination of user and command line conditions.
100+
- If this activity is related to a system administrator or developer who uses port tunneling/forwarding for benign purposes, consider adding exceptions for specific user accounts or hosts.
101+
- Try to understand the context of the execution by thinking about the user, machine, or business purpose. A small number of endpoints, such as servers with unique software, might appear unusual but satisfy a specific business need.
102+
103+
### Response and remediation
104+
105+
- Initiate the incident response process based on the outcome of the triage.
106+
- Isolate the involved host to prevent further post-compromise behavior.
107+
- If the triage identified malware, search the environment for additional compromised hosts.
108+
- Implement temporary network rules, procedures, and segmentation to contain the malware.
109+
- Stop suspicious processes.
110+
- Immediately block the identified indicators of compromise (IoCs).
111+
- Inspect the affected systems for additional malware backdoors, such as reverse shells, reverse proxies, or droppers, that attackers could use to reinfect the system.
112+
- Remove and block malicious artifacts identified during triage.
113+
- Investigate credential exposure on systems compromised or used by the attacker to ensure all compromised accounts are identified. Reset passwords for these accounts and other potentially compromised credentials, such as email, business systems, and web services.
114+
- Run a full antimalware scan. This may reveal additional artifacts left in the system, persistence mechanisms, and malware components.
115+
- Determine the initial vector abused by the attacker and take action to prevent reinfection through the same vector.
116+
- Leverage the incident response data and logging to improve the mean time to detect (MTTD) and the mean time to respond (MTTR).
117+
"""
118+
references = [
119+
"https://blog.bitsadmin.com/living-off-the-foreign-land-windows-as-offensive-platform",
120+
"https://book.hacktricks.xyz/generic-methodologies-and-resources/tunneling-and-port-forwarding",
121+
"https://github.com/erebe/wstunnel"
122+
]
123+
risk_score = 47
124+
rule_id = "8c8df61f-ed2a-4832-87b8-ee30812606e0"
125+
setup = """## Setup
126+
127+
This rule requires data coming in from Elastic Defend.
128+
129+
### Elastic Defend Integration Setup
130+
Elastic Defend is integrated into the Elastic Agent using Fleet. Upon configuration, the integration allows the Elastic Agent to monitor events on your host and send data to the Elastic Security app.
131+
132+
#### Prerequisite Requirements:
133+
- Fleet is required for Elastic Defend.
134+
- To configure Fleet Server refer to the [documentation](https://www.elastic.co/guide/en/fleet/current/fleet-server.html).
135+
136+
#### The following steps should be executed in order to add the Elastic Defend integration on a Linux System:
137+
- Go to the Kibana home page and click "Add integrations".
138+
- In the query bar, search for "Elastic Defend" and select the integration to see more details about it.
139+
- Click "Add Elastic Defend".
140+
- Configure the integration name and optionally add a description.
141+
- Select the type of environment you want to protect, either "Traditional Endpoints" or "Cloud Workloads".
142+
- Select a configuration preset. Each preset comes with different default settings for Elastic Agent, you can further customize these later by configuring the Elastic Defend integration policy. [Helper guide](https://www.elastic.co/guide/en/security/current/configure-endpoint-integration-policy.html).
143+
- We suggest selecting "Complete EDR (Endpoint Detection and Response)" as a configuration setting, that provides "All events; all preventions"
144+
- Enter a name for the agent policy in "New agent policy name". If other agent policies already exist, you can click the "Existing hosts" tab and select an existing policy instead.
145+
For more details on Elastic Agent configuration settings, refer to the [helper guide](https://www.elastic.co/guide/en/fleet/8.10/agent-policy.html).
146+
- Click "Save and Continue".
147+
- To complete the integration, select "Add Elastic Agent to your hosts" and continue to the next section to install the Elastic Agent on your hosts.
148+
For more details on Elastic Defend refer to the [helper guide](https://www.elastic.co/guide/en/security/current/install-endpoint.html).
149+
"""
150+
severity = "medium"
151+
tags = [
152+
"Domain: Endpoint",
153+
"OS: Linux",
154+
"Use Case: Threat Detection",
155+
"Tactic: Command and Control",
156+
"Data Source: Elastic Defend",
157+
"Data Source: Elastic Endgame",
158+
"Data Source: Crowdstrike",
159+
"Data Source: SentinelOne",
160+
"Data Source: Auditd Manager",
161+
"Resources: Investigation Guide",
162+
]
163+
timestamp_override = "event.ingested"
164+
type = "eql"
165+
query = '''
166+
process where host.os.type == "linux" and event.type == "start" and event.action in ("exec", "exec_event", "start", "ProcessRollup2", "executed", "process_started") and
167+
process.command_line regex """.*[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}:[0-9]{1,5}:[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}:[0-9]{1,5}.*"""
168+
'''
169+
170+
[[rule.threat]]
171+
framework = "MITRE ATT&CK"
172+
173+
[[rule.threat.technique]]
174+
id = "T1572"
175+
name = "Protocol Tunneling"
176+
reference = "https://attack.mitre.org/techniques/T1572/"
177+
178+
[rule.threat.tactic]
179+
id = "TA0011"
180+
name = "Command and Control"
181+
reference = "https://attack.mitre.org/tactics/TA0011/"

0 commit comments

Comments
 (0)