On This Page

Home / Cribl Detect/ Prepare Data (Preview)/ Enrichment (Preview)/Add an Enrichment Rule

Add an Enrichment Rule ​

Preview Feature ​

Cribl is still developing this Preview feature. We don’t recommend using it in a production environment, because the feature might not be fully tested or optimized for performance, and related documentation could be incomplete.

Access requires App Platform, the Cribl Detect feature, and a Role that grants Apps.Read access to the Cribl Detect app.

Please continue to submit feedback through normal Cribl support channels, but assistance might be limited while the feature remains in Preview.

An enrichment rule maps fields on incoming events to an enrichment provider. Cribl Detect joins those fields to the lookup rows for the provider and adds the matching context so detections can evaluate the context along with the event.

Add an Enrichment Provider first. Then add a rule from Enrichment > Rules.

Create an Enrichment Rule ​

In Cribl Detect, select Enrichment > Rules > Add Rule.

  1. For Event field, enter the OCSF field whose value Cribl Detect should look up. This field is required.
  2. For Entity type, select Identity or Asset. Use the same choice you made on the provider.
    • Identity represents a person or account.
    • Asset represents a machine or other inventory object.
  3. For an Asset rule, select Match mode: Exact or CIDR. CIDR is available only for Asset providers that have Use for CIDR matching turned on. Identity rules always match exactly.
  4. For Normalizer, select how Cribl Detect canonicalizes the event value before matching, for example lowercase or an email/UPN local part. The same transform is applied when the lookup is built.
  5. For Provider, select the lookup this rule reads from. The list shows providers that match the entity type, and CIDR-enabled providers when Match mode is CIDR. See Add an Enrichment Provider.
  6. Optionally, for Exclude fields, select lookup columns to leave off the enriched event.
  7. Select Save.

New rules are enabled when you save. Toggle Enabled off on the Rules list to disable one later without deleting it.

When a lookup matches, Cribl Detect attaches enrichment context to the event. Findings keep that context so investigations can use it. See Enrich Event Data.

Next Steps ​