Skip to main content

Check out Interactive Visual Stories to gain hands-on experience with the SSE product features. Click here.

Skyhigh Security

Create a Custom Dictionary

You can define a Custom Dictionary and its keywords to classify your sensitive data. For example, sensitive keywords specific to your organization. You can import dictionary keywords in .CSV format, or you can manually enter keywords.

Create Custom Dictionary Classification

To create a custom dictionary:

  1. Log In to Skyhigh CASB.
  2. Go to Policy > DLP Policies > Classifications.
  3. Click Actions > Create Classification
    • Classification Name. Enter a name for this classification. For example, Medical Dictionary. Enter an optional description to describe its use or purpose.
    • Category. Select a Category from the list. For example, Sensitive.
    • Conditions. Click Select Criteria and select Dictionary. The Select Dictionaries cloud card displays.
  4. From the Dictionaries menu, click New. Enter a name and optional description for the dictionary. For example, Medical Keywords.
  5. To enter keywords into the dictionary:
    • Click Add keyword to manually enter words or phrases. 
    • Click the three-dot menu to:
      • Import.csv. Import the keywords you want to add to this dictionary from a CSV file. For more details, see Import Keywords from CSV.
      • Advanced Settings. Advanced settings are flags that give more information to the DLP scanning engine. Define a keyword as Case-sensitive, Starts with, Ends with, and add a threshold Score to weight individual entries. Scores can be between negative or positive, -99 to 999. The higher the number, the greater the weight given to the keyword, which will exceed the threshold and trigger an incident. To learn more about Advanced Settings options, see Set Advanced Settings.
      • Click Save. The custom dictionary is added to the Dictionaries list. Select the custom dictionary list to add to the Classification editor. You can add one or more custom dictionaries to the Dictionaries list.
  6. Add more classification conditions as needed and click Save.

Your custom classification with a custom dictionary is saved to the selected category in the Classifications list. Add the classification to your data protection policies as needed.

Import Keywords from CSV 

When importing dictionaries from a CSV, the file should start with a heading row that contains specific column names to function correctly.

  • To import the basic or simple dictionaries, add the heading row as phrase.
  • For advanced dictionaries, add the heading rows as phrase, caseSensitive, startWith, endWith, score

A dictionary import will not be successful if these heading rows are not added correctly.

Example for a basic dictionary:


  • Email address
  • Date of Birth
  • Confidential

Example for the advanced dictionary:

"phrase", "caseSensitive", "startWith", "endWith", "score"

  • email address, false, false, false, 5
  • date of birth, false, true, true, 12

Custom Dictionary Use Cases

Count each match string only one time feature

Suppose you have a medical document with multiple instances of the keyword Patient Code and you have set the score for this keyword as 10 in the custom dictionary. This means that a match will only be triggered if the keyword Patient Code appears 10 or more times in the document. However, if you want to avoid triggering matches for duplicate counts, you can activate the Count each match string only one time checkbox. During the policy evaluation, the match will count only once, even though the score for the keyword is set to 10.  To find this option on UI, see Count each match string only one time.

Set Advanced Settings Options on the Custom Dictionary Keywords List

Let's say you have a significant medical recurring document that contains confidential information or sensitive keywords that should only be accessed by authorized personnel. To ensure the security of the document, you can set up an advanced dictionary option that alerts the DLP scanning engine with more precise information when anyone tries to access sensitive keywords beyond a specific limit. If a match is found, an incident is triggered to maintain the document's security.

To set Advanced Settings options such as weights (scores), case sensitivity, and partial string match to each keyword in a custom dictionary list, perform the following actions:

  1. Create a classification using a Custom dictionary. Perform the initial steps of creating your dictionary classification as provided in steps 1 to 5 in the Create Custom Dictionary Classification section.
    Use Cases.png
  2. Score. On adding the necessary keywords, you can set different scores for each keyword in the list by editing the default score [1]. For example:
    • For Case 1 and Case 2, defined scores for two keywords - Patient Phone Number and Patient Address. The score for the Patient Phone Number is 10, and for the Patient Address is 20. This means that when the keyword Patient Phone Number is accessed 10 or more times in the content, and Patient Address is accessed 20 or more times, then it triggers a match.
  3. Case sensitive. On adding the necessary keywords, you can set the case-sensitivity options for your keywords to refine your search and to get the most accurate and relevant results possible.
    • Case 3: To match your content with the keyword patient name in lowercase, activate the Case Sensitive checkbox. If the keyword found in the content is in upper case i,.e PATIENT NAME, then a match will be triggered.
    • Case 4: If you want the keyword Patient Code to be matched regardless of its case (lower /upper) then do not activate the Case Sensitive checkbox. In this case, a match will be triggered based on the keyword or other advanced dictionary options and the case (upper/lower) will be ignored.
  4. Partial String Match (Starts with, Ends with). On adding the necessary keywords, you can set Starts with or Ends with options for your keywords to perform partial string match.
    • Case 5: Activating the Starts with and Ends with options for the keyword Medical Diagnosis. The "Starts with" method checks whether the string begins with Medical and ends with Diagnosis. If one of the conditions or both conditions are true, then a match is triggered.
  5. Case 6 provides the comprised example of all the 3 Advanced Dictionary options:
    • Case 5: The Ends with method for the keyword DISCHARGE CODE has been activated. The keyword is set as case-sensitive and has a score of 2. The scanning engine searches for the word "CODE" in uppercase letters, and the keyword DISCHARGE CODE should not appear in the document search results more than twice.
    • Result: When a match is found among any of these options, the DLP scanning engine will trigger an incident.

Match all Keywords in the Custom Dictionary List

  1. Create a classification using Custom Dictionary. Perform the initial steps of creating your dictionary classification as provided in steps 1 to 5 in the Create Custom Dictionary Classification section.
  2. Click i to view the Keywords for the selected Custom Dictionary displayed on the second side panel. Count the number of keywords in the selected Custom Dictionary set. For example, the number of keywords found is 10.
  3. To match all keywords in the Custom Dictionary list, set the match threshold on the Classification editor equal to the number of items found in the dictionary list. For example, set the threshold as 10.
  4. To avoid counting duplicate matched keywords multiple times, enable the checkbox Count each match string only one time and save your classification.

Set the Threshold for the number of Keyword Matches in the Custom Dictionary

  1. Create a classification using Custom Dictionary. Perform the initial steps of creating your dictionary classification as provided in steps 1 to 5 in the Create Custom Dictionary Classification section.
  2. Select your custom dictionary. For example, Price List Dictionary and click i to view the number of keywords associated with it. You will find that there are more than 40 terms listed in the keyword list. But you need only 20 random keywords from that dictionary to match and trigger an incident.
    Price List.png
  3. To set the threshold as 20, add your dictionary to the Classification editor. Edit the threshold by clicking [1] and enter 20 to indicate the weight of the Dictionary in threshold matching and save your classification.
  • Was this article helpful?