最佳实践 Linux Auditd 规则集,包含 14,956 条映射到 MITRE ATT&CK 的规则、Ansible 部署角色,以及用于安全监控和合规审计的 lint/测试工具。
English · Deutsch · Français · Español · Italiano
本仓库提供 Linux 审计守护进程(Auditd)配置与部署的全面最佳实践,包括一套广泛的安全导向审计规则、用于自动化部署的 Ansible 角色,以及在真实内核上测试这些规则的工具。
规则集、角色和测试的变更记录在 CHANGELOG.md 中。
Auditd 是一个强大的 Linux 审计系统,提供全面的系统监控和日志记录能力。它旨在跟踪与安全相关的事件,对于以下方面至关重要:
我们全面的审计规则(/ndaal/audit_best_practices.rules 或 /dataset/audit_best_practices.rules)旨在满足多种安全标准和最佳实践,包括:
| 文件 | 内容 |
|---|---|
dataset/audit_best_practices.rules | 主规则集:14,956 条活动规则,包含 903 个键,以 arch=b32/arch=b64 成对形式编写。这是 Ansible 角色下载的文件。 |
dataset/audit_best_practices_high_volume.rules | 配套文件,包含未经过滤的集合:非系统用户的每次 execve、kill/tkill/tgkill 以及出站 connect。其中的每条规则都被注释掉,因此该文件默认关闭。其文件头说明了如何一次启用一个块。 |
ndaal/ | 两个文件的字节级完全相同副本。 |
*.rules.sha-256 | sha256sum 格式的 SHA-256 校验文件。Ansible 角色会对照它们检查每次下载。编辑规则文件后,运行 tools/update_rules_checksums.sh 重新生成它们。 |
tools/key-decisions.tsv | 每个键冲突对对应一项决策,由 tools/resolve_key_collisions.py 应用。 |
经测量证明有误的规则会被注释掉,并附上注明日期的说明给出原因。不会删除任何内容,因此文件保留了每项决策的历史。
以技术 ID 开头的键遵循 MITRE ATT&CK Enterprise 19.2。ATT&CK v19 撤销了该文件曾使用的六个 ID。2026-09-27,它们的键被重命名为 MITRE 为其指定的后继名称。请更改所有使用旧键的 SIEM 查询和告警:
| 旧键 | 新键 |
|---|---|
T1562.001_Impair_Defenses_Disable_or_Modify_Tools | T1685_Disable_or_Modify_Tools |
T1562.004_Impair_Defenses_Disable_or_Modify_System_Firewall | T1686_Disable_or_Modify_System_Firewall |
T1070.002_Indicator_Removal_Clear_Linux_or_Mac_System_Logs | T1685.006_Disable_or_Modify_Tools_Clear_Linux_or_Mac_System_Logs |
T1107_File_Deletion | T1070.004_Indicator_Removal_File_Deletion |
T1169_Sudo | T1548.003_Abuse_Elevation_Control_Mechanism_Sudo_and_Sudo_Caching |
T1079_Multilayer_Encryption | T1573_Encrypted_Channel |
对 /var/log/audit/ 的监视使用 T1685.004_Disable_or_Modify_Tools_Disable_or_Modify_Linux_Audit_System_Log,即针对审计日志本身的 v19 子技术,而不是 T1685.006。重命名之前编写的注明日期的说明,以及它们所解释的被注释掉的规则,保留旧名称。
同样在 2026-09-27,命名了错误技术的键得到了更正。请同时更改这些规则的 SIEM 查询和告警:
| 规则 | 旧键 | 新键 |
|---|---|---|
对 /etc/passwd 的写入和属性更改(新增的一对;读取仍保留 T1087) | T1087_Account_Discovery | T1098_Account_Manipulation |
对 /etc/shadow 的写入和属性更改 | T1087_Account_Discovery | T1098_Account_Manipulation |
有人读取 /etc/shadow | T1087_Account_Discovery | T1003.008_OS_Credential_Dumping_etc_passwd_and_etc_shadow |
/etc/ssh/sshd_config | T1021_Remote_Services | T1021.004_Remote_Services_SSH |
/root/.ssh/authorized_keys | T1021_Remote_Services | T1098.004_Account_Manipulation_SSH_Authorized_Keys |
/etc/systemd/system/ | T1053.006_Scheduled_Task_Systemd_Timers | T1543.002_Create_or_Modify_System_Process_Systemd_Service |
date | T1083_File_and_Directory_Discovery | T1124_System_Time_Discovery |
| Python 解释器(pip、pipx、conda 和 npm 保留 T1072) | T1072_Software_Deployment_Tools | T1059.006_Command_and_Scripting_Interpreter_Python |
| 由人运行的 mysql 和 psql | T1213_002_database_access | T1213.006_Data_from_Information_Repositories_Databases |
对 /etc/group 的写入和属性更改 | T1087_Account_Discovery | T1098_Account_Manipulation |
对 /etc/gshadow 的写入和属性更改(新增的一对;读取仍保留 T1087) | T1087_Account_Discovery | T1098_Account_Manipulation |
/usr/lib/systemd/system/(/run/systemd/transient/ 保留 T1053.006) | T1053.006_Scheduled_Task_Systemd_Timers | T1543.002_Create_or_Modify_System_Process_Systemd_Service |
/home/vagrant/.ssh/authorized_keys | T1021_Remote_Services | T1098.004_Account_Manipulation_SSH_Authorized_Keys |
写入 /var/log/tomcat10/,64 位(一处拼写错误) | tomcattomcat | tomcat |
写入 /etc/mandiant/,32 位(一处拼写错误) | mmandiant_config | mandiant_config |
unix_chkpwd 是 sudo 和屏幕锁的密码校验程序,它以该人员的审计 ID 读取 /etc/shadow,因此每次密码校验现在都会以 T1003.008 出现。在用于凭据转储的 SIEM 规则中过滤 exe=/usr/sbin/unix_chkpwd。其余 34 条规则使用 T1234_567 形式的键,它们从未标记过任何记录,因为更早的一条规则匹配了相同的事件。这些规则已被注释掉,并附有指明该规则的说明。
kexec_load、capset、perf_event_open 和 semtimedop_time64 的 32 位调用现在携带 KEXEC、capability_change_ebpf、perf_event_ebpf 和 T1559_Inter-Process_Communication,而不再是 32bit_abi。针对整个数据目录的 elasticsearch-data 监视在两种 ABI 上均已关闭:其警告使其变为需显式启用。在 64 位主机上,此前一直沿用的 elasticsearch-nodes 和 elasticsearch-data-deletion 键会再次出现。
内核会附加最早加载且匹配某事件的规则的键。这对系统调用规则和路径监视同样适用(kernel/auditfilter.c、kernel/auditsc.c)。因此,放在前面的宽泛规则会从其后所有具体规则那里夺走键。直到 2026-09-20,未过滤的 procmon execve 规则一直位于第 1,575 行,导致 368 个键从未出现在任何记录上。
现在,兜底规则按以下顺序放在文件末尾:
user_exec:登录会话(auid>=500、auid!=-1)中所有未被任何监视规则和提权规则认领的 execveprocmon:所有剩余的 execve(守护进程、cron、启动)setres*/setfs*、stime 和 32 位 umount 规则network_changes(每个 socket 和 setsockopt)和 elasticsearch-bind-success(每次成功的 bind)32bit_abi:针对 arch=b32 的 -S all,始终是文件中最后一条 -a 规则所有新规则都应添加在此块之上。tools/auditd-rules-lint.sh 会在兜底规则上移的文件上失败:它会报告键遮蔽,以及不是最后一条的 -S all 规则。
同一条规则决定由谁为一次安装打标签。安装以 root 身份运行,而特权命令部分的 euid=0 和 auid!=uid execve 规则会捕获每一次 root 执行(T1548.001)。因此,包管理器(rpm、dnf、YaST/Zypper、dpkg 和 APT、Pacman、APK)位于该部分之上,与 Ceph 块类似:一次安装会带上 T1072_Software_Deployment_Tools,而记录中仍会显示 euid=0 以及操作者的审计 ID。在 2026-09-27 之前,它们位于该部分之下,因此从不为安装打标签。pip、conda 和 npm 仍位于其下:Python 部分还会监视解释器,而放在上面的话,解释器监视会给 root 运行的每个 Python 脚本都打上标签。
系统调用参数很容易被误读。在 bind() 中,a0 是文件描述符,而不是端口。原先 42 条 bind -F a0=<port> 规则匹配的是描述符编号,因此它们已被禁用。
T1068_Exploitation_for_Privilege_Escalation_AF_ALG:
socket,a0=38(AF_ALG)bind,a2=88(sockaddr_alg 的大小)setsockopt,a1=279(SOL_ALG)-S splice -F a0=0x3 -F a2=0x5 -F a3=0x0,键为 dirtypipe_CVE-2022-0847-S splice -F a1!=0,键为 T1068_Exploitation_for_Privilege_Escalation_splice_file_to_pipe。它捕获以显式偏移量将文件复制到管道中的行为,无论描述符编号是什么。user_exec(见上文)。它将登录会话与守护进程区分开。记录数量保持不变。sbom_tools Ansible 角色的基于路径的规则(syft、cdxgen、cargo-sbom、tern、grype、trivy、osv-scanner、bomber、bitvex、bomdrift、shieldbom、inspektr_cli、provenant、ORT,以及 jaq 和 sha3sum),采用该角色的默认布局:
/opt/ndaal/sbom-tools/bin、/usr/local/bin 或 /usr/bin 执行每个工具(T1518.001_Security_Software_Discovery)T1554_Compromise_Host_Software_Binary)以及对其配置的写入(T1685_Disable_or_Modify_Tools)T1565.001…)T1070.004…),以及由人员读取 SBOM 和报告(T1005…)