You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cdn/cdn-verizon-premium-rules-engine-reference.md
+41-41Lines changed: 41 additions & 41 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,47 +22,6 @@ The rules engine is designed to be the final authority on how specific types of
22
22
- Secure or deny requests for sensitive content.
23
23
- Redirect requests.
24
24
- Store custom log data.
25
-
26
-
## Syntax
27
-
28
-
The manner in which special characters are treated varies according to how a match condition or feature handles text values. A match condition or feature may interpret text in one of the following ways:
29
-
30
-
-[**Literal values**](#literal-values)
31
-
-[**Wildcard values**](#wildcard-values)
32
-
-[**Regular expressions**](#regular-expressions)
33
-
34
-
### Literal values
35
-
36
-
Text that is interpreted as a literal value treats all special characters, with the exception of the % symbol, as a part of the value that must be matched. In other words, a literal match condition set to `\'*'\` is only satisfied when that exact value (that is, `\'*'\`) is found.
37
-
38
-
A percentage symbol is used to indicate URL encoding (for example, `%20`).
39
-
40
-
### Wildcard values
41
-
42
-
Text that is interpreted as a wildcard value assigns additional meaning to special characters. The following table describes how the following set of characters is interpreted:
43
-
44
-
Character | Description
45
-
----------|------------
46
-
\ | A backslash is used to escape any of the characters specified in this table. A backslash must be specified directly before the special character that should be escaped.<br/>For example, the following syntax escapes an asterisk: `\*`
47
-
% | A percentage symbol is used to indicate URL encoding (for example, `%20`).
48
-
\* | An asterisk is a wildcard that represents one or more characters.
49
-
Space | A space character indicates that a match condition may be satisfied by either of the specified values or patterns.
50
-
'value' | A single quote does not have special meaning. However, a set of single quotes is used to indicate that a value should be treated as a literal value. It can be used in the following ways:<br><br/>- It allows a match condition to be satisfied whenever the specified value matches any portion of the comparison value. For example, `'ma'` would match any of the following strings: <br/><br/>/business/**ma**rathon/asset.htm<br/>**ma**p.gif<br/>/business/template.**ma**p<br /><br />- It allows a special character to be specified as a literal character. For example, you may specify a literal space character by enclosing a space character within a set of single quotes (that is, `' '` or `'sample value'`).<br/>- It allows a blank value to be specified. Specify a blank value by specifying a set of single quotes (that is, '').<br /><br/>**Important:**<br/>- If the specified value does not contain a wildcard, then it is automatically considered a literal value, which means that it is not necessary to specify a set of single quotes.<br/>- If a backslash does not escape another character in this table, it is ignored when it is specified within a set of single quotes.<br/>- Another way to specify a special character as a literal character is to escape it using a backslash (that is, `\`).
51
-
52
-
### Regular expressions
53
-
54
-
Regular expressions define a pattern that is searched for within a text value. Regular expression notation defines specific meanings to a variety of symbols. The following table indicates how special characters are treated by match conditions and features that support regular expressions.
55
-
56
-
Special Character | Description
57
-
------------------|------------
58
-
\ | A backslash escapes the character the follows it, which causes that character to be treated as a literal value instead of taking on its regular expression meaning. For example, the following syntax escapes an asterisk: `\*`
59
-
% | The meaning of a percentage symbol depends on its usage.<br/><br/> `%{HTTPVariable}`: This syntax identifies an HTTP variable.<br/>`%{HTTPVariable%Pattern}`: This syntax uses a percentage symbol to identify an HTTP variable and as a delimiter.<br />`\%`: Escaping a percentage symbol allows it to be used as a literal value or to indicate URL encoding (for example, `\%20`).
60
-
\* | An asterisk allows the preceding character to be matched zero or more times.
61
-
Space | A space character is typically treated as a literal character.
62
-
'value' | Single quotes are treated as literal characters. A set of single quotes does not have special meaning.
63
-
64
-
Match conditions and features that support regular expressions accept patterns defined by Perl Compatible Regular Expressions (PCRE).
65
-
66
25
## Key concepts
67
26
Key concepts for setting up Rules Engine are described below.
68
27
### Draft
@@ -112,6 +71,47 @@ The workflow through which a policy may be applied to either the Production or S
112
71
|Deploy Request Review | <br>A deploy request undergoes automated validation and error detection.</br><br>Although the majority of deploy requests are automatically approved, manual review is required for more complex policies.</br> |
113
72
|Policy Deployment ([Staging](https://docs.vdms.com/cdn/index.html#HRE/Environment.htm#Staging)) | <br> Upon approval of a deploy request to the Staging environment, a policy will be applied to the Staging environment. This environment allows a policy to be tested against mock site traffic.</br><br>Once the policy is ready to be applied to live site traffic, a new deploy request for the Production environment should be submitted.</br> |
114
73
|Policy Deployment ([Production](https://docs.vdms.com/cdn/index.html#HRE/Environment.htm#Producti)) | Upon approval of a deploy request to the Production environment, a policy will be applied to the Production environment. This environment allows a policy to act as the final authority for determining how the CDN should handle live traffic. |
74
+
## Syntax
75
+
76
+
The manner in which special characters are treated varies according to how a match condition or feature handles text values. A match condition or feature may interpret text in one of the following ways:
77
+
78
+
-[**Literal values**](#literal-values)
79
+
-[**Wildcard values**](#wildcard-values)
80
+
-[**Regular expressions**](#regular-expressions)
81
+
82
+
### Literal values
83
+
84
+
Text that is interpreted as a literal value treats all special characters, with the exception of the % symbol, as a part of the value that must be matched. In other words, a literal match condition set to `\'*'\` is only satisfied when that exact value (that is, `\'*'\`) is found.
85
+
86
+
A percentage symbol is used to indicate URL encoding (for example, `%20`).
87
+
88
+
### Wildcard values
89
+
90
+
Text that is interpreted as a wildcard value assigns additional meaning to special characters. The following table describes how the following set of characters is interpreted:
91
+
92
+
Character | Description
93
+
----------|------------
94
+
\ | A backslash is used to escape any of the characters specified in this table. A backslash must be specified directly before the special character that should be escaped.<br/>For example, the following syntax escapes an asterisk: `\*`
95
+
% | A percentage symbol is used to indicate URL encoding (for example, `%20`).
96
+
\* | An asterisk is a wildcard that represents one or more characters.
97
+
Space | A space character indicates that a match condition may be satisfied by either of the specified values or patterns.
98
+
'value' | A single quote does not have special meaning. However, a set of single quotes is used to indicate that a value should be treated as a literal value. It can be used in the following ways:<br><br/>- It allows a match condition to be satisfied whenever the specified value matches any portion of the comparison value. For example, `'ma'` would match any of the following strings: <br/><br/>/business/**ma**rathon/asset.htm<br/>**ma**p.gif<br/>/business/template.**ma**p<br /><br />- It allows a special character to be specified as a literal character. For example, you may specify a literal space character by enclosing a space character within a set of single quotes (that is, `' '` or `'sample value'`).<br/>- It allows a blank value to be specified. Specify a blank value by specifying a set of single quotes (that is, '').<br /><br/>**Important:**<br/>- If the specified value does not contain a wildcard, then it is automatically considered a literal value, which means that it is not necessary to specify a set of single quotes.<br/>- If a backslash does not escape another character in this table, it is ignored when it is specified within a set of single quotes.<br/>- Another way to specify a special character as a literal character is to escape it using a backslash (that is, `\`).
99
+
100
+
### Regular expressions
101
+
102
+
Regular expressions define a pattern that is searched for within a text value. Regular expression notation defines specific meanings to a variety of symbols. The following table indicates how special characters are treated by match conditions and features that support regular expressions.
103
+
104
+
Special Character | Description
105
+
------------------|------------
106
+
\ | A backslash escapes the character the follows it, which causes that character to be treated as a literal value instead of taking on its regular expression meaning. For example, the following syntax escapes an asterisk: `\*`
107
+
% | The meaning of a percentage symbol depends on its usage.<br/><br/> `%{HTTPVariable}`: This syntax identifies an HTTP variable.<br/>`%{HTTPVariable%Pattern}`: This syntax uses a percentage symbol to identify an HTTP variable and as a delimiter.<br />`\%`: Escaping a percentage symbol allows it to be used as a literal value or to indicate URL encoding (for example, `\%20`).
108
+
\* | An asterisk allows the preceding character to be matched zero or more times.
109
+
Space | A space character is typically treated as a literal character.
110
+
'value' | Single quotes are treated as literal characters. A set of single quotes does not have special meaning.
111
+
112
+
Match conditions and features that support regular expressions accept patterns defined by Perl Compatible Regular Expressions (PCRE).
0 commit comments