tfsec AWS MQ 安全规则详解:审计日志、通用日志与公网暴露检测
tfsec AWS MQ 安全规则详解:审计日志、通用日志与公网暴露检测
导读
本篇文章以 tfsec 仓库中 MQ 检查索引文档 为核心骨架,系统讲解 tfsec 对 AWS MQ Broker(Amazon MQ 消息代理)的三项内置安全检查:aws-mq-enable-audit-logging、aws-mq-enable-general-logging 与 aws-mq-no-public-access。阅读本文后,你将掌握每项检查的默认严重级别、触发原理、不安全的 Terraform 写法与修复后的安全写法,并了解如何通过 tfsec 的命令行参数落地这些检查到日常的 Terraform 扫描流程中。
检查概览:AWS MQ 的三项安全基线
docs/checks/aws/mq/index.md 是 tfsec 文档体系中按云服务商、按服务分组的导航索引页,它汇总了针对 aws_mq_broker 资源的三项检查。Amazon MQ 是 AWS 托管的 ActiveMQ 与 RabbitMQ 消息代理服务,常见于微服务架构中承担消息队列职责。由于它承载业务消息流,其日志留存与网络暴露面直接关系到安全事件的可追溯性与被攻击风险,因此 tfsec 专门为其设计了如下三项规则:
| 检查 ID(长格式) | 检查项 | 默认严重级别 |
|---|---|---|
aws-mq-enable-audit-logging |
MQ Broker 应启用审计日志(audit logging) | medium(中) |
aws-mq-enable-general-logging |
MQ Broker 应启用通用日志(general logging) | low(低) |
aws-mq-no-public-access |
确保 MQ Broker 不对公网暴露 | high(高) |
三项检查均作用于 aws_mq_broker 资源,分别对应其 logs.audit、logs.general 与 publicly_accessible 属性。从严重级别设计上可以看出 tfsec 的评估思路:公网暴露直接威胁代理安全(高危),审计日志影响事后追踪能力(中危),而通用日志缺失主要影响问题排查(低危)。
检查一:aws-mq-enable-audit-logging(审计日志)
完整规则说明见 enable-audit-logging 检查文档。
默认严重级别:medium(中)
检查理由(Explanation):应启用日志记录,以便更完整地追踪问题与活动并进行调查。日志提供了调查过程中往往极具价值的额外信息与上下文。对于消息代理而言,审计日志记录的是客户端连接、认证等安全相关事件,一旦缺失,攻击行为或异常操作将难以还原。
可能的影响(Possible Impact):没有审计日志,MQ Broker 中的活动很难被追踪。
建议修复(Suggested Resolution):启用 audit logging。
不安全的示例(会触发检查)
以下 Terraform 配置会让 aws-mq-enable-audit-logging 检查失败,关键在于 logs 块中将 audit 显式设为 false:
resource "aws_mq_broker" "bad_example" {
broker_name = "example"
configuration {
id = aws_mq_configuration.test.id
revision = aws_mq_configuration.test.latest_revision
}
engine_type = "ActiveMQ"
engine_version = "5.15.0"
host_instance_type = "mq.t2.micro"
security_groups = [aws_security_group.test.id]
user {
username = "ExampleUser"
password = "MindTheGap"
}
logs {
audit = false
}
}
安全的示例(通过检查)
将 logs 块中的 audit 改为 true 即可通过检查:
resource "aws_mq_broker" "good_example" {
broker_name = "example"
configuration {
id = aws_mq_configuration.test.id
revision = aws_mq_configuration.test.latest_revision
}
engine_type = "ActiveMQ"
engine_version = "5.15.0"
host_instance_type = "mq.t2.micro"
security_groups = [aws_security_group.test.id]
user {
username = "ExampleUser"
password = "MindTheGap"
}
logs {
audit = true
}
}
从这两个示例可以看出,tfsec 对该项的判定逻辑非常简单直接:logs.audit 属性只要被显式设置为 false(或未被设置为 true)即判定为违规,设置为 true 则通过。在 AWS 侧,该属性对应 aws_mq_broker 资源的 logs.audit 配置项,启用后日志会投递至 CloudWatch Logs,便于后续与告警、审计系统联动。
检查二:aws-mq-enable-general-logging(通用日志)
完整规则说明见 enable-general-logging 检查文档。
默认严重级别:low(低)
检查理由(Explanation):应启用日志记录,以便更完整地追踪问题与活动。日志为调查提供额外信息与上下文,对故障定位至关重要。
可能的影响(Possible Impact):没有日志,问题难以追踪。
建议修复(Suggested Resolution):启用 general logging。
不安全的示例(会触发检查)
resource "aws_mq_broker" "bad_example" {
broker_name = "example"
configuration {
id = aws_mq_configuration.test.id
revision = aws_mq_configuration.test.latest_revision
}
engine_type = "ActiveMQ"
engine_version = "5.15.0"
host_instance_type = "mq.t2.micro"
security_groups = [aws_security_group.test.id]
user {
username = "ExampleUser"
password = "MindTheGap"
}
logs {
general = false
}
}
安全的示例(通过检查)
resource "aws_mq_broker" "good_example" {
broker_name = "example"
configuration {
id = aws_mq_configuration.test.id
revision = aws_mq_configuration.test.latest_revision
}
engine_type = "ActiveMQ"
engine_version = "5.15.0"
host_instance_type = "mq.t2.micro"
security_groups = [aws_security_group.test.id]
user {
username = "ExampleUser"
password = "MindTheGap"
}
logs {
general = true
}
}
该检查与上一项结构完全对称,判定的关键属性是 logs.general。通用日志记录的是代理运行过程中的一般性消息,如连接创建、队列操作等,对于日常运维排障具有直接价值。虽然 tfsec 将其定为 low 级别,但在生产环境建议与审计日志一同开启,形成完整的可观测性闭环。
检查三:aws-mq-no-public-access(禁止公网暴露)
完整规则说明见 no-public-access 检查文档。
默认严重级别:high(高)
检查理由(Explanation):应禁用 MQ Broker 的公网访问,仅允许需要访问的应用程序所在的路由访问代理。
可能的影响(Possible Impact):公开可访问的 MQ Broker 可能易受入侵(compromise)风险。
建议修复(Suggested Resolution):在不需要时禁用 public access。
不安全的示例(会触发检查)
resource "aws_mq_broker" "bad_example" {
broker_name = "example"
configuration {
id = aws_mq_configuration.test.id
revision = aws_mq_configuration.test.latest_revision
}
engine_type = "ActiveMQ"
engine_version = "5.15.0"
host_instance_type = "mq.t2.micro"
security_groups = [aws_security_group.test.id]
user {
username = "ExampleUser"
password = "MindTheGap"
}
publicly_accessible = true
}
安全的示例(通过检查)
resource "aws_mq_broker" "good_example" {
broker_name = "example"
configuration {
id = aws_mq_configuration.test.id
revision = aws_mq_configuration.test.latest_revision
}
engine_type = "ActiveMQ"
engine_version = "5.15.0"
host_instance_type = "mq.t2.micro"
security_groups = [aws_security_group.test.id]
user {
username = "ExampleUser"
password = "MindTheGap"
}
publicly_accessible = false
}
这是三项检查中严重级别最高的一项,判定的关键属性是 publicly_accessible。将代理暴露到公网意味着任何能触达该 IP 的客户端都可能尝试连接,配合弱口令或未修复的漏洞即可构成严重威胁。AWS 官方的最佳实践也是优先使用不具备公网可达性的代理。需要注意的是,publicly_accessible 属性仅决定代理是否分配公网 IP/入口,网络层面的最终隔离还需要依赖 security_groups、子网与网络 ACL 的配合——tfsec 的该项检查聚焦于该属性本身,属于静态配置层面的基线校验。
在 tfsec 中运行与过滤这些 MQ 检查
基础扫描
tfsec 会扫描指定目录下的 Terraform 代码,若未指定目录则扫描当前工作目录;发现问题时进程退出码非零,全部通过时退出码为零(详见 README.md)。对包含 MQ 资源的目录执行:
tfsec .
定向过滤检查项
tfsec 的 CLI 支持按规则 ID 进行过滤,相关参数在 内部命令定义 与 使用指南 中有明确说明:
-
--exclude / -e:以逗号分隔的规则 ID 列表,扫描时排除这些规则。例如只排除公网暴露检查:tfsec . -e aws-mq-no-public-access -
--include-passed:在输出结果中一并展示通过(passed)的检查,便于验证修复效果。例如在修复后确认 MQ 三项检查是否全部通过:tfsec . --include-passed -
--minimum-severity:只报告达到指定严重级别及以上的问题。由于三项 MQ 检查横跨 low / medium / high 三个级别,可以根据团队要求调整阈值,例如只关注中高危问题:tfsec . --minimum-severity medium -
--format:切换输出格式(如json、sarif、csv等),方便与 CI 流水线或安全平台集成。
这些规则 ID 采用 aws-mq-* 的长格式命名。在 tfsec 的 旧规则 ID 映射表 中可以观察到,旧版短 ID(如 AWS001 这类格式)覆盖了大量 AWS 检查,但 MQ 相关检查只以长格式 ID 存在,因此在使用 --exclude、配置忽略项或对接工具时,应统一使用 aws-mq-enable-audit-logging、aws-mq-enable-general-logging、aws-mq-no-public-access 这三个完整 ID。
忽略规则的写法
若某个 MQ Broker 确实需要临时豁免某项检查(例如业务上必须开启公网访问),可以使用 tfsec 的忽略机制,在资源上方或行内标注忽略指令:
#tfsec:ignore:aws-mq-no-public-access
resource "aws_mq_broker" "example" {
# ...
publicly_accessible = true
}
忽略规则的相关配置详见 忽略指南,在生产中应尽量为每次豁免补充说明理由。
进一步查阅
- MQ 检查索引页:三项检查的总览导航。
- enable-audit-logging 规则文档
- enable-general-logging 规则文档
- no-public-access 规则文档
- tfsec 使用指南:完整的 CLI 参数说明。
- tfsec 配置指南:配置文件与扫描行为定制。
- tfsec 迁移指南:tfsec 现已并入 Trivy,本仓库仍保留这些检查文档,迁移到 Trivy 后可获得相同的 Terraform 扫描引擎与更丰富的生态集成。
结语
AWS MQ 的三项检查覆盖了消息代理安全最关键的两个维度:可观测性(审计日志 + 通用日志)与攻击面收敛(禁用公网访问)。在 Terraform 代码评审阶段接入 tfsec 即可在资源创建前发现这些配置偏差。建议将 aws-mq-no-public-access 作为强制基线(高危),aws-mq-enable-audit-logging 作为合规基线(中危),并保留 aws-mq-enable-general-logging 作为运维友好项(低危),结合 --include-passed 与 --minimum-severity 参数形成可持续的 IaC 安全门禁。