Deny AWS EC2 Instances with Unapproved AMIs or Publisher Accounts
Denying AWS EC2 instances with unapproved AMIs and/or publisher accounts is essential to maintain a secure and controlled environment. This prevents the use of potentially vulnerable or malicious images, ensuring that only vetted and compliant resources are deployed, thereby reducing security risks and maintaining compliance with organizational policies.
This policy pack can help you configure the following settings for EC2 instances:
- Enforce a lockdown IAM policy via Guardrails to deny launching EC2 instances with unapproved AMIs and/or publishers
- Set the AMI IDs that are approved for use
- Set the publisher account IDs that are approved for use
Getting Started
Requirements
- Terraform
- Guardrails mods:
Credentials
To create a policy pack through Terraform:
- Ensure you have
Turbot/Admin
permissions (or higher) in Guardrails - Create access keys in Guardrails
And then set your credentials:
export TURBOT_WORKSPACE=myworkspace.acme.comexport TURBOT_ACCESS_KEY=acce6ac5-access-key-hereexport TURBOT_SECRET_KEY=a8af61ec-secret-key-here
Please see Turbot Guardrails Provider authentication for additional authentication methods.
Usage
Install Policy Pack
NoteBy default, installed policy packs are not attached to any resources.
Policy packs must be attached to resources in order for their policy settings to take effect.
Clone:
git clone https://github.com/turbot/guardrails-samples.gitcd guardrails-samples/policy_packs/aws/ec2/deny_unapproved_amis_publishers_for_instances
Run the Terraform to create the policy pack in your workspace:
terraform initterraform plan
Then apply the changes:
terraform apply
Apply Policy Pack
Log into your Guardrails workspace and attach the policy pack to a resource.
If this policy pack is attached to a Guardrails folder, its policies will be applied to all accounts and resources in that folder. The policy pack can also be attached to multiple resources.
For more information, please see Policy Packs.
Enable Enforcement
TipYou can also update the policy settings in this policy pack directly in the Guardrails console.
Please note your Terraform state file will then become out of sync and the policy settings should then only be managed in the console.
By default, the lockdown policy is set to Lockdown: Disabled
in the pack's policy settings. To enable automated enforcements, you can switch these policies settings by adding a comment to the Lockdown: Disabled
setting and removing the comment from one of the listed enforcement options:
resource "turbot_policy_setting" "aws_ec2_permissions_lockdown_instance_image" { resource = turbot_policy_pack.main.id type = "tmod:@turbot/aws-ec2#/policy/types/ec2PermissionsLockdownInstanceImage" # value = "Lockdown Disabled" # value = "Lockdown Enabled: Allow Image > AMI IDs only" # value = "Lockdown Enabled: Allow Image > Publishers only" # value = "Lockdown Enabled: Allow Image > AMI IDs or Image > Publishers" value = "Lockdown Enabled: Allow Image > AMI IDs from Image > Publishers"}
Then re-apply the changes:
terraform planterraform apply