Field name/value

Description

This match type allows you to match based on the following form parameters: field names and field values.

Cloudlets Supported

The Input Validation Cloudlet supports this match type.

Fields

This match type includes the following fields:

Name Description
Field Name The name of the field to validate.
Field Value The field value to validate. You can set up a match where a field value is not required, only the presence of a particular field name.

Wildcards

You can use the following wildcards in both Field Name and Field Value with all available operators:
Wildcard Description Example
* matches zero or more characters The rule includes one of the following matches:
  • a match with a contains or exists operator that has a field value of *Name.

  • a match with regex matches operator, that has a field value of .*Name.

Some possible valid results for this wildcard are First Name, Last Name, and Middle Name.
? matches a single character The rule includes one of the following matches:
  • a match with a contains or exists operator that has a field value of 201?.

  • a match with regex matches operator, that has a field value of 201.

A possible valid results for these two wildcards are 2015 and 2016. Some possible invalid results are: 20151 and 201502.

The wildcard syntax depends on the operator you select. You can use the * (multi-character) and ? (single character) wildcards in both the Field Name and Field Value fields when using the exists or contains operators. However, when you select the regex matches operator, you can enter a regular expression that uses the RE2 library.

Operators

This match type uses the following operators:

Value The Rule is True When... Example
contains the incoming request contains the value entered in the Field Value field. If the Field Value is jsmith, as long as the incoming request includes "jsmith“ as the value for the associated field name (like "Username”) the match is true.
exists the form field value is included in the incoming request. It doesn't matter whether there is an associated field value or no value at all. If the Field Name is Username, as long as the incoming request includes a “Username” field, the match is true.
regex matches the incoming request includes a form field name or value that matches the regular expression in the associated rule field. If the Field Name is Email Address and the Field Value is ^[A-Za-z0-9._%+-]+, the match is true only when the incoming request includes a well-formed email address in the Email Address field.