youyo/awscredswrap

awscredswrap

![Go Report Card]([***]

AWS角色临时凭证包装工具。

概述

awscredswrap通过指定IAM角色的临时凭证，设置Shell环境变量或执行命令，帮助用户安全地使用AWS资源。

核心功能

• 获取指定IAM角色的临时凭证
• 输出环境变量配置脚本，可通过eval快速设置
• 作为命令包装器，在临时凭证环境下执行指定命令
• 支持MFA验证（可选）
• 可自定义角色会话时长和名称

使用场景

• 本地开发时临时获取AWS角色凭证，避免长期密钥暴露
• CI/CD流程中（如GitHub Actions）临时切换IAM角色执行操作
• 需要临时权限的脚本或命令执行场景

配置说明

Docker镜像使用示例

执行命令

通过Docker运行工具，使用临时凭证执行指定命令：

bash
docker run --rm youyo/awscredswrap --role-arn arn:aws:iam::00000000:role/foo -- aws s3 ls

导出环境变量

获取临时凭证并在当前Shell中设置：

bash
eval $(docker run --rm youyo/awscredswrap --role-arn arn:aws:iam::00000000:role/foo)

带MFA验证

bash
docker run --rm youyo/awscredswrap --role-arn arn:aws:iam::00000000:role/foo --mfa-serial arn:aws:iam::00000000:mfa/your-mfa-device -- aws s3 ls

命令参数说明

bash
awscredswrap [flags]
Flags:
  -d, --duration-seconds int       角色会话时长（秒），默认3600
  -h, --help                       帮助信息
  -m, --mfa-serial string          MFA设备标识号（可选）
  -r, --role-arn string            需假设的角色ARN（必填）
  -n, --role-session-name string   角色会话名称（可选）
      --version                    版本信息

作为GitHub Actions使用（已弃用）

推荐使用官方Action：https://github.com/aws-actions/configure-aws-credentials

许可证

MIT

作者

https://github.com/youyo