AWSQuickSetupSSMHostMgmtPermissionsBoundary

OperatorAWS managedActivePermissions reviewedShow on map Compare

Summary

Quick Setup creates IAM roles which enable it to configure the Host Manager Quick Setup type on your behalf, and uses this policy when creating such roles to define the boundary of their permissions.

Permissions imported from the AWS Managed Policy Reference Guide; other sections pending editorial review.

Identity

ARN: arn:aws:iam::aws:policy/AWSQuickSetupSSMHostMgmtPermissionsBoundary
Default version: v1
Created: 2024-06-26
Last edited: 2024-06-26
Services: compute-optimizer, config, ec2, iam, ssm, support

Control-plane actions (26)

By access level: 6 List, 2 Permissions management, 7 Read, 11 Write.

Control-plane actions by service
Service	Granted	Access levels and limits	Granted by
Compute Optimizer	1 of 28	1 List; 0 restricted, 0 conditional	compute-optimizer:GetEnrollmentStatus
Config	1 of 102	1 Read; 0 restricted, 0 conditional	config:DescribeConfigurationRecorders
EC2	4 of 834	2 List, 2 Write; 2 restricted, 2 conditional	ec2:AssociateIamInstanceProfile, ec2:DescribeIamInstanceProfileAssociations, ec2:DescribeInstances, ec2:DisassociateIamInstanceProfile
IAM	14 of 190	2 List, 2 Permissions management, 3 Read, 7 Write; 9 restricted, 7 conditional	iam:AddRoleToInstanceProfile, iam:AttachRolePolicy, iam:CreateInstanceProfile, iam:CreateRole, iam:CreateServiceLinkedRole, iam:DeleteRole, iam:DetachRolePolicy, iam:GetInstanceProfile, iam:GetRole, iam:GetRolePolicy, iam:ListInstanceProfilesForRole, iam:ListRoles and 2 more
Systems Manager	5 of 164	1 List, 2 Read, 2 Write; 3 restricted, 0 conditional	ssm:GetAutomationExecution, ssm:GetServiceSetting, ssm:ListTagsForResource, ssm:StartAutomationExecution, ssm:UpdateServiceSetting
Support	1 of 39	1 Read; 0 restricted, 0 conditional	support:DescribeTrustedAdvisorChecks

Compute Optimizer: 1 actions

compute-optimizer:GetEnrollmentStatus (List)

Config: 1 actions

config:DescribeConfigurationRecorders (Read)

EC2: 4 actions

ec2:AssociateIamInstanceProfile (Write)
ec2:DescribeIamInstanceProfileAssociations (List)
ec2:DescribeInstances (List)
ec2:DisassociateIamInstanceProfile (Write)

IAM: 14 actions

iam:AddRoleToInstanceProfile (Write)
iam:AttachRolePolicy (Permissions management)
iam:CreateInstanceProfile (Write)
iam:CreateRole (Write)
iam:CreateServiceLinkedRole (Write)
iam:DeleteRole (Write)
iam:DetachRolePolicy (Permissions management)
iam:GetInstanceProfile (Read)
iam:GetRole (Read)
iam:GetRolePolicy (Read)
iam:ListInstanceProfilesForRole (List)
iam:ListRoles (List)
iam:PassRole (Write)
iam:UpdateRole (Write)

Systems Manager: 5 actions

ssm:GetAutomationExecution (Read)
ssm:GetServiceSetting (Read)
ssm:ListTagsForResource (List)
ssm:StartAutomationExecution (Write)
ssm:UpdateServiceSetting (Write)

Support: 1 actions

support:DescribeTrustedAdvisorChecks (Read)

Data-plane actions (0)

By access level: none.

This policy grants no actions in this plane.

Excluded and conditional actions

No patterns are excluded by NotAction or Deny statements.

Resource scope and attachment

Resource scope across granted actions: mixed.

Can be attached: Yes, to users, groups and roles.

Why this tier

Grants 13 write, tagging or permissions-management actions, short of full control of any service.
Grants iam:PassRole, but only for scoped roles or under conditions (for example iam:PassedToService).
Grants permissions-management actions on iam, but only for scoped resources or under conditions.

Guidance

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Same service

Same domain

Frequently asked questions

Pending editorial review. The permission data on this page comes straight from AWS; this section will be filled in once a reviewed guide exists.

Policy JSON

