tfsec 规则详解:使用 aws-iam-set-minimum-password-length 强制 IAM 密码最小长度为 14 位

原创2026-10-14 13:32:201,632 阅读
文章标签:应用安全SASTIaC

tfsec 规则详解:使用 aws-iam-set-minimum-password-length 强制 IAM 密码最小长度为 14 位

本文是一篇面向 Terraform 开发者与云安全工程师的实战指南,围绕 tfsec 内置检查规则 aws-iam-set-minimum-password-length 展开,说明它为什么要求 AWS IAM 账户密码策略的最小密码长度不低于 14 个字符,以及如何在 Terraform 配置中写出"不安全"与"安全"两种形态、如何运行 tfsec 验证结果、如何将该检查接入 CI 流水线,并介绍同一族密码策略检查的完整配置组合。读完本文,你将能独立编写合规的 aws_iam_account_password_policy 资源,并精确控制该规则在项目中的启停与忽略策略。

规则概览:一个针对 AWS IAM 密码策略的中危检查

aws-iam-set-minimum-password-length 是 tfsec 为 AWS IAM 服务内置的静态检查规则之一,其唯一目标资源是 aws_iam_account_password_policy(AWS 账户级密码策略)。在规则总表中,该规则的登记信息如下:

规则 ID Provider Service 描述
aws-iam-set-minimum-password-length aws iam IAM Password policy should have minimum password length of 14 or more characters.

该规则的默认严重级别为 medium(中危),含义是:账户密码策略应当确保密码具备最小长度,且最小长度应被设置为至少 14 个字符。

从规则标识体系看,tfsec 为每个规则都保留了一套兼容旧版的短 ID。在旧版规则映射表中可以查到该规则对应的历史编码:

"AWS039": "aws-iam-set-minimum-password-length",

这意味着,如果你在旧版 tfsec 输出、历史文档或团队遗留的注释中看到 AWS039,它指的就是这条规则;而在新版中应统一使用完整 ID aws-iam-set-minimum-password-length。该规则的文档页同时被挂载进 MkDocs 导航(见 mkdocs.yml),即 set-minimum-password-length 检查文档 中描述的标题、严重级别、风险解释、不安全/安全示例,正是本文展开讲解的骨架。

为什么要求密码最短 14 位

背景与风险

IAM 账户密码策略(Account Password Policy)是 AWS 账户级别的安全开关,它统一约束了该账户下所有 IAM 用户(包括未来新建的用户)的登录密码强度。本规则检查的是其中一项关键参数:最小密码长度。

规则文档中给出的风险解释与建议是:

  • 可能的影响(Possible Impact):过短、过于简单的密码更容易被攻破("Short, simple passwords are easier to compromise")。
  • 建议的整改方向(Suggested Resolution):在密码策略中强制更长、更复杂的密码("Enforce longer, more complex passwords in the policy")。

从安全原理看,密码长度直接决定了暴力破解(Brute Force)与字典攻击(Dictionary Attack)的搜索空间:每增加一个字符,可能的密码组合数量呈指数级增长。AWS 官方在其 IAM 密码策略说明中允许的最小密码长度范围是 6~128 个字符,而安全社区与合规框架普遍建议将下限提到 14 位以上,这也是 tfsec 选择 14 作为判定阈值的原因——它代表了一条比 AWS 默认下限更严格、更符合行业最佳实践的基线。

何时会触发该检查

tfsec 采用静态分析的方式解析你的 Terraform 代码。对于本规则而言,只要代码中声明了 aws_iam_account_password_policy 资源,且没有显式设置 minimum_password_length(或设置值小于 14),该检查就会以 medium 级别报告一条发现(finding)。规则文档给出了典型的失败形态。

不安全示例:未设置最小密码长度

以下是会触发 aws-iam-set-minimum-password-length 检查的写法(来自检查文档的 Insecure Example):

resource "aws_iam_account_password_policy" "bad_example" {
	# ...
	# minimum_password_length not set
	# ...
}

这段配置的问题在于:虽然创建了账户密码策略,但完全没有声明 minimum_password_length 参数。在 Terraform 中,未显式设置的参数会回落到 AWS API 的默认行为,而该默认值低于 tfsec 所要求的 14 位安全基线,因此属于"策略存在但不达标"的半开放状态。

需要特别说明的是:如果整个代码库中根本不存在 aws_iam_account_password_policy 资源,意味着账户没有启用任何自定义密码策略,此时本规则不会报错——它只负责校验"策略被声明时是否足够强壮",而不是"策略是否存在"。要想让"必须存在密码策略"也成为强制项,通常需要搭配组织层面的治理手段或额外的自定义 Rego 检查,而不是依赖本内置规则。

安全示例:显式设置最小长度为 14

以下是会通过该检查的写法(同样来自检查文档的 Secure Example):

resource "aws_iam_account_password_policy" "good_example" {
	minimum_password_length = 14
}

只要 minimum_password_length 的值大于或等于 14,该资源即满足规则要求。不过,从实战角度讲,一份合格的账户密码策略远不止"长度"一个参数。tfsec 的 IAM 密码策略检查是一个完整的规则族,可以组合成一条更强的基线,例如:

