iam-policy-in-use
Checks whether the IAM policy ARN is attached to an IAM user, or a group with one or more IAM users, or an IAM role with one or more trusted entity.
Note
The AWS::IAM::User
resource type can only be recorded by Amazon Config in Regions where Amazon Config was available before February 2022. AWS::IAM::User
cannot be recorded in Regions supported by Amazon Config after February 2022.
Additionally, if you have selected to record AWS::IAM::User
in at least one Region, periodic rules such as this rule that report compliance on AWS::IAM::User
will run evaluations on AWS::IAM::User
in all Regions where the periodic rule is added, even if you have not enabled the recording of AWS::IAM::User
in the Region where the periodic rule was added.
You should only deploy this rule to one of the supported Regions to avoid unnecessary evaluations and API throttling. Not enabling the recording of global IAM resource types will not prevent this rule from running evaluations, if you have enable the recording of global IAM resource types in another Region. To avoid unnecessary evaluations, you should limit the deployment of this rule to one Region.
Identifier: IAM_POLICY_IN_USE
Resource Types: AWS::IAM::Policy
Trigger type: Periodic
Amazon Web Services Region: All supported Amazon regions except Africa (Cape Town), Middle East (UAE), Asia Pacific (Hyderabad), Asia Pacific (Osaka), Asia Pacific (Melbourne), Europe (Milan), Israel (Tel Aviv), Canada West (Calgary), Europe (Spain), Europe (Zurich) Region
Parameters:
- policyARN
- Type: String
-
An IAM policy ARN to be checked.
- policyUsageType (Optional)
- Type: String
-
Specify whether you expect the policy to be attached to an IAM user, group or role. Valid values are IAM_USER, IAM_GROUP, IAM_ROLE, or ANY. Default value is ANY.
Amazon CloudFormation template
To create Amazon Config managed rules with Amazon CloudFormation templates, see Creating Amazon Config Managed Rules With Amazon CloudFormation Templates.