Download policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "HostManagementAutomationRoleGetPermissions",
      "Effect": "Allow",
      "Action": [
        "iam:GetRole"
      ],
      "Resource": [
        "arn:aws:iam::*:role/AWS-QuickSetup-HostMgmtRole-*"
      ]
    },
    {
      "Sid": "HostManagementAutomationRolePassPermissions",
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": [
        "arn:aws:iam::*:role/AWS-QuickSetup-HostMgmtRole-*"
      ],
      "Condition": {
        "StringEquals": {
          "iam:PassedToService": [
            "ssm.amazonaws.com"
          ]
        }
      }
    },
    {
      "Sid": "DefaultInstanceRoleManagePermissions",
      "Effect": "Allow",
      "Action": [
        "iam:CreateRole",
        "iam:DeleteRole",
        "iam:UpdateRole",
        "iam:GetRole"
      ],
      "Resource": [
        "arn:aws:iam::*:role/AmazonSSMRoleForInstancesQuickSetup"
      ],
      "Condition": {
        "StringLike": {
          "aws:PrincipalTag/QuickSetupManagerID": "*"
        },
        "ArnLike": {
          "aws:PrincipalArn": "arn:aws:iam::*:role/AWS-QuickSetup-HostMgmtRole-*"
        }
      }
    },
    {
      "Sid": "DefaultInstanceRolePassToEC2Permissions",
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": [
        "arn:aws:iam::*:role/AmazonSSMRoleForInstancesQuickSetup"
      ],
      "Condition": {
        "StringEquals": {
          "iam:PassedToService": [
            "ec2.amazonaws.com"
          ]
        }
      }
    },
    {
      "Sid": "DefaultInstanceRolePassToSSMPermissions",
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": [
        "arn:aws:iam::*:role/AmazonSSMRoleForInstancesQuickSetup"
      ],
      "Condition": {
        "StringEquals": {
          "iam:PassedToService": [
            "ssm.amazonaws.com"
          ]
        }
      }
    },
    {
      "Sid": "InstanceManagementPoliciesAttachPermissions",
      "Effect": "Allow",
      "Action": [
        "iam:AttachRolePolicy",
        "iam:DetachRolePolicy"
      ],
      "Condition": {
        "ArnEquals": {
          "iam:PolicyARN": [
            "arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore",
            "arn:aws:iam::aws:policy/AmazonSSMPatchAssociation"
          ]
        },
        "StringLike": {
          "aws:PrincipalTag/QuickSetupManagerID": "*"
        },
        "ArnLike": {
          "aws:PrincipalArn": "arn:aws:iam::*:role/AWS-QuickSetup-HostMgmtRole-*"
        }
      },
      "Resource": "arn:aws:iam::*:role/*"
    },
    {
      "Sid": "CreateSystemsManagerSLRPermissions",
      "Effect": "Allow",
      "Action": [
        "iam:CreateServiceLinkedRole"
      ],
      "Resource": [
        "arn:aws:iam::*:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM"
      ],
      "Condition": {
        "StringEquals": {
          "iam:AWSServiceName": "ssm.amazonaws.com"
        }
      }
    },
    {
      "Sid": "DefaultInstanceRoleAddPermissions",
      "Effect": "Allow",
      "Action": [
        "iam:AddRoleToInstanceProfile"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Sid": "IAMReadOnlyPermissions",
      "Effect": "Allow",
      "Action": [
        "iam:GetInstanceProfile",
        "iam:GetRolePolicy",
        "iam:ListInstanceProfilesForRole",
        "iam:ListRoles"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Sid": "DefaultInstanceProfileCreatePermissions",
      "Effect": "Allow",
      "Action": [
        "iam:CreateInstanceProfile"
      ],
      "Resource": [
        "arn:aws:iam::*:instance-profile/AmazonSSMRoleForInstancesQuickSetup"
      ]
    },
    {
      "Sid": "DefaultInstanceProfileAssociationPermissions",
      "Effect": "Allow",
      "Action": [
        "ec2:AssociateIamInstanceProfile"
      ],
      "Resource": "*",
      "Condition": {
        "Null": {
          "ec2:InstanceProfile": "true"
        },
        "ArnLike": {
          "ec2:NewInstanceProfile": "arn:aws:iam::*:instance-profile/AmazonSSMRoleForInstancesQuickSetup"
        }
      }
    },
    {
      "Sid": "DefaultInstanceProfileDisassociationPermissions",
      "Effect": "Allow",
      "Action": [
        "ec2:DisassociateIamInstanceProfile"
      ],
      "Resource": "*",
      "Condition": {
        "ArnLike": {
          "ec2:InstanceProfile": "arn:aws:iam::*:instance-profile/AmazonSSMRoleForInstancesQuickSetup"
        }
      }
    },
    {
      "Sid": "ConfigurationAutomationsStartPermissions",
      "Effect": "Allow",
      "Action": [
        "ssm:StartAutomationExecution"
      ],
      "Resource": [
        "arn:aws:ssm:*:*:automation-definition/AWSQuickSetup-HostMgmt-*",
        "arn:aws:ssm:*:*:automation-definition/AWSQuickSetup-CreateAndAttachIAMToInstance-*",
        "arn:aws:ssm:*:*:automation-definition/AWSQuickSetup-UpdateExistingInstanceProfile-*",
        "arn:aws:ssm:*:*:automation-definition/AWSQuickSetup-InstallAndManageCloudWatchDocument-*",
        "arn:aws:ssm:*:*:automation-definition/UpdateCloudWatchDocument-*",
        "arn:aws:ssm:*:*:automation-definition/AWSEC2-UpdateLaunchAgent-*",
        "arn:aws:ssm:*:*:automation-definition/AWS-AttachIAMToInstance*",
        "arn:aws:ssm:*:*:automation-definition/AWS-GatherSoftwareInventory*",
        "arn:aws:ssm:*:*:automation-definition/AWS-RunPatchBaselineAssociation*",
        "arn:aws:ssm:*:*:automation-definition/AWS-UpdateSSMAgent*"
      ]
    },
    {
      "Sid": "ReadOnlyPermissionsForEnablingHostManagementBySSM",
      "Effect": "Allow",
      "Action": [
        "ssm:ListTagsForResource",
        "ssm:GetAutomationExecution",
        "ec2:DescribeIamInstanceProfileAssociations",
        "ec2:DescribeInstances"
      ],
      "Resource": "*"
    },
    {
      "Sid": "ReadOnlyPermissionsForEnablingExplorer",
      "Effect": "Allow",
      "Action": [
        "config:DescribeConfigurationRecorders",
        "compute-optimizer:GetEnrollmentStatus",
        "support:DescribeTrustedAdvisorChecks"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SSMExplorerServiceSettingsPermissions",
      "Effect": "Allow",
      "Action": [
        "ssm:UpdateServiceSetting",
        "ssm:GetServiceSetting"
      ],
      "Resource": [
        "arn:aws:ssm:*:*:servicesetting/ssm/opsitem/ssm-patchmanager",
        "arn:aws:ssm:*:*:servicesetting/ssm/opsitem/EC2",
        "arn:aws:ssm:*:*:servicesetting/ssm/opsdata/ExplorerOnboarded",
        "arn:aws:ssm:*:*:servicesetting/ssm/opsdata/Association",
        "arn:aws:ssm:*:*:servicesetting/ssm/opsdata/ComputeOptimizer",
        "arn:aws:ssm:*:*:servicesetting/ssm/opsdata/ConfigCompliance",
        "arn:aws:ssm:*:*:servicesetting/ssm/opsdata/OpsData-TrustedAdvisor",
        "arn:aws:ssm:*:*:servicesetting/ssm/opsdata/SupportCenterCase"
      ]
    }
  ]
}

Version history

Current version v1, edited by AWS on 2024-06-26. Version history is recorded from 2026-11-11. Earlier versions are in the IAM console under Policy versions.

Attach snippets

AWS CLI

aws iam attach-role-policy --role-name ROLE_NAME --policy-arn arn:aws:iam::aws:policy/AWSQuickSetupSSMHostMgmtPermissionsBoundary
aws iam attach-user-policy --user-name USER_NAME --policy-arn arn:aws:iam::aws:policy/AWSQuickSetupSSMHostMgmtPermissionsBoundary
aws iam attach-group-policy --group-name GROUP_NAME --policy-arn arn:aws:iam::aws:policy/AWSQuickSetupSSMHostMgmtPermissionsBoundary

CloudFormation

Resources:
  ExampleRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument: {}  # replace with your trust policy
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/AWSQuickSetupSSMHostMgmtPermissionsBoundary

Terraform

resource "aws_iam_role_policy_attachment" "awsquicksetupssmhostmgmtpermissionsboundary" {
  role       = aws_iam_role.example.name
  policy_arn = "arn:aws:iam::aws:policy/AWSQuickSetupSSMHostMgmtPermissionsBoundary"
}

CDK (TypeScript)

role.addManagedPolicy(
  iam.ManagedPolicy.fromAwsManagedPolicyName("AWSQuickSetupSSMHostMgmtPermissionsBoundary"),
);

Sources

Pending editorial review. No editorial sources are listed yet.