Security Policies

The input controls at the top of this page are described here: Policies & Rules Entry Administration. Specific editing of a Security Policy is described below.

Overview

This page specifies a list of URLs and the security policies assigned to them.

Every incoming HTTP/S request targets a specific URL. Curiefense finds the best match for that URL in the Security Policies, and applies the security policies defined for it.

The "best match" is determined by regex evaluation. The order in which the URLs are listed in the interface does not matter.

Components of a Security Policy

A Security Policy consists of:

  • Host definition: The (sub)domain(s) within which the Path Maps will be found.

  • Path Maps: one or more paths, and the security policies which will be applied to them.

The Default Security Policy

Every Curiefense deployment includes a default Security Policy. If a request does not match any other Security Policy, the default one is applied.

To ensure that a default always exists, the Matching Name and Path Map for this Security Policy are not editable.

Creating a Security Policy

To add a new Security Policy, use the buttons at the top of the window to duplicate an existing one or create a new one. Then fill in these fields.

Field

Value

Name

The name of the Security Policy for internal use.

Matching Names

A regex for the subdomain(s) and/or domain(s).

When you create or revise a Security Policy, each combination of Matching Name and Path Map must be unique. For this reason, when a new Security Policy is created, the UI generates a unique Matching Name.

This should be changed to a correct value before the Security Policy is saved.

Editing its Path Maps

A new Security Policy will include a default Path Map. Clicking on it, or on the expand button at the end of its listing, will expand it for editing.

To add a new Path Map, select an existing one, expand it, and select Fork Profile at the bottom. The existing one will be cloned, and the new one will be displayed for editing.

Note that the buttons at the top of the window are for administering Security Policies (which generally correspond to domains). Administering Path Maps (for paths and URLs within the specified domain) is done in the middle of the window.

Path Map Fields

Field

Value

Name

A descriptive label for use within the interface.

Match

An expression for the path, expressed as PCRE (Perl Compatible Regular Expressions). If several Path Map fields are defined for a Security Policy, the longest matching regexp will determine which Path Map gets selected. If no Match regexp matches, then the default Path Map will be selected, i.e. the Path Name whose name is __default__, or whose name is default and whose regex is /.

WAF

The WAF Policy applied to this path. Its name will be displayed in green if it is active; if displayed in red, it is currently disabled.

ACL

The ACL Policy applied to this path. Its name will be displayed in green if it is active; if displayed in red, it is currently disabled.

RL

The number of Rate Limits assigned to this resource.

In addition to editing the fields discussed above, the Path Mapping dialog also provides the ability to:

  • Activate or deactivate the WAF Policy (by toggling its Active Mode checkbox).

  • Activate or deactivate the ACL Policy (by toggling its Active Mode checkbox).

  • Assign an existing Rate Limit rule to this Path Map, via the + button or selecting the link ("To attach an existing rule, click here."), then selecting add. (The + button will only be shown if there are unassigned Rate Limit rules available.)

  • Create a new Rate Limit rule for this Path Map, by selecting the link ("To create a new rate-limit rule, click here.")

  • Remove an assigned Rate Limit Rule by selecting remove.

  • Create a copy of this Path Map, and open it for editing, via the Fork Profile button.

Last updated