> 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/identity-security-posture.md).

# Identity security posture

DoControl’s Identity and Risk Management solution determines the risk profile for each identity in your SaaS ecosystem. The risk profile is based on comprehensive data collection including data access patterns, user permissions, and relevant business context from HRIS or Okta.

{% hint style="info" %}
Identities is a beta module and is being released gradually. For more information, please contact Customer Support.
{% endhint %}

DoControl’s Identity security posture allows you to:

* Discover and monitor your SaaS identities to protect your organization from identity threats
* In a single view, easily discover who are your riskiest internal users, and [drill-down](#identity-card) to investigate&#x20;

{% hint style="warning" %}

* **Prerequisite**: Make sure you integrate DoControl with an HRIS app (HiBob, Workday, SAP SuccessFactors, BambooHR, Deel HR) or Okta to view your identity data. These integrations are mandatory. If DoControl is not integrated with HRIS/Okta and Google Workspace, you cannot access the Identity Risk Management solution.  See [Prerequisites](/docontrol-user-guide/risk-management/identities.md#prerequisites).
* If a user does not exist in an HRIS app (HiBob, Workday, SAP SuccessFactors, BambooHR, Deel HR) or Okta, s/he will **not** be created as an identity.&#x20;
  {% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FFOZGquZvJ7XqiZzSNKGe%2FIdentities.png?alt=media&amp;token=32b9913a-1656-407f-af7f-c621d21d4173" alt=""><figcaption><p>DoControl provides Identity Risk Management in a single view</p></figcaption></figure>

{% hint style="success" %}
By default, internal users are displayed from the riskiest (highest risk score) to the least risky (lowest risk score).
{% endhint %}

## Identity mini-dashboard

The mini-dashboard for identities provides your organization with an overview of your risky identity posture. At a glance, you can view your organization's:

* [Total number of risky identities](#total-risky-identities)
* [User personas](#user-personas)
* [Top risky user spikes ](#top-risky-user-spikes)
* [Top risky departments](#top-risky-departments)
* [Organizational access map](#organizational-access-map)

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F9EWOd11XSBIqRkxGjxEm%2FITDR%20mini-dashboard.png?alt=media&amp;token=c774feb1-3eef-4548-b21f-3e6f3977a40a" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**The identity dashboard is interactive**: Click any value to display filtered results in the table below.
{% endhint %}

### Total risky identities

View the total number of risky identities in your organization:

<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%2FGQxxbh4ZMMSgkCEsYB06%2Ftotal%20risky%20identities.png?alt=media&amp;token=546d9c29-4c9a-4089-b57b-cb7db13f1d22" alt=""><figcaption></figcaption></figure></div>

* **Risky/ total identities** - Number of critically risky users (with a score of 80 and above) out of the total number of identities in your organization.
* **Risk bracket breakdown** - View the percentage and number of risky identities in each risk bracket:
  * **Critical** - Users with a risk score between 80-100
  * **High** - Users with a risk score between 50-79
  * **Medium** - Users with a risk score between 30-49
  * **Low -** Users with a risk score between 0-29

{% hint style="success" %}
**Interactive tip**: Click any risk bracket to display all filtered identities in that risk bracket.
{% endhint %}

### User personas

View the total number of risky user types in your organization:

<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%2FJ0JthR9eXYrHXIc6o4Kn%2FUser%20personas%20watchlist.png?alt=media&amp;token=385e73c6-75c0-41d3-a88e-3d2f6dbab158" alt=""><figcaption></figcaption></figure></div>

* **Watchlist -** User is being monitored for risky behavior
* **VIP** - User is director, Vice President, or head of department (active users only)
* **Admin** - User is an admin for at least one SaaS app (active users only)
* **Terminated** - A user is no longer employed
* **Departing** - A user is about to leave the organization
* **Dormant** - User has been inactive for at least 30 days

{% hint style="success" %}
**Interactive tip**: Click any user persona to display all users in that category.
{% endhint %}

### Top risky user spikes

View the top risky users with the greatest risk score increase over the past 7 days.

<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%2FmfPXRFHmNmZ4n5F4SizP%2Ftop%20risky%20user%20spikes.png?alt=media&amp;token=3abe166b-1465-4266-ad7d-384fecd4f5e8" alt="" width="258"><figcaption></figcaption></figure></div>

* **Left column** - Indicates user's risk score 7 days ago
* **Right column** - Indicates user's current risk score

{% hint style="success" %}
**Interactive tip**: Click any user to display their risk tab with a breakdown of all risk elements contributing to that user's score.
{% endhint %}

### Top risky departments

View the risk scores for the riskiest departments in your organization, with an indication if the risk score increased or decreased, or remained the same, in the last 30 days.

<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%2FW6AhwnoG4w9TtqNvtscx%2Ftop%20risky%20depts.png?alt=media&amp;token=3d55afa7-c367-492a-9a4d-3006b4ec5efe" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
**Interactive tip**: Click any department to display all users belonging to that department.
{% endhint %}

## Identity posture elements

Data for Identity and Risk Management is displayed according to these parameters:

<table><thead><tr><th width="198">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>Risk</td><td>User's total risk score, based on multiple risk elements. <br>The arrow indicates an <strong>increase</strong> or <strong>decrease</strong> in the user's risk score compared to the last 30 days. <br>For more info, see <a href="/docontrol-user-guide/risk-management/identities/risk-score-logic.md">Risk score logic</a>.</td></tr><tr><td>User name</td><td><p>Clicking the user's name opens the <a href="#user-details">Identities drawer</a> for that user. Special users with increased risk are indicated with these icons:</p><p><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FpHN4VEKKX0FPbXes8nQN%2FVIP.png?alt=media&amp;token=31b79154-f605-4459-851e-cc96da9d9a29" alt=""><strong>VIP</strong> - A VIP user has an executive status, such as a director, Vice President, head of department, or C-level manager</p><p><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FFH122mFzFKG6RtiQJmeu%2Fadmin.png?alt=media&amp;token=481ebbfb-8c2c-4a61-9ed0-9a35e1d8a862" alt=""><strong>Admin</strong> - The user is an admin in at least one SaaS app</p></td></tr><tr><td>Employment status</td><td><p>User's employment status as updated by Okta or HRIS:</p><ul><li>Active</li><li>About to leave</li><li>Terminated</li></ul></td></tr><tr><td>Job title</td><td>User's role or title</td></tr><tr><td>Department</td><td>User's organizational department, such as Sales, Customer Success, or Product Management.</td></tr><tr><td>Exposure</td><td><p>Breakdown of the user's attack surface in terms of shared Google and Slack assets:</p><p><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FuZ0N2VUQaYTj0nnrbOYL%2Finternal%20icon.png?alt=media&amp;token=cef8438b-f2aa-4013-af2e-6a8b4ae22fdf" alt="">Internal - Assets shared within your organization</p><p><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FatHbaugJeZxsDqpHuky8%2Fexternal%20icon.png?alt=media&amp;token=2f904ee5-e052-41a8-8ab4-c60bbbe60aaa" alt="">External - Assets shared with external collaborators</p><p><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FO1Rgqq8oPzx3g8bmsJfJ%2Fpublic%20icon.png?alt=media&amp;token=41959bc4-94c3-4d67-a30b-800f4318ef41" alt="">Public - Assets publicly open to the world</p></td></tr><tr><td>Triggered</td><td>Total number of alerts and workflows triggered by the user.<br>Clicking the icon opens the <a href="/docontrol-user-guide/saas-data-monitoring/events.md#triggered-entities">Triggered entities</a> window for alerts and workflow executions triggered in the last 30 days.</td></tr><tr><td>Risk trend</td><td>Change in user's risk score over the last 30 days</td></tr><tr><td>Last activity</td><td>Most recent event triggered by a user or app acting in a user’s name</td></tr></tbody></table>

## Identity filters

You can use these quick filters to filter identities:

{% hint style="success" %}

* Leverage DoControl's **auto-complete** function to quickly search for and locate identities by user name, department, employment type, or job title.
* For investigation purposes, you can also filter [risky events](/docontrol-user-guide/saas-data-monitoring/events/filtering-events.md#risky-events).
  {% endhint %}

<table><thead><tr><th width="224">Quick filter</th><th>Description</th></tr></thead><tbody><tr><td>User name</td><td>Start typing to filter users with that string, which can appear anywhere in the user's name.</td></tr><tr><td>Risk score</td><td><p>Select a risk bracket to filter users by:</p><ul><li>Critical: 80-100</li><li>High: 50-79</li><li>Medium: 30-49</li><li>Low: 0-29</li></ul></td></tr><tr><td>Employment status</td><td><p>Filter identities according to one or more employment statuses (based on HRIS data):</p><ul><li>Active</li><li>Terminated</li><li>About to leave</li></ul></td></tr><tr><td>Department</td><td>Start typing to filter departments with that string, which can appear anywhere in the department name.</td></tr></tbody></table>

Additional filter options for identities include:

<table><thead><tr><th width="170">Filter</th><th width="190">Comparator</th><th>Description</th></tr></thead><tbody><tr><td>Admin</td><td>Equals</td><td>True, false</td></tr><tr><td>Email</td><td>String</td><td>Work or personal email:<br>Equals, doesn't equal, starts with, ends with, contains, doesn't contain, includes, excludes</td></tr><tr><td>Employment type</td><td>String</td><td><ul><li>Name of employment position, such as part-time:<br>Equals, doesn't equal, starts with, ends with, contains, doesn't contain, includes, excludes</li><li>Start typing to filter employment types with that string.</li></ul></td></tr><tr><td>Exposure</td><td>Includes, excludes</td><td>Public, external, internal</td></tr><tr><td>Job title</td><td>String</td><td><ul><li>Name of role:<br>Equals, doesn't equal, starts with, ends with, contains, doesn't contain</li><li>Start typing to filter job titles with that string.</li></ul></td></tr><tr><td>Last activity</td><td>Date</td><td><p>Date of most recent event triggered by a user or app acting in a user’s name:</p><p>Equals, after, before, is between</p></td></tr><tr><td>Triggered</td><td>Includes, excludes</td><td>Workflows, alerts</td></tr><tr><td>VIP</td><td>Equals</td><td>True, false</td></tr></tbody></table>

{% hint style="success" %}
With the **email** filter, you can search for identities by work or personal email.
{% endhint %}

## Organizational access map

View the geographical distribution of access events for all internal users over the last 90 days. Hover over the frequently accessed countries to see the accessed cities in that region.

<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%2F34x3dLUXvfptNsOIyRiG%2Forg_access%20map.png?alt=media&amp;token=6de73289-d13f-4f11-83b8-b90fbf675ee9" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Click the **Expand** ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FiRgC0aQyp3q1E1pMTc9X%2Fexpand%20icon.png?alt=media\&token=63311cb6-22c1-432f-b9f1-7b3aadc7d40c) icon to view global access details with a breakdown according to locations, users and events.
{% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fkhdbs2zRPBiG4ZR8RxK4%2Fglobal%20access%20map.png?alt=media&amp;token=74e60364-69ee-4762-ae43-efc479d05e5d" alt=""><figcaption></figcaption></figure>

View the geographical distribution of access to your organization according to these parameters:

<table><thead><tr><th width="289.1171875">Access parameter</th><th>Description</th></tr></thead><tbody><tr><td>Location</td><td>City and country where the access event took place</td></tr><tr><td>Percentage</td><td>Number of access events in a specific location as a percentage out of the total number of global access events</td></tr><tr><td>Events</td><td>Number of access events in a specific location</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/identities/identity-security-posture.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.
