Creating and Managing Content Classification Engine Rules

Keyword Definitions

Below are the keywords used in creating the rule definition:

Classifier

Classifier used to classify the file content.

Note: Classification is not case sensitive.

In most cases, you can use:

  • Default - Classify content into terms that match the supplied regex patterns.
    Supported parameters: SEARCH_PATTERN_SET, SEARCH_PATTERN_NAME or SEARCH_PATTERN_GROUP
    Result Schema (_classifications): [{term: "term that matched a regex", count: "number of times the term appears in the doc"}, ...]

Also supported are:

  • PatternMatch - Classify content into regex patterns found.
    Supported parameters: SEARCH_PATTERN_SET, SEARCH_PATTERN_NAME or SEARCH_PATTERN_GROUP
    Result Schema (_classifications): ["regex pattern", ...]

  • StandardQuery - Classify content as matching the query or not.
    Supported parameters: STANDARD_QUERY_EXPRESSION
    Result Schema (_classifications): ["expression"] or []

  • IcapDLP - Classify content based on results returned from ICAP DLP.
    Supported parameters: none
    Result Schema (_classifications): []
  • SingaporeNRIC- Classify content into terms that match a Singapore NRIC.
    Supported parameters: none
    Result Schema (_classifications): [{term: "NRIC term", count: "number of times the NRIC term appears in the doc"}, ...]

Pre-condition

Rules that must be met by a file before the file is evaluated through the classifier.

Condition

Criteria to take a match action or default action on the files. Currently it must be count(_classifications) > 0 that indicates the file contains the search pattern, or the file must have applied metadata based on the presence of unique numbers or values.

Parameters

Regular Expression search criteria. Regular Expressions can be specified using SEARCH_PATTERN_SET, SEARCH_PATTERN_NAME or SEARCH_PATTERN_GROUP.

SEARCH_PATTERN_SET

Any Valid Regular Expressions e.g. /[0-9]{9}/

SEARCH_PATTERN_NAME

Regular Expression assigned a name through Manage Pattern Group - Available Patterns

SEARCH_PATTERN_GROUP

Regular Expressions grouped through Manage Pattern Group - Pattern Group.

Match Action

Actions taken when the classifier finds a file based on precondition, condition and parameters. For example, assign metadata set PII and metadata attribute Confidential to 1.

Default Action

 Actions taken when the classifier finds a file based on precondition but did not meet the condition based on parameters. For example, assign metadata set PII and metadata attribute Confidential to 0.

Creating and Editing CCE Rules

A CCE Rule is a self-contained specification for classifying one or more files.

To create a CCE rule:

  1. To open the Manage Content Classification Rules page, in the Admin portal's navigation pane, click Smart Classification.
  2. To add or create a new rule, click Add Rule.
    Manage Content Classification Rules screen, Add Rule button
  3. In the Add Rule dialog box, fill in the fields:
    • Name: Naming detail for the rule to be created.
    • Event Triggers: Criteria that enables the CCE to automatically execute rules for certain events.
    • Enable Auto-classification: When enabled, the rule defined will start classifying files based on the definition.
    • Definition: Set of rules which defines the action to be taken.
  4. Click Save.

 See Example Rules.

If you want the rule to immediately begin auto-classifying files when you save it, be sure to check the Enable Auto-classification box.