Configuring a Pattern Set
To configure a pattern set, you must specify the strings that are to serve as patterns. You can manually assign a unique index value to each of these patterns, or you can allow the index values to be assigned automatically.
Note: Pattern sets are case sensitive (unless you specify the expression to ignore case). Therefore, the string pattern “product1,” for example, is not the same as the string pattern “Product1.”
Points to remember about index values:
- You cannot bind the same index value to more than one pattern.
- An automatically assigned index value is one number larger than the highest index value of the existing patterns within the pattern set. For example, if the highest index value of existing patterns in a pattern set is 104, the next automatically assigned index value is 105.
- If you do not specify an index for the first pattern, index value 1 is automatically assigned to that pattern.
- Index values are not regenerated automatically if one or more patterns are deleted or modified. For example, if the set contains five patterns, with indexes from 1 through 5, and if the pattern with an index of 3 is deleted, the other index values in the pattern set are not automatically regenerated to produce values from 1 through 4.
- The maximum index value that can be assigned to a pattern is 4294967290. If that value is already assigned to a pattern in the set, you must manually assign index values to any newly added patterns. An unused index value that is lower than a currently used value cannot be assigned automatically.
Configure a pattern set by using the command line interface
At the command prompt, do the following:
Create a pattern set.
add policy patset
Example:
add policy patset samplepatset
Bind patterns to the pattern set.
bind policy patset
[-index ][-charset ( ASCII | UTF_8 )] [-comment ]
Example:
bind policy patset samplepatset product1 -index 1 -comment short description about the pattern bound to the pattern set
Note: Repeat this step for all the patterns you want to bind to the pattern set.
- Verify the configuration.
show policy patset
Configure a pattern set by using the configuration utility
- Navigate toAppExpert>Pattern Sets.
- In the details pane, clickAddto open theCreate Pattern Setdialog box.
- Specify a name for the pattern set in the Name text box.
- Under Specify Pattern, type the first pattern and, optionally, specify values for the following parameters:
- Treat back slash as escape character—Select this check box to specify that any backslash characters that you might include in the pattern are to be treated as escape characters.
- Index—A user assigned index value, from 1 through 4294967290.
- Verify that you have entered the correct characters, and then clickAdd.
- Repeat steps 4 and 5 to add more patterns, and then clickCreate.
Configure file-based pattern sets
The Citrix ADC appliance supports file-based pattern sets.
Configure file-based pattern sets by using the CLI
At the command prompt, type the following commands:
Import a new pattern set file into the Citrix ADC appliance.
import policy patsetfile
-delimiter -charset Example:
import policy patsetfile local:test.csv clientids_list –delimiter ,
You can import a file from a local device, HTTP server, or FTP server. To add the file from your local device, the file must be available in
/var/tmp
location.Add a pattern set file to the packet engine.
add policy patsetfile
Example:
add policy patsetfile clientids_list
Update an existing pattern set file on the Citrix ADC appliance.
update policy patsetfile
Example:
update policy patsetfile clientids_list
Bind patterns to the pattern set.
add policy patset
-patsetfile Example:
add policy patset clientid_patset -patsetfile clientids_list
Verify the configuration.
show policy patsetfile clientids_list Name: clientids_list Patset Name: clientid_patset Number of Imported Patterns: 8 Number of Bound Patterns: 8 (All the patterns bound successfully) Done
Configure file-based pattern sets by using the GUI
Navigate toAppExpert-> Pattern Set Files.
In theImportedpane, clickImport.
In theConfigure Policy Patset Filepage, select the file you want to import, and clickOK.
Select the imported file, and clickAdd.
In theCreate Policy Patset Filepage, enter the details, and clickCreateto add a policy pattern set.