You can use the filter keys below to define an archive rule (CreateArchiveRule
), update an archive rule (UpdateArchiveRule
), retrieve a list of findings (ListFindings
and ListFindingsV2
), or retrieve a list of access preview findings
for a resource (ListAccessPreviewFindings
). There is no difference between
using IAM API and AWS CloudFormation for configuring archive rules.
Criterion | AWS Management Console field | Description | Type | Archive rule | List findings | List access preview findings |
---|---|---|---|---|---|---|
resource | Resource | The ARN uniquely identifying the resource that the external principal has access to. To learn more, see Amazon resource names (ARNs). | String | |||
resourceType
|
Resource Type | The type of resource that the external principal has access to. | String | |||
resourceOwnerAccount | Resource Owner Account | The 12 digit AWS account ID that owns the resource. To learn more, see AWS account identifiers. | String | |||
isPublic | Public access | Indicates whether the finding reports a resource that has a policy that allows public access. | Boolean | |||
findingType
|
Findings type | The type of the finding. You can only filter by finding type for unused access findings. | String | |||
resourceControlPolicyRestriction
|
Resource control policy (RCP) restriction | The type of restriction applied by the resource owner with an Organizations resource control policy (RCP). You can only filter by RCP restriction for external acccess findings. | String | |||
status
|
Status | The current status of the finding. | String | |||
error | Error | Indicates the error reported for the finding. | String | |||
principal.AWS | AWS Account | The account granted access to the resource in the Principal
field of the finding. Enter the 12-digit AWS account ID or the ARN of the
external AWS user or role. To learn more, see AWS account
identifiers. |
String | |||
principal.Federated | Federated User | The ARN of the federated identity that has access to the resource in the finding. To learn more, see Identity providers and federation | String | |||
condition.aws:PrincipalArn | Principal ARN | The ARN of the principal (IAM user, role, or group) indicated as the condition for resource access. To learn more, see AWS global condition context keys. | String | |||
condition.aws:PrincipalOrgID | Principal OrgID | The organization identifier of the principal indicated as the condition for resource access. To learn more, see AWS global condition context keys. | String | |||
condition.aws:PrincipalOrgPaths | Principal OrgPaths | The organization or organizational unit (OU) ID indicated as the condition for resource access. To learn more, see AWS global condition context keys. | String | |||
condition.aws:SourceIp | Source IP | The IP address that allows the principal access to the resource when using the specified IP address. To learn more, see AWS global condition context keys. | IP address | |||
condition.aws:SourceVpc | Source VPC | The VPC ID that allows the principal access to the resource when using the specified VPC. To learn more, see AWS global condition context keys. | String | |||
condition.aws:UserId | User ID | The user ID of the IAM user from an external account indicated as the condition for access to the resource. To learn more, see AWS global condition context keys. | String | |||
condition.cognito-identity.amazonaws.com:aud | Cognito Audience | The Amazon Cognito identity pool ID specified as a condition for IAM role access in the finding. To learn more, see IAM and AWS STS condition context keys. | String | |||
condition.graph.facebook.com:app_id | Facebook App ID | The Facebook application ID (or site ID) specified as a condition to allow Login with Facebook federation access to the IAM role in the finding. To learn more, see IAM and AWS STS condition context keys. | String | |||
condition.accounts.google.com:aud | Google Audience | The Google application ID specified as a condition for access to the IAM role. To learn more, see IAM and AWS STS condition context keys. | String | |||
condition.kms:CallerAccount | KMS Key ID | The AWS account ID that owns the calling entity (IAM user, role or account root user) used by services calling AWS KMS. To learn more, see Condition keys for AWS Key Management Service. | String | |||
condition.www.amazon.com:app_id | Amazon App ID | The Amazon application ID (or site ID) specified as a condition to allow Login with Amazon federation access to the role. To learn more, see | String | |||
id | Finding ID | The ID of the finding. | String | |||
changeType
|
Provides context on how the access preview finding compares to existing access identified in IAM Access Analyzer. | String | ||||
existingFindingId | The existing ID of the finding in IAM Access Analyzer, provided only for existing findings in the access preview. | String | ||||
existingFindingStatus | The existing status of the finding, provided only for existing findings in the access preview. | String |