Tagging Rules
Plaso provides various configuration files for the tagging analysis plugin.
Linux tagging rules
The Linux tagging rules are stored in the file: tag_linux.txt
The sections below provide more context regarding specific tagging rules.
application_execution
This rule tags application execution events on Linux, which are defined as:
a command from bash history
a Docker file system layer event
a command from fish history
a SELinux log line where the audit type is “EXECVE” or “USER_CMD”
a command from zsh history
a syslog line that indicates a cron task was run, for example:
Mar 11 00:00:00 ubuntu2015 CRON[3]: (root) CMD (touch /tmp/afile.txt)
a syslog line from sudo that contains “COMMAND=”
a syslog line from CROND that contains “CMD”
login
This rule tags log-in events on Linux, which are defined as:
a utmp event with login type 7 (a user process)
a SELinux log line where the audit type is “LOGIN”
a SELinux log line where the audit type is “USER_LOGIN” and the operation result is success (”res=success”), for example:
type=USER_LOGIN msg=audit(1789331920.280:298): pid=1611 uid=0 auid=0 ses=7 subj=system_u:system_r:sshd_session_t:s0-s0:c0.c1023 msg='op=login id=0 exe="/usr/libexec/openssh/sshd-session" hostname=? addr=192.168.1.13 terminal=ssh res=success'
a syslog line from login that contains “logged in”, “ROOT LOGIN” or “session opened”
a syslog line from sshd or sshd-session that contains “session opened” or “Starting session”, for example:
2026-09-13T20:58:32.613518+00:00 ubuntu-26-parsers sshd-session[18413]: pam_unix(sshd:session): session opened for user ubuntu(uid=1000) by ubuntu(uid=0)
a syslog line from sshd or sshd-session that indicates a successful authentication, for example:
2026-09-13T20:58:32.606882+00:00 ubuntu-26-parsers sshd-session[18413]: Accepted password for ubuntu from 192.168.1.13 port 61364 ssh2
a syslog line from dovecot that contains “imap-login: Login:”
a syslog line from postfix/submission/smtpd that contains “sasl_”
a vsftpd log line that contains “OK LOGIN”, for example:
Sun Sep 13 21:38:56 2026 [pid 42321] [john.doe] OK LOGIN: Client "::ffff:127.0.0.1"
login_failed
This rule tags failed log-in events on Linux, which are defined as:
a SELinux log line where the audit type is “ANOM_LOGIN_FAILURES”
a SELinux log line where the audit type is “USER_LOGIN” and the operation result is failed (”res=failed”)
a SELinux log line where the audit type is “USER_AUTH” and the operation result is failed (”res=failed”), for example:
type=USER_AUTH msg=audit(1789331921.882:317): pid=1681 uid=1001 auid=0 ses=7 subj=unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023 msg='op=PAM:authentication grantors=? acct="root" exe="/usr/bin/su" hostname=localhost.localdomain addr=? terminal=/dev/pts/0 res=failed'
a syslog line that contains “pam_tally2”
a syslog line from sshd, sshd-session, login, postfix/submission/smtpd or sudo that contains “uthentication fail”, which matches both “authentication failure” and “Authentication failed”
a syslog line from sshd or sshd-session that contains “Access denied for user” or “not allowed because”
a syslog line from sshd or sshd-session that indicates a failed authentication, for example:
2026-09-13T21:02:45.907303+00:00 ubuntu-26-parsers sshd-session[21146]: Failed password for john.doe from 192.168.1.138 port 39144 ssh2
a syslog line from sshd or sshd-session that records an authentication request for a user name that does not exist, for example:
2026-10-08T00:19:26.539626+00:00 ubuntu sshd-session[3824]: Invalid user john doe from 192.168.248.1 port 54928
a syslog line from xscreensaver or login that contains “FAILED LOGIN”
a syslog line from su that contains “DENIED”
a syslog line from su that contains “FAILED SU”, for example:
Sep 13 15:38:44 localhost su[1681]: FAILED SU (to root) john.doe on pts/0
a syslog line from nologin
a vsftpd log line that contains “FAIL LOGIN”, for example:
Sun Sep 13 21:38:48 2026 [pid 42238] [john.doe] FAIL LOGIN: Client "::ffff:127.0.0.1"
useradd
This rule tags user account creation events on Linux, which are defined as:
a syslog line from useradd that contains “new user”
a SELinux log line where the audit type is “ADD_USER”
groupadd
This rule tags group creation events on Linux, which are defined as:
a syslog line from useradd that contains “new group”
a syslog line from groupadd
a SELinux log line where the audit type is “ADD_GROUP”
userdel
This rule tags user account removal events on Linux, which are defined as:
a syslog line from userdel that contains “delete user”
a SELinux log line where the audit type is “DEL_USER”
groupdel
This rule tags group removal events on Linux, which are defined as:
a syslog line from userdel that contains “removed group”
a syslog line from groupdel
a SELinux log line where the audit type is “DEL_GROUP”
firewall_change
This rule tags netfilter (firewall) configuration change events on Linux, which are defined as:
a SELinux log line where the audit type is “NETFILTER_CFG”
logout
This rule tags log-out events on Linux, which are defined as:
a utmp event of type DEAD_PROCESS (8) with a terminal and a process identifier, which also matches the gettys that init stops during a shutdown or reboot
a syslog line from login that contains “session closed”
a syslog line from sshd or sshd-session that contains “session closed” or “Close session”
a syslog line from systemd-logind that contains “logged out”
a syslog line from dovecot that contains “Logged out”
a SELinux log line where the audit type is “USER_LOGOUT”
a syslog line from sshd or sshd-session that records the end of a connection of an authenticated user, for example:
2026-10-08T00:19:28.778673+00:00 ubuntu sshd-session[3884]: Disconnected from user ubuntu fe80::621:e520:10d6:6621%ens36 port 54931
session_start
This rule tags user session start events on Linux, which are defined as:
a syslog line from systemd-logind that contains “New session”, for example:
2026-09-13T20:58:32.623329+00:00 ubuntu-26-parsers systemd-logind[1697]: New session '3' of user 'ubuntu' with class 'user' and type 'tty'.
a SELinux log line where the audit type is “USER_START”
session_stop
This rule tags user session stop events on Linux, which are defined as:
a syslog line from systemd-logind that contains “Removed session”, for example:
2026-09-13T20:58:33.933089+00:00 ubuntu-26-parsers systemd-logind[1697]: Removed session 3.
a SELinux log line where the audit type is “USER_END”
boot
This rule tags system boot events on Linux, which are defined as:
a utmp event with login type 2 (a boot time), a terminal of “system boot” and the user name “reboot”
a SELinux log line where the audit type is “SYSTEM_BOOT”
shutdown
This rule tags system shutdown events on Linux, which are defined as:
a utmp event with login type 1 (a run level change), a terminal of “~~” or “system boot” and the user name “shutdown”
a SELinux log line where the audit type is “SYSTEM_SHUTDOWN”
a syslog line from systemd-logind that contains “System is powering down”, “System is rebooting” or “System is halting”, for example:
Sep 13 16:39:16 localhost systemd-logind[1117]: System is rebooting.
runlevel
This rule tags system run level change events on Linux, which are defined as:
a utmp event with login type 1 (a run level change) and the user name “runlevel”
a SELinux log line where the audit type is “SYSTEM_RUNLEVEL”
device_connection
This rule tags device connection events on Linux, which are defined as:
a syslog line from kernel that contains “New USB device found”
device_disconnection
This rule tags device disconnection events on Linux, which are defined as:
a syslog line from kernel that contains “USB disconnect”
application_install
This rule tags application installation events on Linux, which are defined as:
a dpkg log line that contains “status installed”
an APT history log entry where the command is “Install”, for example:
Commandline: apt-get install -y -q vsftpd
Requested-By: ubuntu (1000)
Install: ssl-cert:amd64 (1.1.3ubuntu2, automatic), vsftpd:amd64 (3.0.5-0.4)
service_start
This rule tags service start events on Linux, which are defined as:
a SELinux log line where the audit type is “SERVICE_START”
service_stop
This rule tags service stop events on Linux, which are defined as:
a SELinux log line where the audit type is “SERVICE_STOP”
promiscuous
This rule tags network interface promiscuous mode change events on Linux, which are defined as:
a SELinux log line where the audit type is “ANOM_PROMISCUOUS”
a syslog line from kernel that contains “promiscuous mode”
crash
This rule tags crash events on Linux, which are defined as:
a SELinux log line where the audit type is “ANOM_ABEND”
a syslog line from kernel that contains “segfault”
MacOS tagging rules
The MacOS tagging rules are stored in the file: tag_macos.txt
The sections below provide more context regarding specific tagging rules.
application_execution
This rule tags application execution events on MacOS, which are defined as:
a MacOS application usage database entry
a syslog line that contains “COMMAND=/bin/launchctl”
application_install
This rule tags application installation events on MacOS, which are defined as:
a plist key event of the “plist_install_history” plugin
autorun
This rule tags auto run events on MacOS, which are defined as:
a file system creation time event of a file with “LaunchAgents” as a path segment and a filename that contains “.plist”
file_download
This rule tags file download events on MacOS, which are defined as:
a Chrome history file downloaded event
a MacOS launch services quarantine event
an event with the timestamp description “Downloaded Time”
device_connection
This rule tags device connection events on MacOS, which are defined as:
an iPod device entry
a plist key event of the “plist_airport” plugin
document_print
This rule tags document print events on MacOS, which are defined as:
an OLE compound file summary information last printed time event
Windows tagging rules
The Windows tagging rules are stored in the file: tag_windows.txt
The sections below provide more context regarding specific tagging rules.
application_execution
This rule tags application execution events on Windows, which are defined as:
a file system event of a file with “Windows/Tasks/At” as path segments
a Windows EventLog (EVT) record of source Security with event identifier 592
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Security-Auditing with event identifier 4688
a Windows XML EventLog (EVTX) record with the strings “user mode service” and “demand start”
a Windows Shortcut (LNK) file with a filename that contains “Recent” and of which the local, network or relative path contains “.exe”
a Windows Prefetch execution event
a Windows Application Compatibility Cache Registry entry
a Windows MRUList or MRUListEx Registry entry that contains “.exe”
a Windows UserAssist Registry value of which the name contains “.exe”
a Windows Scheduled Task job
application_install
This rule tags application installation events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Application-Experience with event identifier 903 or 904
application_update
This rule tags application update events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Application-Experience with event identifier 905
application_removal
This rule tags application removal events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Application-Experience with event identifier 907 or 908
document_open
This rule tags document open events on Windows, which are defined as:
a Windows BagMRU (or ShellBags) Registry entry
a Windows MRUList or MRUListEx Registry entry that does not contain “.exe” and has a timestamp later than the POSIX epoch
a Microsoft Office MRU Registry entry
login_failed
This rule tags failed log-in events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Security-Auditing with event identifier 4625
login_attempt
This rule tags log-in attempt events on Windows, which are defined as:
a Windows EventLog (EVT) record of source Security with event identifier 540
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Security-Auditing with event identifier 4624
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TerminalServices-LocalSessionManager with event identifier 21 or 1101
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TerminalServices-RemoteConnectionManager with event identifier 1147 or 1149
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-User Profiles Service with event identifier 2
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Winlogon with event identifier 7001
logoff
This rule tags log-off events on Windows, which are defined as:
a Windows EventLog (EVT) record of source Security with event identifier 538
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Security-Auditing with event identifier 4634
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TerminalServices-LocalSessionManager with event identifier 23 or 1103
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-User Profiles Service with event identifier 4
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Winlogon with event identifier 7002
session_disconnection
This rule tags Terminal Services session disconnection events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TerminalServices-LocalSessionManager with event identifier 24
session_reconnection
This rule tags Terminal Services session reconnection events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TerminalServices-LocalSessionManager with event identifier 25 or 1105
shell_start
This rule tags Terminal Services shell start events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TerminalServices-LocalSessionManager with event identifier 22 or 1102
task_schedule
This rule tags scheduled task creation events on Windows, which are defined as:
a Windows EventLog (EVT) record of source Security with event identifier 602
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Security-Auditing with event identifier 4698
job_success
This rule tags Task Scheduler successfully completed job events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TaskScheduler with event identifier 102
action_success
This rule tags Task Scheduler successfully completed action events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-TaskScheduler with event identifier 201
name_resolution_timeout
This rule tags DNS name resolution timeout events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-DNS-Client with event identifier 1014
time_change
This rule tags system time change events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Kernel-General with event identifier 1
shutdown
This rule tags system shutdown events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Kernel-General with event identifier 13
system_start
This rule tags system start events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Kernel-General with event identifier 12
system_sleep
This rule tags system sleep events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Kernel-Power with event identifier 42
autorun
This rule tags auto run events on Windows, which are defined as:
a Windows Boot Execute Registry value that contains “.exe” or “.dll”
a Windows boot verification Registry value of which the image path contains “.exe” or “.dll”
a Windows Run or RunOnce Registry entry that contains “.exe” or “.dll”
file_download
This rule tags file download events on Windows, which are defined as:
a Chrome history file downloaded event
an event with the timestamp description “Downloaded Time”
document_print
This rule tags document print events on Windows, which are defined as:
an OLE compound file summary information last printed time event
firewall_change
This rule tags Windows Firewall With Advanced Security change events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Windows Firewall With Advanced Security with event identifier 2003, 2004, 2005 or 2006
system_wake
This rule tags system wake events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Power-Troubleshooter, or provider identifier {cdc05e28-c449-49c6-b9d2-88cf761644df}, with event identifier 1
registry_modified
This rule tags Windows Registry modification events, which are defined as:
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Security-Auditing with event identifier 4657, which indicates a registry value was modified
service_new
This rule tags service creation events on Windows, which are defined as:
a Windows XML EventLog (EVTX) record of source Service Control Manager with event identifier 7045, which indicates a new service was installed
eventlog_cleared
This rule tags event log cleared events on Windows, which are defined as:
a Windows EventLog (EVT) record of source Security with event identifier 517
a Windows XML EventLog (EVTX) record of source Microsoft-Windows-Eventlog with event identifier 104 or 1102