resource "aws_iam_account_password_policy" "secure_example" {
  minimum_password_length        = 14
  require_lowercase_characters   = true
  require_uppercase_characters   = true
  require_numbers                = true
  require_symbols                = true
  max_password_age               = 90
  password_reuse_prevention      = 24
  allow_users_to_change_password = true
  hard_expiry                    = false
}

其中 require_lowercase_characters、require_numbers、require_symbols、require_uppercase_characters 分别对应同族规则 require-lowercase-in-passwords、require-numbers-in-passwords、require-symbols-in-passwords、require-uppercase-in-passwords;max_password_age = 90 满足 set-max-password-age 检查(要求过期时间 ≤ 90 天);password_reuse_prevention 则与 no-password-reuse 检查对应。全部 IAM 检查清单可在 IAM 检查索引页 中查看。

运行 tfsec 验证你的密码策略配置

tfsec 默认扫描当前目录下的所有 .tf 文件,无需指定目标目录即可运行:

tfsec .

如果扫描到不合规项,进程会以非零退出码结束,便于 CI 捕获;全部通过则退出码为 0(见 README 的 Usage 章节)。针对本规则,有几个实用参数值得掌握(完整参数列表见 用法文档):

参数 短参数 用途
--format string -f 输出格式:lovely(默认)、json、csv、checkstyle、junit、sarif、text、markdown、html、gif
--include-passed 在结果中同时输出通过(passed)的检查,便于确认你的策略确实满足要求
--minimum-severity string -m 只报告不低于指定级别的发现,可选 CRITICAL、HIGH、MEDIUM、LOW
--exclude string -e 排除指定规则 ID 列表(逗号分隔)
--tfvars-file strings 指定 .tfvars 文件,使变量插值参与分析

例如,只想确认密码策略相关规则是否全部通过,可以运行:

tfsec . --include-passed --filter-results aws-iam-set-minimum-password-length

若只想在输出中排除这条规则(例如团队正在灰度放宽密码长度),则使用:

tfsec . -e aws-iam-set-minimum-password-length

-e 的语义是"本次扫描跳过这些规则",与"忽略单条发现"不同,前者全局生效,后者仅针对具体代码位置(见下文)。此外,最低严重级别可以通过 -m MEDIUM 过滤掉 LOW 级噪音,或写入配置文件 minimum_severity: MEDIUM(详见 配置文件指南),让全团队共享同一套筛选标准。

将检查接入 CI:Sarif、GitHub Security Alerts 与退出码

tfsec 从设计上就是面向 CI 流水线的工具。常见做法是让流水线在 terraform plan 之后运行 tfsec .,并在发现问题时阻断合并。为了保证在 CI 中的可读性,建议组合使用以下参数:

tfsec . --no-colour --format sarif --out tfsec-results.sarif
  • --no-colour(或美式拼写 --no-color)关闭彩色输出,避免日志乱码;
  • --format sarif 生成 SARIF 格式结果,可直接接入 GitHub Code Scanning / GitHub Security Alerts 等平台,在 PR 中逐条展示规则 ID、文件位置与修复建议;
  • 非零退出码天然适合作为流水线的失败条件,无需额外脚本判断。

同样的检查也可通过 Docker 运行(见 README 的 Docker 章节),适合在统一镜像版本的环境中使用:

docker run --rm -it -v "$(pwd):/src" aquasec/tfsec /src

合理忽略该检查的场景与写法

安全工具的价值在于"该拦截时拦截,该放行时放行"。tfsec 支持通过行内注释忽略特定发现,忽略机制的完整说明见 忽略指南。例如,某个环境因兼容遗留系统暂时需要 12 位密码,可以这样声明:

resource "aws_iam_account_password_policy" "legacy_example" {
	minimum_password_length = 12 #tfsec:ignore:aws-iam-set-minimum-password-length
}

忽略注释支持附加过期日期,防止忽略项被永久遗忘:

#tfsec:ignore:aws-iam-set-minimum-password-length:exp:2026-12-31
resource "aws_iam_account_password_policy" "temporary_example" {
	minimum_password_length = 12
}

过期后该忽略自动失效,检查恢复生效,强制团队在约定时间点重新评估。如果你使用的是旧版 ID,注释中也可以写 AWS039(新版提供 --migrate-ignores 参数协助迁移到完整 ID)。此外,--no-ignores 参数可以强制忽略所有 ignore 注释,适合在安全审计时进行"零豁免"的全量扫描。

同族检查与进一步阅读

IAM 密码策略相关的内置检查在 IAM 检查索引页 中集中列出,除本规则外还包括:

小结

aws-iam-set-minimum-password-length 是 tfsec 内置的 AWS IAM 中危检查,它在代码层面强制 aws_iam_account_password_policy 资源声明 minimum_password_length >= 14,从源头杜绝"短密码易被爆破"的账户级弱点。实践上,建议将该规则与 require-*、set-max-password-age、no-password-reuse 等同族检查一并开启,形成完整的密码策略基线;在 CI 中结合 --format sarif 与非零退出码实现自动化阻断;确需豁免时,使用带过期日期的 tfsec:ignore 注释并接受定期复审。本文所有命令与参数均可在仓库的 usage 文档、忽略指南 与 规则总表 中进一步验证。

登录后查看全文
tfsec