One of the security best practices that is time-consuming to manage is enforcing IAM access key rotation for IAM users. Access keys give IAM users the ability to connect to Amazon EC2 instances. Therefore rotating these regularly (for example, every 90 days) is one of the key steps in protecting your resources from unauthorized access. However, it is often the case that unless staff is dedicated to managing them, enforcing regular rotation can quickly become overlooked. This is more common with companies, which manage hundreds of IAM users across dozens of AWS accounts.
An option to enforce compliance is to use one of AWS Config’s features, automatic remediation. These are declared in AWS Systems Manager automation documents, which are invoked by AWS Config when a resource is found to be non-compliant. As its name implies, these steps are meant to remediate non-compliant resources, but in our case, we use them as part of a notification system.
In this post, I show you how to set up Systems Manager and AWS Config automatic remediations with a centralized notification system. I also go over some of the options available for further processing.
This post assumes that you have set up a master account, which monitors and aggregates the results from other accounts within your company. Therefore it uses AWS CloudFormation StackSets to automatically propagate and execute stacks from a master account to the target accounts. If you don’t have this setup or want to avoid using StackSets, you can alternatively deploy Step 2 as individual stacks in each target account.
To deploy using StackSets, make sure that your master and target accounts are set up with the right permissions for these to execute. You can find more info in StackSet prerequisites documentation.
AWS Config configuration
You must have AWS Config enabled in your master and targets accounts. Additionally, make sure that your setup is monitoring all global resources or at minimum IAM user resources. For more information, check getting started with AWS Config.
To check the aggregated results from all target accounts in the AWS Config console of your master account, you must have authorized your master account to aggregate the results.
Overview of solution
The described solution relies on a master account from where you monitor and manage the IAM users across multiple target accounts. In each target account, you add an automatic remediation to the AWS Config access-keys-rotated rule. The remediation executes a Systems Manager automation document, which resolves the user name and then publishes the information to Amazon SNS for further processing.
Here is how the process works:
- In every target account, AWS Config executes the rule and invokes the SSM automation document for every non-compliant resource
- The automation document does the following steps.
- Resolve the IAM user name from the IAM user resourceId through an API call
- Publish a customized message to an SNS topic in the master account
AWS Config invokes the remediation automation document. AWS Config passes non-complying ResourceId and an IAM role AutomationAssumeRole. This role grants all the necessary permissions for AWS Config to execute the automation document.
The first step in the automation document is to resolve the corresponding IAM user name (for example, AliceAdmin) from the IAM user ResourceId (for example, AIDAAXW). This is done by invoking the
aws:executeAwsApi command. This command is powerful since it lets you execute API calls from within an automation document. This command is executed without the need for provisioning and paying for any infrastructure. In our case, we invoke the equivalent of the following AWS CLI call:
aws configservice list-discovered-resources.
The next step in the automation document is to craft a message to publish to an SNS topic. It appends the Account ID into the message by using an SSM system variable global:ACCOUNT_ID. It also adds the previous step’s user name using the format step-name.Output-name (for example, configStep.configUserName) to the message.
It then uses the
aws:executeAutomation command to invoke other automation documents. In this case, we’re invoking the AWS managed automation
AWS-PublishSNSNotification, which publishes to Amazon SNS.
Following are the steps to be performed.
- Deploy AWS CloudFormation stack to set up the master account with an SNS topic.
- Deploy AWS CloudFormation stack to set up the target accounts with following steps.
- Set up IAM roles.
- Create the SSM automation document.
- Enable the AWS Config rule access-keys-rotated.
- Link the automation document as the automatic remediation step.
Let’s get started!
Step 1: Deploy to master account
Download the AWS CloudFormation template from AccessKeyRotationParentAccount.yaml and save it to a file on your computer.
Navigate to the AWS CloudFormation console and select stacks on the sidebar menu. Then select create stack, and from the pull-down menu select with new resources (standard).
On the create stack page, select Upload a template file, and select file. Select the YAML file you saved and then click Next.
In the specify stack details page:
- Enter AccessKeyRotationMaster as the stack name.
- Enter the comma-separated list of target accounts you want to monitor for compliance.
- Click Next.
On the Configure stack options page, add any necessary tags, and select Next. Review all the information and select create stack to submit your stack configuration. Once the page refreshes, you find stack in CREATE_IN_PROGRESS status and the status changes to CREATE_COMPLETE once it’s done. When it is finished, navigate to the Outputs tab and copy the newly created SNS topic Amazon Resource Name (ARN) in the value column.
Step 2: Deploy to target accounts
Download the AWS CloudFormation template from AccessKeyRotationChildAccounts.yaml and save it to a file on your computer.
Go to the AWS CloudFormation console and select StackSets on the sidebar menu, then select Create StackSet. On the create stack page, select Upload a template file and select file. Select the YAML file you saved and then select Next.
On the Specify StackSet details page, use the following details.
- Enter AccessKeyRotationTarget as the StackSet name
- Edit the maxAccessKeyAge and MaximumExecutionFrequency parameters to your requirements.
- maxAccessKeyAge denotes up to how many days old a key can be and still be compliant.
- MaximumExecutionFrequency denotes how frequently AWS Config evaluates the access-keys-rotated rule.
- Enter the SNS topic ARN from the AccessKeyRotationMaster step. This is the SNS topic that receives the messages of non-compliant IAM users.
- Click Next.
On the Configure StackSet options page, add any required tags. The content of the Permissions section varies depending on whether you have AWS Organizations enabled or not.
- If you do not have AWS Organizations enabled, use the defaults and select Next.
- If you do, you can select Service managed permissions to apply the StackSets to an organization or OU, or select Self service permissions to have more manual control of the process. In this case, I select Self service permissions in order to add a list of accounts as targets. Select Next.
In the Set deployment options page, enter the target AWS account numbers and AWS Regions where you’d like to execute this automated process as a comma separated list (or you can upload a .csv file with the numbers). Click Next.
On the next page, review the options chosen, select the “I acknowledge” Check box at the bottom of the page, and select Submit.
At this point you can refresh your browser to check the status of the operation you submitted. Once it’s done, the status turns to SUCCEEDED and AWS Config runs the rule to find non-compliant IAM users in each target account and publishes a message for each non-compliant IAM user found to your SNS topic in the master account.
Check Rules on target account
Once your deployments are finished, you can find your rules in action. Log in to one of the target accounts and go to the AWS Config console, select Rules on the sidebar menu. Scroll down the results and select the access-keys-rotated rule.
On this screen, you find the maxAccessKeyAge and time-interval configuration that was set up via AWS CloudFormation and the list of IAM users with non-compliant access keys for the target account. The Action status reveals whether the automatic remediation ran successfully or with errors.
Click the Edit button to look at the automatic remediation you created. On this screen you find the details of the remediation. The remediation action chosen is the AWS CloudFormation generated automation document and is set up to run automatically. The Resource Id parameter is mapped to the resourceId parameter defined in the automation document. The AutomationAssumeRole parameter is hardcoded to an IAM role that was created via AWS CloudFormation.
Further processing options
There are many options for further processing of the messages generated by the automation document. You can apply different levels of customization to automate this process further or to facilitate administrators with limited access or expertise to manage the notification process. For example, the options are to add a subscription to the generated SNS topic as follows.
- Send the messages to an Amazon SQS queue to be monitored by someone with lesser access or fed into an application.
- Send an email to a security administrator who may not have access to the AWS account.
- Invoke a Lambda or an endpoint
Alternatively, you could modify the AWS CloudFormation template from Step 2 and instead of invoking the
AWS-PublishSNSNotification in the SSM automation document you could select the following options.
- Create and assign a Jira ticket using the pre-built AWS-CreateJiraIssue automation
- Feed the messages into a slack channel by invoking a slack blueprint Lambda through the pre-built
AWS-invokeLambdaFunctionautomation document. More info at Slack integration blueprints.
- Invoke a REST API endpoint by using the
aws:executeScriptcommand, which lets you run Python and PowerShell scripts. More info at creating automation documents that run scripts.
A fully automated option could also be achieved with requirement of all IAM users to have a tag with an email address. Then edit the automation document to invoke the
aws iam get-user AWS CLI call to read the email address tag, and email the non-complying IAM users directly. This option would reduce the manual process of figuring out who each IAM user is.
It is important to note that once the initial run has been successful and captured all non-compliant IAM users, you may want to change the remediation to run only on configuration changes, instead of on a daily basis. This should cut down on costs dramatically.
If you want to delete the configuration you can:
- delete the resources in the target accounts by deleting the stack instances in the AccessKeyRotationTarget StackSet.
- delete the SNS topic by deleting the AWS CloudFormation AccessKeyRotationMaster Stack in the master account.
In this post, I showed you how to set up an SSM automation document as an automatic remediation for the access-keys-rotated AWS Config rule. The document expands the information passed by AWS Config and crafts an actionable message, publishing it to an SNS topic. I also provided some options available for processing the message further via different API operations and solution for administrators with different levels of access to monitor the compliance data.
About the Author
Melina Schweizer is a Senior Technical Account Manager at AWS. She works with Enterprise Support customers to help them design solutions and optimize their usage of AWS resources. In her spare time, Melina enjoys playing the piano, gardening, and vacationing in Europe with her family.