Enterprise Recon Cloud 2.12.0

Download ER Cloud 2.12.0 User Guide (PDF)

How To Add Custom Data Type

PII PRO This feature is only available in Enterprise Recon Cloud PII and Enterprise Recon Cloud Pro Editions. To find out more about upgrading your ER Cloud license, please contact Ground Labs Licensing. See Subscription License for more information.

A Global Admin or Data Type Author can create custom data types to scan for data types that do not come with ER Cloud.

To build a custom data type:

  1. On the Scans > Data Type Profile page, click on the Custom Data tab.
  2. Click + Add Custom Data Type.

  3. In the Add Custom Data Type dialog box, fill in these fields:

    Field Description
    Describe Your Data Type Enter a descriptive label for your custom data type.
    Add Rules You can add these rules: Phrase, Character and Predefined.
    For details, refer to the Add Custom Rules and Expressions section.
    Advanced Options Ignore duplicates: Flags the first instance of this data type in each match location as match.
    Minimum match count: Flags the match location as a match if there is a minimum number of matches for this custom data type.

Add Custom Rules and Expressions

You can add custom rules with the Add Custom Data Type dialog box with either the Visual Editor or the Expression Editor. Both editors use the same Expression Syntax.

Use the Visual Editor

Add Custom Data Type visual editor dialog box.

Rules added to the visual editor are resolved from top to bottom i.e. the top-most rule applies, followed by the rule that comes under it until the bottom-most rule is reached.

Example of top to bottom resolve rules for custom data type visual editor.

Use the Expression Editor

To use the expression editor, click View rules as expression on the Visual Editor.
"View rules as expression" option to open up the Expression Editor dialog box.

In the Expression Editor, your custom rules are written as a search expression used by ER Cloud.
Example of a written search expression in the expression editor dialog box.

Use Expression Syntax

You can add the following custom expression rules to your custom data type:

Phrase

Adding a Phrase rule to your custom data type allows you to search for a specific phrase or string of characters.

A single \ (backslash) character in a Phrase rule generates an error; you must escape the backslash character with an additional backslash to add it to a Phrase, i.e. \\.
Example of a Phrase rule to search for a backslash character.

Character

The Character rule adds a character to your search string and behaves like a wild card character (*). Wild card characters can search for strings containing characters that meet certain parameters.

You can pick the following options to add as character search rules:

Character Match
Space Any white-space character.
Horizontal space Tab characters and all Unicode "space separator" characters.
Vertical space All Unicode "line break" characters.
Any Wildcard character that will match any character.
Alphanumeric ASCII numerical characters and letters.
Alphabet ASCII alphabet characters.
Digit ASCII numerical characters.
Printable Any printable character.
Printable ASCII only Any printable ASCII character, including horizontal and vertical white-space characters.
Printable non-alphabet Printable ASCII characters, excluding alphabet characters and including horizontal and vertical white-space characters.
Printable non-alphanumeric Printable ASCII characters, excluding alphanumeric characters and including horizontal and vertical white-space characters.
Graphic Any ASCII character that is not white-space or control character.
Same line Any printable ASCII character, including horizontal white-space characters but excluding vertical white-space characters.
Non-alphanumeric Symbols that are neither a number nor a letter; e.g. apostrophes ‘, parentheses (), brackets [], hyphens -, periods ., and commas ,.
Non-alphabet Any non-alphabet characters; e.g. ~ ` ! @ # $ % ^ & * ( ) _ - + = { } | [ ] : ; " ' < > ? / , . 1 2 3 …
Non-digit Any non-numerical character.

Predefined

Search rules that are built into ER Cloud. These rules are also used by built-in Data Type Profiles. Refer to the Use Data Type Profiles section.