> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/risk-management/alerts/configure-alerts/configure-global-settings/sensitive-keywords.md).

# Sensitive keywords

You can configure keywords to [trigger](#triggering-keywords) or [suppress](#suppressing-keywords) alerts based on the file name. Keywords help to optimize your security monitoring, reduce noise, and improve the precision of your alerts.

DoControl alerts are triggered when potentially sensitive files are shared. A file is considered sensitive if:

* DoControl's sensitivity model assigns a high score to the file name, or
* A customized keyword from the Alert triggers list is detected in the file name.

## Triggering keywords

You can customize keywords that generate alerts for sensitive content. If the file name contains any of the triggering keywords, the file is considered sensitive and an alert is triggered.

**For example**: Keywords such as "confidential," "payroll," or "medical" most probably indicate sensitive information, even if the file's contents are encrypted or not scannable.&#x20;

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPpR3PUFfhrWw7p3Izj6E%2Ftrigger%20alerts.png?alt=media&amp;token=a8c48eb5-fc20-49ce-819d-f498b57cddeb" alt=""><figcaption></figcaption></figure>

**To add sensitive keywords to trigger alerts:**

1. In the **Alerts** page, click **Configure alerts.**<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fsf11Ot22FBIudJ0xtEkQ%2Falerts%20top%20bar.png?alt=media&amp;token=a88bc44b-b4f3-4755-be80-a8471ecf8d84" alt=""><figcaption></figcaption></figure></div>
2. Under **Triggering keywords**, click **Add**  <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fg95Hc5iGdtZd4bH2jj7b%2Fadd%20sensitive%20keyword%20icon.png?alt=media&amp;token=50811caf-96be-4346-9bd6-445f84c07680" alt="" data-size="line">
3. Enter up to 1000 keywords.&#x20;

{% hint style="success" %}

* You can add multiple-word keywords with spaces, such as "date of birth" or "credit card."
* Keywords are **case-sensitive** and can **contain spaces**. DoControl detects the keyword exactly as it is entered. For example, if the file name includes "Salary" and the lexical list item is "salary" then a match will **not** be found.
* After entering each keyword, click **Enter** or the **Add** button to add it to the list. Click **X** to remove a keyword.&#x20;
* You can also customize alert triggers in [lexical lists](/docontrol-user-guide/system-management/settings/lexical-lists.md).
  {% endhint %}

## Suppressing keywords

If the file name contains suppressing keywords in the excluded list, the file is considered less sensitive and an alert is **not** triggered. Configuring exclusion criteria helps to reduce alert fatigue, since files that are non-sensitive or low-risk can be ignored.

You can customize keywords that do **not** generate alerts. If the file name contains any of the suppressing keywords, the file is **not** considered sensitive and an alert is **not** triggered.

**For example**: You can ignore files that match exclusion criteria, such as if they contain any of these words: test, announcement, newsletter, schedule, presentation, training.

{% hint style="info" %}
If keywords from both the **Triggering keyword** and **Suppressing keyword** lists are detected in a file name, an alert is still generated.
{% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FrvnB0KtJZHyHOYZmrmBp%2Fsuppress%20alerts.png?alt=media&amp;token=43e46a1e-581f-4cb0-b40a-81677d3c6a1e" alt=""><figcaption></figcaption></figure>

**To add keywords to suppress alerts:**

1. In the **Alerts** page, click **Configure alerts.**<br>

   <div align="left"><figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fsf11Ot22FBIudJ0xtEkQ%2Falerts%20top%20bar.png?alt=media&amp;token=a88bc44b-b4f3-4755-be80-a8471ecf8d84" alt=""><figcaption></figcaption></figure></div>
2. Under **Suppressing keywords,** click **Add**  <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fg95Hc5iGdtZd4bH2jj7b%2Fadd%20sensitive%20keyword%20icon.png?alt=media&amp;token=50811caf-96be-4346-9bd6-445f84c07680" alt="" data-size="line">
3. Enter up to 1000 keywords.&#x20;

{% hint style="success" %}

* You can add multiple-word keywords with spaces, such as "date of birth" or "credit card."
* Keywords are **case-sensitive** and can **contain spaces**. DoControl detects the keyword exactly as it is entered. For example, if the file name includes "Salary" and the lexical list item is "salary" then a match will **not** be found.
* After entering each keyword, click **Enter** or the **Add** button to add it to the list. Click **X** to remove a keyword.&#x20;
* You can also customize alert suppressors in [lexical lists](/docontrol-user-guide/system-management/settings/lexical-lists.md).
  {% endhint %}

## Alert types with sensitive keywords

All these DoControl alert types leverage sensitive keywords when generating an alert. An alert will be triggered If:

* A  keyword from the Alert triggers list is detected in the file name.
* DoControl's sensitivity model assigns a high score to the file name.

<table><thead><tr><th width="128">Alert ID</th><th>DoControl alert type</th></tr></thead><tbody><tr><td>DC3</td><td>External sharing of sensitive files </td></tr><tr><td>DC6</td><td>Public sharing of sensitive files </td></tr><tr><td>DC7</td><td>Shared sensitive file with private email </td></tr><tr><td>DC8</td><td>Shared sensitive file with personal email </td></tr><tr><td>DC105</td><td>Unprotected sensitive cloud recording is public</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/risk-management/alerts/configure-alerts/configure-global-settings/sensitive-keywords.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
