Use custom rules to tailor how Security identifies malicious traffic. This provides added flexibility for threat identification that allows you to target malicious traffic with minimal impact to legitimate traffic. Custom threat identification combined with rapid testing and deployment enables you to quickly address long-term and zero-day vulnerabilities.
The Custom rules capability requires Edgio Enterprise, Edgio Premier, Security Premier, or Security Business. Contact your account manager or our sales department at 1 (866) 200 - 5463 to upgrade your account.
Edgio identifies a threat when a request satisfies at least one rule in a custom rule set. A rule is satisfied when a match is found for each of its conditions. A condition defines what will be matched (i.e., variable), how it will be matched (i.e., operator), and a match value.
A variable identifies the request element (e.g., request header, query string, or request body) that Edgio will analyze.
Example #1:
This example assumes that your custom rule set contains the following two rules:
Rule
Description
1
This rule contains a single condition with a single variable.
2
This rule contains the following conditions:
The first condition contains a single variable.
The second condition contains two variables.
Assuming the above configuration, Security identifies a threat under either of the following circumstances:
A match is found for the variable defined in the first rule’s condition.
A match is found for the variable defined in the second rule’s first condition.
AND
A match is found for either of the variables defined in the second rule’s second condition.
Certain variables match on key-value pairs. If you match on multiple keys within a single variable, Edgio will only need to find one of those matches to satisfy that variable. For example, if you set up a request header variable to match for Authorization and Content-Type, then requests that contain either or both of those headers will satisfy that variable.
A variable identifies the request element that Edgio will analyze.
Key information:
All variables support the ability to match on the number of times that a request element is found within the request. Set up a variable to match on the number of instances instead of inspecting the element for a specific value or regular expression pattern by marking the Count option.
You may define zero or more keys when setting up variables that match on key-value pairs. Edgio must find at least one of the specified keys in the request before that variable will be satisfied.
For example, if you set up a request header variable to match for Authorization and Content-Type, then requests that contain either or both of those headers will satisfy that variable.
Match against all or specific key-value pair(s) in the request body for a URL-encoded or JSON POST request:
All: Do not specify a key within this variable and specify the desired value or pattern within the Match value option.
Specific Key-Value Pair: Define the name of the desired key within this variable and specify the desired value or pattern within the Match value option.
Setting up a request body parsed variable also allows you to define whether Edgio uses a regular expression, a negative match, or both when comparing the value assigned to the variable against key names. Use a negative match to find requests whose payload does not contain the specified key.
Use the Request body raw variable to match against the URL-encoded request body for any type of request (e.g., XML).
Edgio only inspects the first 8 KB of the request body. You may restrict the request body for valid requests to 8 KB (8,192 bytes) through an access rule.
Example:
Match against the following request body by setting the the Match value option to blue. Require that this value be assigned to the sky key by also setting the request body parsed variable to sky.
Match against a URL-encoded request body for any type of request (e.g., XML).
Edgio only inspects the first 8 KB of the request body. You may restrict the request body for valid requests to 8 KB (8,192 bytes) through an access rule.
All: Match against all cookies by not specifying a cookie name within this variable. Specify the desired cookie value or pattern within the Match value option.
Specific Cookies: Define the name of the desired cookie within this variable and specify the desired cookie value or pattern within the Match value option.
Setting up a cookie variable also allows you to define whether Edgio uses a regular expression, a negative match, or both when comparing the value assigned to the variable against cookies. Use a negative match to find requests that do not contain the specified cookie.
All: Match against all request headers by not specifying a request header name within this variable. Specify the desired header value or pattern within the Match value option.
Specific Request Headers: Define the name of the desired request header within this variable and specify the desired header value or pattern within the Match value option.
Setting up a request header variable also allows you to define whether Edgio uses a regular expression, a negative match, or both when comparing the value assigned to the variable against request headers. Use a negative match to find requests that do not contain the specified request header.
Match against the request’s URL path and query string. Define a URL path that starts directly after the hostname. Exclude the protocol and hostname when defining this property.
Sample values:/marketing?id=123456 and /resources/images
Match against the request’s URL path. Define a URL path that starts directly after the hostname. Exclude the protocol, hostname, and query string when defining this property.
Default: By default, Edgio compares a match value against the request element identified by a variable (e.g., URL path or a request header’s value).
Count: Enable the Count option on a variable to compare this value against the number of times that the request element identified by a variable (e.g., a specific cookie or request header) occurs within the request.
Example:
This example assumes the following configuration:
1Variable: Request header = Authentication
2Match value: 1
We will now examine how the Count option affects comparisons for this configuration.
Disabled: If the Count option has been disabled on the variable, then Edgio will compare the value of the
Authentication request header to 1.
Enabled: If the Count option has been enabled on the variable, then Edgio will compare the number of times that the Authentication request header occurred in the request to 1.
The type of comparison that will be performed is determined by the Operator option.
Edgio can transform the source value before it inspects it. Select one or more of the following transformations to allow Edgio to compare the match value against the result of each selected transformation:
Lowercase: Converts all uppercase characters to lowercase characters.
None: The source value will not be modified.
Remove nulls: Removes all null values from the source value.
URL decode: Applies URL decoding to the source value. This transformation is useful when the source value has been URL encoded twice.
You may create, modify, and delete custom rule sets.
Key information:
Administer custom rule sets from the Custom Rules page.
Apply a custom rule set to production traffic by adding it to a Security Application configuration and then determining how it will be enforced. Multiple Security Application configurations may use the same custom rule set. Leverage this capability to tailor security screening by application or traffic profile.
It may take up to 2 minutes for an updated custom rule set to be applied across our entire network.
To create a custom rule set
Navigate to the Custom Rules page.
From the Edgio Console, select the desired organization.
From the Security section, click Custom Rules.
Click + New Custom Ruleset.
In the Name option, type the unique name by which this custom rule set will be identified. This name should be sufficiently descriptive to identify it when setting up a Security Application configuration.
By default, a blank rule is associated with each new custom rule. Find the rule’s Rule message option and set it to a brief description that identifies the purpose of this rule.
In the Rule ID option, specify a number between 66,000,000 and 66,999,999.
The default rule contains a default condition. Modify this condition to determine how Edgio will identify threats.
From the condition’s Variable option, select the request element through which Edgio will identify threats.
Certain variables (e.g., request cookies and request header) match on name and value. If you have selected this type of variable, then perform the following steps:
For example, match for requests that contain an Authorization header by setting this option to Authorization.
Optional. Mark the Negative Match option to match for requests that do not contain a matching value for the name defined in the previous step.
If you specified a regular expression in the Name option, then you should mark the Regex Match option.
Optional. Add another match through which this variable can be satisfied by repeating steps 6.ii.a - 6.ii.e.
From the Operator option, select an operator that determines how Edgio will compare the match value to the request element identified by the above variable.
In the Match value option, type either of the following values:
Count Option - Disabled: Type the value that will be compared against the value associated with the request element identified by the variable selected above.
Count Option - Enabled: Type the number of instances that a match must be found within a single request.
For example, if you are counting the Set-Cookie header, then this numerical value determines the number of times that the Set-Cookie header must be found within a request.
From the Match transformations option, select each transformation that will be applied to the source value.
Optional. Mark the Negative Match option to match for requests that do not contain a matching value for the value defined in step 6.iv.
Optional. Click + Add Condition to add another condition that must be met before a request can be flagged as a threat. Repeat step 6 for this new condition.
Optional. Click + Add Rule to add another rule through which Edgio may identify threats. Repeat steps 6 and 7.
Click Save.
To modify a custom rule set
Navigate to the Custom Rules page.
From the Edgio Console, select the desired organization.
From the Security section, click Custom Rules.
Click on the desired custom rule set.
Make the desired changes.
Key tasks:
Delete a variable by clicking Delete Variable.
Delete a match within a variable by clicking the icon.
Delete a condition by clicking Delete Condition.
A rule must have at least one condition.
Delete a rule by clicking the icon that appears to the right of the Name option and then clicking Confirm.
Click Save.
To delete a custom rule set
You cannot delete a custom rule that is associated with a Security Application configuration. Please either modify the Security Application configuration to point to a different custom rule or delete that Security Application configuration.
Check your Security Application configurations to verify that the desired custom rule is not in use.
Navigate to the Custom Rules page.
From the Edgio Console, select the desired organization.
Compare a previous version of a configuration to the current version.
Edgio Security Premier and Business support a rolling window of up to 200 versions, while Edgio Security Essentials and Insights is restricted to a rolling window of up to 100 versions.
An advantage of using version control is that it allows you to quickly roll back to a previously vetted configuration. For example, if you notice that a new configuration has resulted in more false positives, then you can roll back to the previous version before analyzing the data.
To view, compare, and reactivate a previous configuration
Load the desired security configuration (e.g., access rule, rate rule, or custom rule).
Click Versions.
Click on the desired version to view it.
Optional. Compare the version selected in the previous step to the current version by clicking Diff. Differences between those two versions are highlighted in green (new or updated lines) and red (modified or deleted lines).
Optional. Reactivate the version selected in step 3 by clicking Reactivate. Click Reactivate this version to confirm that it will be reactivated.
