Cookie

Description

The cookie match type allows matches based on cookie name and/or cookie value. You have the option of entering multiple cookie values for each cookie name.

Cloudlets Supported

All Cloudlets support this match type.

Fields

This match type includes these fields:

Name Description
Name Enter the name of the cookie to match on.
Value (optional) Enter the possible cookie values to match on.

If you don't list a values, a match happens if the request includes the cookie in the Name field.

If you have a large number of values, you can paste them in if you separate them with a space, comma, or carriage return.

Wildcards

You can use wildcards with the contains any of or does not contain any of operators.

The cookie match supports the following wildcards in the Value field:

Wildcard Description Example
* matches zero or more characters The rule includes a match where the cookie value is t*o. Some possible valid results for this wildcard are to, tAo, t123o
? matches a single character The rule includes a match where the cookie value is c?r. For this entry, cAr, or c1r are possible valid results.

Operators

This match type uses the following operators:

Value The Rule is True When... Example
is one of the incoming request includes a cookie that:
  • matches the entry in the Name field, or
  • contains any of the cookie values entered in the Value field.

If you selected Case Sensitive, then the cookie name and value have to match the case of the entry.

The rule includes a match where the cookie name is foo and the cookie value is bar, and case sensitivity has not been set. In this instance, the following values in the incoming request will be valid:
  • Name: too, tOo, tOO, toO, Too, TOo, TOO, ToO
  • Value: car, cAr, cAR, caR, Car, CAr, CAR, CaR
is not one of the incoming request doesn't include a cookie name or value combination that matches the entries in the Name and Value fields.

If you selected Case Sensitive, the rule is false when the requests' cookie name and value combination matches the case of the entry.

The rule includes a match where the cookie name is too and the cookie value is car, and case sensitivity has not been set. In this instance, all but the following values are valid:
  • Name: too, tOo, tOO, toO, Too, TOo, TOO, ToO
  • Value: car, cAr, cAR, caR, Car, CAr, CAR, CaR
contains any of the incoming request:
  • has a cookie that, at minimum, includes the entry in the Name field, or
  • contains any one of the cookie values entered in the Value field.

If you selected Case Sensitive, then the cookie name and value in the request are valid when the case of the characters matches that shown on the rules screen.

The rule includes a match where the cookie name is too, and case sensitivity has not been set. In this instance, any cookie name that includes too is true. For example, 123too45 would be valid. However, 123to45 would not.
does not contain any of the incoming request:
  • has a cookie that doesn't include any part of the value entered in the Name field, or
  • doesn't contain any one of the cookie values entered in the Value field.

If Case Sensitive is selected, the cookie name and value combination in the incoming request is true when the case of the characters does not match that shown on the rules screen.

The rule includes a match where the cookie name can't include too, and case sensitivity has not been set. In this instance, any cookie name that includes Too is invalid. For example, 123to45 would be valid. However, 123too45 wouldn't.