关于AWS Key disabler

AWS Key disabler是一款功能强大的AWS IAM用户访问密钥安全保护工具，该工具可以通过设置一个时间定量来禁用AWS IAM用户访问密钥，以此来降低旧访问密钥所带来的安全风险。

工具运行流程

AWS Key disabler本质上是一个Lambda函数，可以通过下列工作流来实现其功能：

工具要求

当前版本的AWS Key disabler脚本需要使用到下列组件：

1、Node.js和NPM；

2、Gruntjs；

3、AWS CLI命令行工具；

4、启用SWS、验证域名并移除沙盒模式的AWS账号；

开发者工具链

工具安装

注意，下列安装命令仅适用于macOS，Windows和*nix的安装命令可能会有一些区别。

首先，我们需要使用下列命令将该项目源码克隆至本地：

git clone https://github.com/te-papa/aws-key-disabler.git

切换到/grunt目录中，设置Grunt任务运行器，并安装相关依赖：

cd grunt/npm install

然后在/grunt/package.json文件中添加下列信息：

1、设置AWS账号的aws_account_number值；

2、设置first_warning和last_warning，即触发警报邮件（发送至report_to）的天数时间；

3、设置expiry，即密钥超时天数，如果超时，则会通过电子邮件向用户发送提醒；

4、设置serviceaccount，即需要脚本忽略的账户用户名；

5、设置exclusiongroup，即需要脚本忽略的分配给用户的组名；

6、设置send_completion_report值为True以通过SES发送通知邮件；

7、设置report_to，即用于接收警报和报告的邮件地址；

8、设置report_from，即用于发送警告邮件和报告的邮件地址；

9、设置deployment_region，即支持Lambda支持的区域；

接下来，确保命令行接口已经成功连接到了AWS，可以使用下列命令验证连接是否成功：

aws iam get-user

在命令行接口中，切换到/grunt目录中，并运行下列命令即可完成工具部署：

grunt bumpup && grunt deployLambda

工具使用

使用AWS CLI从命令行接口手动调用Lambda函数

我们可以直接使用函数名称来调用Lambda函数，并将扫描文件的输出结果存储到scan.report.log文件中：

aws lambda invoke --function-name AccessKeyRotation scan.report.log --region us-east-1

{"StatusCode": 200}

使用jq即可在命令行窗口中查看scan.report.log文件中的内容：

jq '.' scan.report.log

{"reportdate": "2016-06-26 10:37:24.071091","users": [{"username": "TestS3User","userid": "1","keys": [{"age": 72,"changed": false,"state": "key is already in an INACTIVE state","accesskeyid": "**************Q3GA1"},{"age": 12,"changed": false,"state": "key is still young","accesskeyid": "**************F3AA2"}]},{"username": "BlahUser22","userid": "2","keys": []},{"username": "LambdaFake1","userid": "3","keys": [{"age": 23,"changed": false,"state": "key is due to expire in 1 week (7 days)","accesskeyid": "**************DFG12"},{"age": 296,"changed": false,"state": "key is already in an INACTIVE state","accesskeyid": "**************4ZASD"}]},{"username": "apiuser49","userid": "4","keys": [{"age": 30,"changed": true,"state": "key is now EXPIRED! Changing key to INACTIVE state","accesskeyid": "**************ER2E2"},{"age": 107,"changed": false,"state": "key is already in an INACTIVE state","accesskeyid": "**************AWQ4K"}]},{"username": "UserEMRKinesis","userid": "5","keys": [{"age": 30,"changed": false,"state": "key is now EXPIRED! Changing key to INACTIVE state","accesskeyid": "**************MGB41A"}]},{"username": "CDN-Drupal","userid": "6","keys": [{"age": 10,"changed": false,"state": "key is still young","accesskeyid": "**************ZDSQ5A"},{"age": 5,"changed": false,"state": "key is still young","accesskeyid": "**************E3ODA"}]},{"username": "ChocDonutUser1","userid": "7","keys": [{"age": 59,"changed": false,"state": "key is already in an INACTIVE state","accesskeyid": "**************CSA123"}]},{"username": "ChocDonut2","userid": "8","keys": [{"age": 60,"changed": false,"state": "key is already in an INACTIVE state","accesskeyid": "**************FDGD2"}]},{"username": "admin.skynet@cyberdyne.systems.com","userid": "9","keys": [{"age": 45,"changed": false,"state": "key is already in an INACTIVE state","accesskeyid": "**************BLQ5GJ"},{"age": 71,"changed": false,"state": "key is already in an INACTIVE state","accesskeyid": "**************GJFF53"}]}]}

使用样例一

aws lambda list-functionsopenssl dgst -binary -sha256 ..\Releases\AccessKeyRotationPackage.1.0.18.zip | openssl base64aws lambda invoke --function-name AccessKeyRotation report.log --region us-east-1jq '.' report.logjq '.users[] | select(.username=="johndoe")' report.logjq '.' report.log | grep age | cut -d':' -f2 | sort -n

使用样例二

jq 'def maximal_by(f): (map(f) | max) as $mx | .[] | select(f == $mx); .users | maximal_by(.keys[].age)' report.logjq 'def minimal_by(f): (map(f) | min) as $mn | .[] | select(f == $mn); .users | minimal_by(.keys[].age)' report.log

终端用户输出结果

许可证协议

本项目的开发与发布遵循ISC开源许可证协议。

项目地址

AWS Key disabler：【GitHub传送门】

参考资料

Node.js — Run JavaScript Everywhere

Grunt: The JavaScript Task Runner

Command Line Interface - AWS CLI - AWS

https://portal.aws.amazon.com/gp/aws/manageYourAccount

AWS Services by Region - AWS