> 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/identities/risk-score-logic.md).

# Risk score logic

The risk score for each user is based on comprehensive data collection, including data access patterns, user permissions, sensitive data sharing, policy violations, anomalous behavior, relevant business context from HRIS, shadow apps, events and inventory.

In turn, risky identity scores are leveraged to enrich drive risk-based actions in DoControl: alerts, security posture, and workflows.

The user risk score reflects the potential risk an internal user poses to the organization in terms of data loss or exfiltration.

The arrow reflects the increase or decrease in risk score compared to the last 30 days:

<table><thead><tr><th width="114">Icon</th><th width="163">Potential risk</th><th>Risk score</th><th>Example</th></tr></thead><tbody><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fcbj9VZOlb0FJqShQtGdO%2Fcritical.png?alt=media&amp;token=4af14436-55de-4250-8de9-d6e86836c649" alt=""></td><td>Critical</td><td>80-100</td><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FyR7V2c3jw0X5NXDwCDfM%2Frisk%20score%20increased.png?alt=media&amp;token=e3da1e33-77a8-466e-9f95-d940ff6d8be9" alt=""></td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fl2ZOtlh7itD28RMNAwXh%2Fhigh.png?alt=media&amp;token=ea2eef47-ac6b-4e02-a66d-4ad75f679d3d" alt=""></td><td>High</td><td>50-79</td><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FTGzcT3aCHgwEil3tVsGD%2Fhigh%20risk%20score%20decreased.png?alt=media&amp;token=3c04ac0d-a3e2-4843-8140-95106f5258f9" alt=""></td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FZfkq6kswxsUnduhKPMWg%2Fmedium%20risk.png?alt=media&amp;token=61e8ffd7-372b-47a7-bea2-aa0c01edff84" alt=""></td><td>Medium</td><td>30-49</td><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FXEmpu7AuF1iCvnnCncXg%2Fmed%20risk%20score.png?alt=media&amp;token=03a5c10d-5281-4ba5-b059-85366aaa729a" alt=""></td></tr><tr><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F6pqqP83Uhli2p9rOfGnr%2Flow%20risk.png?alt=media&amp;token=a98d2f1e-cd91-455a-bacb-8220d2fbfe20" alt=""></td><td>Low</td><td>01-29</td><td><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FinsNsIO0MfV853awdcA0%2Flow%20risk%20score.png?alt=media&amp;token=57eaf3af-9532-4bca-bd86-20cdc65d036f" alt="" data-size="original"></td></tr></tbody></table>

{% hint style="info" %}

* **Archived users** - DoControl displays the  user risk score for all Google users, both active and terminated (archived).
* **SaaS app sources** - We retrieve data from all SaaS apps to calculate a user's risk score, except for these apps: Jira, GitHub, and Slack Enterprise.
  {% endhint %}

## Multiple sources of risk data

To deliver a valid risk score, DoControl leverages enriched metadata from multiple sources. For each identity, the total risk score is based on [multiple risk elements](#weight-of-risk-elements) including:

* **SaaS inventory** - For Google Drive and Slack, DoControl gauges the level of the user’s asset exposure from the most exposed to least exposed: public, external and internal, and analyzes the user metadata associated with the inventory.
* **Shadow apps** - DoControl analyzes the number of risky apps installed for a specific user.
* **DLP** - For Google Drive and Slack assets, DoControl analyzes sensitive data sharing patterns and their magnitude for a specific user.
* **HRIS and IdP** - DoControl leverages data from HiBob, Workday and Okta to discover each user’s employment status, termination date, VIP role, job title, employment status, personal emails, and department.
* **DoControl alerts and workflows** - DoControl examines each triggered alert and workflow for user involvement, when the user is an actor.

## Benchmarking

DoControl compares the user with the department and the entire organization. This comparative analysis also takes the user’s role into account. The department behavior is used as a baseline when considering the contribution of each risk element to the total risk score:

* The department risk score is based on active or about-to-leave users (not terminated users).
* If the department is small, then the contribution of each risk element is compared to the baseline of the entire organization.&#x20;
* We compare active users to active or about-to-leave users, and exclude terminated employees.

{% hint style="info" %}
For example, a Marketing department usually exposes a large number of assets externally:

* **Same as baseline** - A user who belongs to the Marketing department and externally exposes a **large number** of assets does not deviate from the department baseline. The user's exposure level is considered **the same** compared to the department.
* **Higher than baseline** - A Marketing user externally exposes an **exceptionally high number** of assets that is even more than the department baseline. The user's exposure level is considered **high** compared to the department.
* **Lower than baseline** - A Marketing user externally exposes a **low number** of assets that is much less than the department baseline. The user's exposure level is considered **low** compared to the department.
  {% endhint %}

## Weight of risk elements

DoControl uses complex algorithms to calculate the effect of each risk element on the user's final risk score.

{% hint style="info" %}

* Each risk element has a different weight in calculating the final risk score.
* All risk elements (except VIP and admin user) are comparative, since they're compared to the average for the user's department or company.
  {% endhint %}

<table><thead><tr><th width="203">Risk element</th><th>Effect on total risk score</th></tr></thead><tbody><tr><td>Exposure level</td><td><p>When the user is the owner of Google My Drive assets or uploader of Slack files, the effect on the total risk score depends on how the assets are shared:</p><ul><li><strong>Internal assets</strong> - Don't increase the user's total risk score</li><li><strong>External assets</strong> - Moderately increase the user's total risk score</li><li><strong>Public assets</strong> - Greatly increase the user's total risk score when the user is the owner of publicly shared assets</li></ul></td></tr><tr><td>DLP exposure</td><td>The user's total risk score increases according to the number of Google or Slack assets that have highly sensitive file names. </td></tr><tr><td>VIP</td><td>If the user is a VIP, such as a head of department or director, the total risk score increases</td></tr><tr><td>Admin</td><td>If the user has at least one admin role in integrated SaaS apps, the total risk score increases</td></tr><tr><td>Alerts (last 30 days)</td><td>The more active alerts the user has as an <strong>actor</strong>, the higher the total risk score.</td></tr><tr><td>Workflows (last 30 days)</td><td>The more workflows triggered by this user (in comparison to other people in the department), the higher the total risk score</td></tr><tr><td>Risky shadow apps</td><td>The more risky shadow apps installed by this user, the higher the total risk score</td></tr><tr><td>Employment status</td><td><p>User's employment status as updated in Okta or an HR app:</p><ul><li><strong>Active</strong> - No effect on total risk score</li><li><strong>About to leave</strong> - Increases the total risk score</li><li><strong>Terminated</strong> - Increases the total risk score</li></ul></td></tr><tr><td>Employment type</td><td><p>User's employment type as updated in Okta or an HR app:</p><ul><li><strong>Full-time/ advisor</strong> - No change in the user's total risk score</li><li><strong>Part-time/ Intern/ Hourly</strong> - Slightly increases the user's total risk score</li><li><strong>Contractor/ Outsourcer/ Contingent/ Temporary/ Freelancer</strong> - Significantly increases the user's total risk score.<br>The reasoning is the user is potentially less loyal to the company and could be leveraged to exfiltrate information.</li></ul></td></tr></tbody></table>

{% hint style="info" %}
For a detailed description of all risk elements, see [Identity security posture](/docontrol-user-guide/risk-management/identities/identity-security-posture.md#user-risk).
{% endhint %}


---

# 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/identities/risk-score-logic.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.
