IAM Tools

ArnLike

ArnLike compares an ARN in a request to a list of ARN patterns in your policy. The policy values can include asterisks (*) to match multiple characters and question marks (?) to match a single character within an ARN segement. Wildcards cannot be used to span ARN segment, so the partition, service, region, account, and resource must all be present in your policy value, even if they are all wildcards. The comparision is case sensitive.

To match a request, the context key must exist in the request and must match at least one of the ARN patterns in your policy.

You can use policy variables in the value of this operator.

ArnLike in an Allow Statement

Click into any of these polices and change them test how they change the result.

Given the Policy Condition:

"ArnLike": {
  "aws:PrincipalArn": [
    "arn:aws:iam::*:role/*",
    "arn:aws:ec2:*:*:instance/i-?????"
  ]
}

When the Request Context has:

aws:PrincipalArn: null

Then the result is:

Not Allowed Statement does not apply

Given the Policy Condition:

"ArnLike": {
  "aws:PrincipalArn": [
    "arn:aws:iam::*:role/*",
    "arn:aws:ec2:*:*:instance/i-?????"
  ]
}

When the Request Context has:

aws:PrincipalArn: 
    arn:aws:iam::123456789012:role/AdminRole

Then the result is:

Allowed Assuming no explicit Deny elsewhere

Given the Policy Condition:

"ArnLike": {
  "aws:PrincipalArn": [
    "arn:aws:iam::*:role/*",
    "arn:aws:ec2:*:*:instance/i-?????"
  ]
}

When the Request Context has:

aws:PrincipalArn: 
    arn:aws:iam::123456789012:user/User

Then the result is:

Not Allowed Statement does not apply

ArnLike in a Deny Statement

Click into any of these polices and change them test how they change the result.

Given the Policy Condition:

"ArnLike": {
  "aws:PrincipalArn": [
    "arn:aws:iam::*:role/*",
    "arn:aws:ec2:*:*:instance/i-?????"
  ]
}

When the Request Context has:

aws:PrincipalArn: null

Then the result is:

Not Denied May be allowed by another statement

Given the Policy Condition:

"ArnLike": {
  "aws:PrincipalArn": [
    "arn:aws:iam::*:role/*",
    "arn:aws:ec2:*:*:instance/i-?????"
  ]
}

When the Request Context has:

aws:PrincipalArn: 
    arn:aws:iam::123456789012:role/AdminRole

Then the result is:

Denied

Given the Policy Condition:

"ArnLike": {
  "aws:PrincipalArn": [
    "arn:aws:iam::*:role/*",
    "arn:aws:ec2:*:*:instance/i-?????"
  ]
}

When the Request Context has:

aws:PrincipalArn: 
    arn:aws:iam::123456789012:user/User

Then the result is:

Not Denied May be allowed by another statement