AWS Workload Credentials Provider 安全实践SSRF 令牌机制、最小权限与 6 个必知要点【免费下载链接】aws-workload-credentials-providerThe AWS Workload Credentials Provider (formerly the AWS Secrets Manager Agent) is a client-side solution that helps you standardize how you consume credentials from AWS services across your compute environments.项目地址: https://gitcode.com/gh_mirrors/aw/aws-workload-credentials-providerAWS Workload Credentials Provider前身为 AWS Secrets Manager Agent是一个运行在你计算环境本地的凭证消费代理它通过本地 HTTP 接口统一分发 AWS Secrets Manager 密钥与 ACM 证书。对于新手来说最关心的问题往往是它安全吗SSRF 令牌机制到底怎么工作最小权限怎么配本文将用通俗的语言拆解它的安全设计并整理出 6 个必知要点帮你既用得好、又守得住。为什么需要关注 Workload Credentials Provider 的安全 它本质上是一个本地代理 内存缓存应用不再直接调用 AWS API而是访问localhost:2773这样的本地端口。好处是省去 SDK 集成、自动缓存、统一刷新但坏处是——任何能访问这个本地端口的人就等于拿到了密钥的读取通道。如果本地端口没有防护恶意进程或注入请求就可能偷走你的密钥。这正是 AWS Workload Credentials Provider 引入 SSRF 令牌机制的根本原因。必知要点 1SSRF 令牌机制——本地代理的第一道防线 ️SSRF服务端请求伪造是云上环境的常见攻击方式。为了防止攻击者借本地代理发起伪造请求AWS Workload Credentials Provider 要求每个请求必须携带一个随机生成的 SSRF 令牌放在请求头里默认请求头X-Aws-Parameters-Secrets-Token也兼容X-Vault-Token默认读取顺序AWS_TOKEN→AWS_SESSION_TOKEN→AWS_CONTAINER_AUTHORIZATION_TOKEN令牌可放在环境变量里也可通过AWS_TOKENfile:///var/run/awssmatoken指向令牌文件安装脚本会在启动时生成随机令牌并写入文件应用只需读文件、带上请求头即可。令牌校验逻辑集中在 server.rs令牌缺失或错误直接返回 403只有/ping健康检查免于校验。必知要点 2拒绝转发头与连接限制堵住 SSRF 攻击路径 除了令牌还有两层隐形防线拒绝转发请求一旦请求携带X-Forwarded-For头说明是被代理转发的请求可能是 SSRF 攻击迹象直接返回 400 拒绝。校验代码在 server.rs。限制连接数默认最多 800 个连接max_conn超出返回 429防止本地端口被滥用。禁止网络跳转连接建立后立刻设置 TTL 为 1stream.set_ttl(1)确保请求只能来自本机不能跨网络路由。这三招合在一起等于把本地端口锁在了本机范围内即使攻击者拿到了端口访问权也很难把流量转发出去。必知要点 3最小权限 IAM 策略只给读不给写 ✂️AWS Workload Credentials Provider 本身只能读取密钥不能修改。这意味着你的 IAM 角色策略应该只包含secretsmanager:GetSecretValue——读取密钥值secretsmanager:DescribeSecret——查询密钥元数据如版本、轮转信息千万不要给PutSecretValue、UpdateSecret、DeleteSecret这类写权限。如果你需要跨账号访问它支持角色链Role Chaining通过sts:AssumeRole临时换取目标角色权限目标角色同样只需上述两个读权限即可。权限验证示例参考 utils.rs 中的 STS 身份校验逻辑。必知要点 4文件权限与 sudoers 精确授权证书落盘也安全 证书管理ACM 能力会把 PEM 文件写入本地文件系统这部分安全同样讲究私钥文件默认0600仅所有者可读写证书和链文件默认0600可配置为0644供 Web 服务器读取刷新命令通过sudo -n执行但 sudoers 里只允许精确配置的那条命令例如nginx -s reload其他命令一律拒绝生成逻辑见 sudoers.rs所有路径必须是绝对路径包含符号链接或路径穿越..的路径会被直接拒绝如果环境不允许提权安装脚本支持--no-privileges和--no-sudoers两种降权模式必知要点 5后量子加密 ML-KEM通信层默认加锁 AWS Workload Credentials Provider 默认使用post-quantum ML-KEM 密钥交换作为最高优先级。简单说即使未来量子计算机成熟当前抓取的通信流量也无法被轻易解密。对普通用户而言你不需要做任何配置它默认开启——这正是默认安全理念的体现。必知要点 6信任域边界——安全的关键在于谁能碰这台机器 官方文档反复强调一个概念信任域。对于本地代理架构信任域就是谁能访问代理端点、SSRF 令牌和证书文件通常等于整个主机。也就是说你的 IAM 角色权限决定了代理能从 AWS 拿到什么而主机上的任何用户只要拿到 SSRF 令牌就能从代理缓存里读到已拉取的密钥所以安全姿态是确保能访问这台机器的人本来就应该能访问这些 AWS 凭据。如果你的场景要求更严格的隔离比如密钥只允许特定应用读取官方建议改用语言级 AWS SDK 或专用缓存方案。快速上手一份最小权限安全配置示例 ⚙️把上面的要点落地你的config.toml大致长这样重点看 security 段[capabilities.secrets_manager] enabled true http_port 2773 max_conn 800 [capabilities.secrets_manager.cache] ttl_seconds 300 cache_size 1000 [capabilities.secrets_manager.security] ssrf_headers [X-Aws-Parameters-Secrets-Token] ssrf_env_variables [AWS_TOKEN]配套的 IAM 策略则精简为{ Version: 2012-10-17, Statement: [ { Effect: Allow, Action: [ secretsmanager:GetSecretValue, secretsmanager:DescribeSecret ], Resource: arn:aws:secretsmanager:*:*:secret:my-app-* } ] }写在最后6 个要点速查清单 ✅要点一句话总结1. SSRF 令牌机制每个请求必须带X-Aws-Parameters-Secrets-Token令牌头2. 连接与转发防护拒绝X-Forwarded-For、限制连接数、禁止网络跳转3. 最小权限 IAM只给GetSecretValue和DescribeSecret读权限4. 文件权限私钥 0600、sudoers 只允许精确刷新命令5. 后量子加密ML-KEM 默认开启无需额外配置6. 信任域边界确保能碰主机的人 本应能碰密钥的人AWS Workload Credentials Provider 的安全设计思路很清晰对外最小权限拿密钥对内令牌请求校验防 SSRF落盘文件严格控权限。只要按这 6 个要点配置你就能在享受本地缓存便利的同时把安全风险控制在可接受范围内。想深入源码可以重点阅读 server.rs请求校验、utils.rs令牌读取与客户端构建和 sudoers.rs权限生成。【免费下载链接】aws-workload-credentials-providerThe AWS Workload Credentials Provider (formerly the AWS Secrets Manager Agent) is a client-side solution that helps you standardize how you consume credentials from AWS services across your compute environments.项目地址: https://gitcode.com/gh_mirrors/aw/aws-workload-credentials-provider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AWS Workload Credentials Provider 安全实践：SSRF 令牌机制、最小权限与 6 个必知要点
AWS Workload Credentials Provider 安全实践SSRF 令牌机制、最小权限与 6 个必知要点【免费下载链接】aws-workload-credentials-providerThe AWS Workload Credentials Provider (formerly the AWS Secrets Manager Agent) is a client-side solution that helps you standardize how you consume credentials from AWS services across your compute environments.项目地址: https://gitcode.com/gh_mirrors/aw/aws-workload-credentials-providerAWS Workload Credentials Provider前身为 AWS Secrets Manager Agent是一个运行在你计算环境本地的凭证消费代理它通过本地 HTTP 接口统一分发 AWS Secrets Manager 密钥与 ACM 证书。对于新手来说最关心的问题往往是它安全吗SSRF 令牌机制到底怎么工作最小权限怎么配本文将用通俗的语言拆解它的安全设计并整理出 6 个必知要点帮你既用得好、又守得住。为什么需要关注 Workload Credentials Provider 的安全 它本质上是一个本地代理 内存缓存应用不再直接调用 AWS API而是访问localhost:2773这样的本地端口。好处是省去 SDK 集成、自动缓存、统一刷新但坏处是——任何能访问这个本地端口的人就等于拿到了密钥的读取通道。如果本地端口没有防护恶意进程或注入请求就可能偷走你的密钥。这正是 AWS Workload Credentials Provider 引入 SSRF 令牌机制的根本原因。必知要点 1SSRF 令牌机制——本地代理的第一道防线 ️SSRF服务端请求伪造是云上环境的常见攻击方式。为了防止攻击者借本地代理发起伪造请求AWS Workload Credentials Provider 要求每个请求必须携带一个随机生成的 SSRF 令牌放在请求头里默认请求头X-Aws-Parameters-Secrets-Token也兼容X-Vault-Token默认读取顺序AWS_TOKEN→AWS_SESSION_TOKEN→AWS_CONTAINER_AUTHORIZATION_TOKEN令牌可放在环境变量里也可通过AWS_TOKENfile:///var/run/awssmatoken指向令牌文件安装脚本会在启动时生成随机令牌并写入文件应用只需读文件、带上请求头即可。令牌校验逻辑集中在 server.rs令牌缺失或错误直接返回 403只有/ping健康检查免于校验。必知要点 2拒绝转发头与连接限制堵住 SSRF 攻击路径 除了令牌还有两层隐形防线拒绝转发请求一旦请求携带X-Forwarded-For头说明是被代理转发的请求可能是 SSRF 攻击迹象直接返回 400 拒绝。校验代码在 server.rs。限制连接数默认最多 800 个连接max_conn超出返回 429防止本地端口被滥用。禁止网络跳转连接建立后立刻设置 TTL 为 1stream.set_ttl(1)确保请求只能来自本机不能跨网络路由。这三招合在一起等于把本地端口锁在了本机范围内即使攻击者拿到了端口访问权也很难把流量转发出去。必知要点 3最小权限 IAM 策略只给读不给写 ✂️AWS Workload Credentials Provider 本身只能读取密钥不能修改。这意味着你的 IAM 角色策略应该只包含secretsmanager:GetSecretValue——读取密钥值secretsmanager:DescribeSecret——查询密钥元数据如版本、轮转信息千万不要给PutSecretValue、UpdateSecret、DeleteSecret这类写权限。如果你需要跨账号访问它支持角色链Role Chaining通过sts:AssumeRole临时换取目标角色权限目标角色同样只需上述两个读权限即可。权限验证示例参考 utils.rs 中的 STS 身份校验逻辑。必知要点 4文件权限与 sudoers 精确授权证书落盘也安全 证书管理ACM 能力会把 PEM 文件写入本地文件系统这部分安全同样讲究私钥文件默认0600仅所有者可读写证书和链文件默认0600可配置为0644供 Web 服务器读取刷新命令通过sudo -n执行但 sudoers 里只允许精确配置的那条命令例如nginx -s reload其他命令一律拒绝生成逻辑见 sudoers.rs所有路径必须是绝对路径包含符号链接或路径穿越..的路径会被直接拒绝如果环境不允许提权安装脚本支持--no-privileges和--no-sudoers两种降权模式必知要点 5后量子加密 ML-KEM通信层默认加锁 AWS Workload Credentials Provider 默认使用post-quantum ML-KEM 密钥交换作为最高优先级。简单说即使未来量子计算机成熟当前抓取的通信流量也无法被轻易解密。对普通用户而言你不需要做任何配置它默认开启——这正是默认安全理念的体现。必知要点 6信任域边界——安全的关键在于谁能碰这台机器 官方文档反复强调一个概念信任域。对于本地代理架构信任域就是谁能访问代理端点、SSRF 令牌和证书文件通常等于整个主机。也就是说你的 IAM 角色权限决定了代理能从 AWS 拿到什么而主机上的任何用户只要拿到 SSRF 令牌就能从代理缓存里读到已拉取的密钥所以安全姿态是确保能访问这台机器的人本来就应该能访问这些 AWS 凭据。如果你的场景要求更严格的隔离比如密钥只允许特定应用读取官方建议改用语言级 AWS SDK 或专用缓存方案。快速上手一份最小权限安全配置示例 ⚙️把上面的要点落地你的config.toml大致长这样重点看 security 段[capabilities.secrets_manager] enabled true http_port 2773 max_conn 800 [capabilities.secrets_manager.cache] ttl_seconds 300 cache_size 1000 [capabilities.secrets_manager.security] ssrf_headers [X-Aws-Parameters-Secrets-Token] ssrf_env_variables [AWS_TOKEN]配套的 IAM 策略则精简为{ Version: 2012-10-17, Statement: [ { Effect: Allow, Action: [ secretsmanager:GetSecretValue, secretsmanager:DescribeSecret ], Resource: arn:aws:secretsmanager:*:*:secret:my-app-* } ] }写在最后6 个要点速查清单 ✅要点一句话总结1. SSRF 令牌机制每个请求必须带X-Aws-Parameters-Secrets-Token令牌头2. 连接与转发防护拒绝X-Forwarded-For、限制连接数、禁止网络跳转3. 最小权限 IAM只给GetSecretValue和DescribeSecret读权限4. 文件权限私钥 0600、sudoers 只允许精确刷新命令5. 后量子加密ML-KEM 默认开启无需额外配置6. 信任域边界确保能碰主机的人 本应能碰密钥的人AWS Workload Credentials Provider 的安全设计思路很清晰对外最小权限拿密钥对内令牌请求校验防 SSRF落盘文件严格控权限。只要按这 6 个要点配置你就能在享受本地缓存便利的同时把安全风险控制在可接受范围内。想深入源码可以重点阅读 server.rs请求校验、utils.rs令牌读取与客户端构建和 sudoers.rs权限生成。【免费下载链接】aws-workload-credentials-providerThe AWS Workload Credentials Provider (formerly the AWS Secrets Manager Agent) is a client-side solution that helps you standardize how you consume credentials from AWS services across your compute environments.项目地址: https://gitcode.com/gh_mirrors/aw/aws-workload-credentials-provider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考