Event priorities
A priority rule set gives the event types you care about an importance from 1 to 5. You apply the rule set to chosen tenants, or make it the workspace default. Matching events are flagged in the event feed and are rated and sorted by your score, not by the provider’s severity.
A rule set does not hide events, stop events or change alerts. It changes how events are rated and flagged on screen.
Who can do what
Section titled “Who can do what”| Task | Admin | Member | Viewer |
|---|---|---|---|
| Open Event priorities and read the rule sets | Yes | Yes | Yes |
| Create, edit or delete a rule set | Yes | No | No |
| Apply a rule set to tenants or make it the default | Yes | No | No |
| See flags and use Flagged only in the feed | Yes | Yes | Yes |
Members and viewers see the banner Read-only: only workspace admins can change event priorities. and no buttons.
Event priorities are available on every plan. They do not need a platform operator to switch them on.
Where to find it
Section titled “Where to find it”Open Event priorities under Workspace in the sidebar. The page has one card, Priority rule sets, with a card for each rule set.
With no rule sets the page reads No priority rule sets yet and Create one to re-rank the events that matter for a specific tenant.
How a rule is matched
Section titled “How a rule is matched”A rule matches an event on three things together: the tenant, the provider and the exact event type.
Identiguard chooses the rating for an event in this order:
- The rule set applied to the event’s tenant, if that rule set scores the event type.
- Otherwise the workspace default rule set, if the tenant has no rule set of its own and the default scores the event type.
- Otherwise the event’s severity. See Severity and risk rating.
A tenant belongs to one rule set at a time. Only one rule set can be the workspace default.
Create a rule set
Section titled “Create a rule set”- Open Event priorities under Workspace.
- Choose New rule set. The New rule set dialog opens.
- Enter a Rule set name. It is required, from 1 to 100 characters, and must be unique in the workspace.
- Optionally enter a Description. Text after 500 characters is cut.
- Under Event importance, choose the provider in the drop-down: Okta, Auth0 or Microsoft Entra ID.
- Type in Filter event types… to find an event type.
- In the Importance column, choose 1, 2, 3, 4 or 5 for that event type. Leave the others at Default.
- Repeat for another provider if you need to. Your choices are kept when you switch provider, so one rule set can cover several providers.
- Under Apply to tenants, tick the tenants. Or switch on Use as workspace default.
- Choose Save rule set. The button is disabled until you enter a name.
You see Rule set created. and a new card on the page.
The fields in the dialog
Section titled “The fields in the dialog”| Field | Meaning |
|---|---|
| Rule set name | Required. 1 to 100 characters. Unique in the workspace. |
| Description | Optional. Up to 500 characters. |
| Use as workspace default | A switch. Applies to every tenant without its own rule set, including tenants added later. Switching it on for one rule set removes it from the rule set that had it. |
| Event importance ({n} scored) | The table of event types. The number is how many types you have scored. |
| Event type | The provider’s name for the event |
| Baseline severity | The severity Identiguard records for this type when the provider does not send one. Unclassified means there is no baseline. |
| Importance | Default, 1, 2, 3, 4 or 5. Default means this rule set has no rule for the type. |
| Apply to tenants | A tick box for each tenant, with its provider |
The note under Apply to tenants reads A tenant belongs to one rule set at a time. Selecting a tenant another rule set already covers moves it here.
If the workspace has no tenants, the section reads No tenants yet and Turn on the workspace default above and this rule set will apply to tenants as you add them.
If the filter finds nothing, the table reads No event types match that filter.
Read a rule set card
Section titled “Read a rule set card”| Part | Meaning |
|---|---|
| The name | The rule set name |
| Workspace default | A badge on the default rule set |
| The description | Or No description |
| {n} rules | How many event types the rule set scores |
| Applied to: {tenant names} | The tenants the rule set covers |
| Applied to every tenant without its own rule set. | Shown for the workspace default |
| Not applied to any tenant yet. | The rule set does nothing until you apply it |
| Edit and Delete | Admins only |
Edit a rule set
Section titled “Edit a rule set”- On the rule set’s card, choose Edit. The same dialog opens with the title Edit rule set.
- Change the name, the importance values, the tenants or the default switch.
- Choose Save rule set.
You see Rule set updated.
Move a tenant to another rule set
Section titled “Move a tenant to another rule set”- Choose Edit on the rule set that should cover the tenant.
- Under Apply to tenants, tick the tenant.
- Choose Save rule set.
The tenant leaves its old rule set. You do not need to edit the old rule set.
Delete a rule set
Section titled “Delete a rule set”- On the rule set’s card, choose Delete.
- Read the confirmation Delete “{name}”? It says that events from these tenants are no longer flagged, that open feeds pick up the change when they next load or regain focus, and that the stored events do not change.
- Choose Delete.
You see Rule set deleted. You can create the rule set again at any time.
Limits
Section titled “Limits”| Limit | Value |
|---|---|
| Rules in one rule set | 200 |
| Tenants in one rule set | 200. Use the workspace default to cover more. |
| Importance | A whole number from 1 to 5 |
| Event types | Only the event types in the list for that provider |
| Workspace default | One rule set |
| Rule sets for one tenant | One |
| Number of rule sets | No limit was found |
How it shows in the feed
Section titled “How it shows in the feed”For an event that a rule matched:
- The row has a coloured left border.
- Risk Rating shows your score as
{n}/5with a small flag icon. Hover over the flag to read Priority set by rule set {name}. - The Severity column still shows the provider’s severity.
- Sorting by Risk Rating uses your score.
- Flagged only shows only matched events. It shows every matched event, including those you scored 1 or 2.
- Event Details shows Analyst priority as {n}/5 set by rule set {name}.
- Alex and AI clients are given the same score.
A rule works in both directions. It can raise an INFO event to 5, and it can lower a CRITICAL event to 1.
What a rule set does not change
Section titled “What a rule set does not change”- The stored event and its severity.
- Which alerts are sent. Alert channels filter on severity.
- Incidents and their scores.
- Which events arrive. To reduce events, see Quieten noisy alerts.
For the step-by-step tasks, see Prioritise events.
Troubleshooting
Section titled “Troubleshooting”Messages on the page
Section titled “Messages on the page”| What you see | Why | What to do |
|---|---|---|
| Read-only: only workspace admins can change event priorities. | You are a member or a viewer | Ask a workspace admin to make the change |
| A rule set name of 1-100 characters is required. | The name is empty or too long | Enter a name of 1 to 100 characters |
| A rule set named “{name}” already exists in this workspace. | Another rule set has that name | Choose a different name |
| A rule set may contain at most 200 rules. | You scored more than 200 event types | Split the rules into two rule sets |
| Importance must be a whole number between 1 and 5. | An importance value is not valid | Choose 1, 2, 3, 4 or 5 |
| Unknown {provider} event type: {type} | The event type is not in the list for that provider | Use the listed event types only. Report it if you chose the type from the list. |
| At most 200 tenants may be assigned to a rule set. | Too many tenants are ticked | Use Use as workspace default |
| Unknown tenant for this workspace: {ids} | A ticked tenant was deleted while the dialog was open | Close the dialog, open it again and save |
| Priority rule set not found. | Another admin deleted the rule set | Reload the page |
| Failed to save the rule set., Failed to create the rule set. or Failed to delete the rule set. | A network or server error | Try again |
| Failed to load priority rule sets. or Failed to reload priority rule sets. | The list could not be loaded | Reload the page |
| Forbidden | Your role does not allow the change | Ask a workspace admin |
Rule sets and the feed
Section titled “Rule sets and the feed”| What you see | Why | What to do |
|---|---|---|
| You saved a rule set but nothing is flagged in the feed | The feed has not loaded the new rule set yet | Reload the dashboard, or switch to another browser tab and back |
| Still nothing is flagged | The card reads Not applied to any tenant yet. | Edit the rule set and tick the tenants, or switch on Use as workspace default |
| Still nothing is flagged | The provider or the event type does not match the events that arrive | Compare the Event Type in the feed with the scored types in the rule set |
| A tenant stopped being flagged | Another rule set took the tenant | Check Applied to on each card |
| The default rule set does not flag a tenant | The tenant has its own rule set, and that one does not score the event type | Add the event type to the tenant’s rule set |
| A deleted rule set still flags events | Open feeds refresh on reload or when the tab is shown again | Reload the dashboard |
| Flagged only is greyed out and reads (priority rules unavailable) | The feed could not load the priority rules | Reload the dashboard. The feed still works, with ratings from severity. |
| An event you scored 5 did not send an alert | Alert channels use severity, not your priority | Change the channel’s Minimum severity. See Alert channels. |