IAM Tools
Back to All Operators

StringEqualsIfExists

StringEqualsIfExists

StringEqualsIfExists compares a string in a request to a list of strings in your policy. The comparision is case sensitive.

To match a request, the context key can be absent, but if present it must match at least one of the strings in your policy.

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

StringEqualsIfExists in an Allow Statement

Given the Policy Condition: 
"StringEqualsIfExists": {
  "aws:RequestTag/DataClass": [
    "public",
    "internal"
  ]
}
When the Request Context has:
aws:RequestTag/DataClass: null
Then the result is:
Allowed Allowed Assuming no explicit Deny elsewhere
Given the Policy Condition: 
"StringEqualsIfExists": {
  "aws:RequestTag/DataClass": [
    "public",
    "internal"
  ]
}
When the Request Context has:
aws:RequestTag/DataClass: public
Then the result is:
Allowed Allowed Assuming no explicit Deny elsewhere
Given the Policy Condition: 
"StringEqualsIfExists": {
  "aws:RequestTag/DataClass": [
    "public",
    "internal"
  ]
}
When the Request Context has:
aws:RequestTag/DataClass: private
Then the result is:
Not Allowed Not Allowed Statement does not apply

StringEqualsIfExists in a Deny Statement

Given the Policy Condition: 
"StringEqualsIfExists": {
  "aws:RequestTag/DataClass": [
    "public",
    "internal"
  ]
}
When the Request Context has:
aws:RequestTag/DataClass: null
Then the result is:
Denied Denied
Given the Policy Condition: 
"StringEqualsIfExists": {
  "aws:RequestTag/DataClass": [
    "public",
    "internal"
  ]
}
When the Request Context has:
aws:RequestTag/DataClass: public
Then the result is:
Denied Denied
Given the Policy Condition: 
"StringEqualsIfExists": {
  "aws:RequestTag/DataClass": [
    "public",
    "internal"
  ]
}
When the Request Context has:
aws:RequestTag/DataClass: private
Then the result is:
Not Denied Not Denied May be allowed by another statement