Rulesets
You can use rulesets to write policy so the workloads in your application can communicate with each other. A ruleset consists of rules and scopes:
Rules define which workloads are allowed to communicate.
Scopes define which workloads the rules are applied to.
Note
In previous releases, this feature was referred to as “Segmentation Rulesets.” In Illumio Core 21.5.0 and later releases, this feature is now referred to as “Rulesets.” Some images might still display the previous feature name.
Ruleset Scope
The scope of a ruleset determines which workloads receive the ruleset's rules and enables the rules in a ruleset to apply to workloads in a group (one scope).
When workloads share the same set of labels defined in a ruleset's scope, those workloads receive all the rules from the ruleset. When you add a second scope, all the workloads within both scopes receive the rules from the ruleset.
A single scope is defined by using three labels that identify the workload:
Application: To what application (for example, ERP or HRM) do these workloads belong?
Environment: Which type of environment (for example, development, production, or testing) describes these workloads?
Location: Where are these workloads located—either physically (for example, rack server or AWS) or geographically (for example, US, EU, or CA)?
Note
The Role label should not be used in the scope.
For example, a scope (or collection of workloads that the rules are applied to) is defined as ERP | Prod | US, which means that the rules apply to any workload that meets the following three requirements:
Workloads in the ERP application
Workloads in the Prod (Production) environment
Workloads in the US location
That example is relatively simple, but combining rules and scopes can be used to create complex security policies.
Single Ruleset Scopes
Using a single scope in a ruleset narrows the list of workloads that the rules apply to and allows workload cross-communication.
When you are defining rules, you have the option of using the “All” label in the scope. The “All” label applies to all instances of that label type (Application, Environment, or Location). For example, creating a rule with a scope of “All | All | All” means that the rule applies to all workloads.
When you create a rule with a scope of “HRM | All | US,” this rule applies only to workloads using the HRM and US labels, regardless of Environment (“All”). For example, the following ruleset:
Multiple Ruleset Scopes
Using multiple scopes in a ruleset applies the rules to each scope in isolation and does not allow workload cross-communication.
Combine Labels in Scopes and Rules
When the same type of label is used multiple times in a rule, they are expanded as multiple rules with one label for each rule.
The following examples further demonstrate how scopes work with rules.
Note
When the service in a rule is DNS, the consumer must be an IP Lists.
Ruleset Status
You can view the ruleset status on the Ruleset page. The current status of each ruleset (enabled or disabled) is displayed in the Status column. When you change a ruleset but haven't provisioned the change yet, the type of change (addition, deletion, or modification) appears in the Provision Status column with the word “Pending” to indicate that these changes must be provisioned to be applied.
Filter the Rulesets List
You can filter the rulesets list using the label and property filter at the top of the list. You can filter the list by entering a label type to show only those rulesets that use the selected labels. You can further filter the list by selecting specific properties of the rulesets. For example, you can filter the list by provision status, such as rulesets that are in draft state and have not yet been provisioned.

Create a Ruleset
You can create a ruleset to write rules that define the allowed communication between workloads in a single group or multiple groups. See Groups in Illumination in the Visualization Guide for information.
When you write a rule for a Windows workload, you can add a Windows service name without specifying a port or protocol and the rule will allow communication for that service over any port and protocol.
The following task creates a single scope, which means the rules in the ruleset apply to a single group. To apply the rules to another group, add a second scope, which is indicated by the group's Application, Environment, and Location labels.
To create a ruleset:
From the PCE web console menu, choose Rulesets and Rules > Rulesets.
The Rulesets page appears.
Click Add.
Enter a name for the ruleset.
Select Application, Environment, and Location labels for the ruleset.
These three labels define the scope for your ruleset, which is the range or boundary of your ruleset. The scope defines the workloads affected by this ruleset, which is all workloads that share the same labels in the scope.
Click Save.
Now that the ruleset is created, you can add rules to define your security policy. See Rules for information about the types of rules you can add.
Note
Illumio recommends creating no more than 500 rules per ruleset, or the PCE web console will not be able to display all of the rules.
If you want to create a ruleset with more than 500 rules, Illumio recommends splitting the rules across multiple rulesets or using the Illumio Core REST API, where there is no limit on the number of rules you can create per ruleset.
Create a Ruleset with Multiple Scopes
You can create rulesets with multiple scopes to define the allowed communication between workloads in one or more groups. See Groups in Illumination in the Visualization Guide for information.
How you define the scope in a ruleset enables you to write rules for workloads in multiple groups (two or more scopes). Each scope corresponds to one group. The scope defines the boundaries of the rules in the ruleset.
To create a multi-scope ruleset:
From the PCE web console menu, choose Rulesets and Rules > Rulesets.
The Rulesets list page appears.
Click Add.
Enter a name for the ruleset.
In the Scope section, set the Application, Environment, and Location label by selecting the them from the drop-down lists.
After you select the three labels, click Save.
The page refreshes and the Scopes and Rules tab appears.
Note
To edit the Scope, click the Edit button
.
To add another scope, click the Add icon (+).
A new row appears in the scopes section.
Set the Application, Environment, and Location labels for the new scope and click the Save icon at the end of the row.
The green Addition Pending icon that this addition is pending, so you need to provision the new ruleset in order for the rule to take effect. See Provisioning for more information.
Note
This task contains the steps to define multiple-scopes in the ruleset. For information about rules to the ruleset, see Rules.
Duplicate a Ruleset
When you have a ruleset that you want to use to create other new rulesets, you can duplicate an existing ruleset.
From the PCE web console menu, choose Rulesets and Rules > Rulesets.
The Ruleset list page appears.
Click the Scopes and Rules tab, and then click Duplicate Ruleset.
The Duplicate Ruleset page appears.
Rename the copy of the ruleset.
Note
The default name is “Copy of [Ruleset Name]” (where [Ruleset Name] is the name of the original Ruleset).
Click Save.
After saving the new duplicate ruleset, make any needed scope or rule changes and then provision to apply them. See Provisioning for more information.