> 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/saas-data-monitoring/inventory/inventory-users/hris-users.md).

# HRIS users

Internal users belong to your organization's HRIS platform and operate within the organization domains or subdomains.&#x20;

When these HRIS apps are integrated with DoControl, valuable HRIS information can be retrieved to expedite decision making:

* BambooHR&#x20;
* Deel HR
* HiBob
* SAP SuccessFactors
* Workday&#x20;

Captured data includes user employment status, groups and departments that users belong to, and other relevant metadata such as title or personal email.

DoControl alerts leverage metadata, such as an employee's **termination date**, as retrieved from an HRIS or IdP (Okta, Google Workspace, Microsoft Entra ID).

If anomalous behavior occurs, such as when an about-to-leave employee downloads files and sends them to his personal email account, then one of these alerts is triggered:

* DC 33 - File download by about-to-leave employee
* DC 36- Burst download by about-to-leave employee

{% hint style="info" %}
Data is displayed only for internal users in HRIS, not external users.
{% endhint %}

{% hint style="success" %}
Metadata from HRIS is also used to generate [HR groups](/docontrol-user-guide/saas-data-monitoring/inventory/settings-groups.md#default-hr-groups):

* About-to-leave employees
* Current employee personal emails
* Former employee personal emails
* Former employee work emails
  {% endhint %}

## Locate an internal user

To view personal details for a specific internal user in HRIS:

1. From the DoControl side menu, click **Inventory** > **Users**.
2. Select the HRIS app, such as **HiBob**.<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%2FBIsmdtmhLuhpd0t5VZDN%2Fselect%20Bob.png?alt=media&amp;token=30f19b76-56e0-45ef-abf4-9aecfeb11555" alt="" width="222"><figcaption></figcaption></figure></div>
3. Filter for a specific employment status: Active, Inactive, Terminated or Other.<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%2FPHSrLr7XQmyAZgr9KxeU%2Femployment%20status.png?alt=media&amp;token=7d029e95-6dcb-41ec-a9fe-37355a0524b3" alt="" width="172"><figcaption></figcaption></figure></div>
4. Filter for any other user parameters.
5. Click the user's **email address** to open the [internal user details](#internal-user-details).

## Internal user list

All internal users in your HRIS platform are displayed with these parameters:

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FL3vpQ5LtJhSTDpLPVGAR%2FHiBob%20user%20inventory.png?alt=media&amp;token=c1ab6a55-0fd3-4f07-a0d3-4910b713df73" alt=""><figcaption><p>User metadata gleaned from HiBob</p></figcaption></figure>

<table><thead><tr><th width="223.87890625">HRIS user parameter</th><th>Description</th></tr></thead><tbody><tr><td>Email</td><td><p>Email address of the HRIS user: </p><ul><li>Clicking the email link opens the <a href="#internal-user-details">internal user details</a>.</li><li>Terminated users are tagged in red.</li></ul></td></tr><tr><td>First name</td><td>Internal user's given name</td></tr><tr><td>Last name</td><td>Internal user's surname</td></tr><tr><td>Role</td><td>Organizational role of the user</td></tr><tr><td>Department</td><td>Organizational department the user belongs to</td></tr><tr><td>Manager</td><td>Direct manager of the user</td></tr><tr><td><a href="#employment-status">Employment status</a></td><td>Active, inactive, terminated or other</td></tr></tbody></table>

{% hint style="success" %}
Click **Export to CSV** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FPWdaV30qx1aefHNdGX9C%2Fdownload%20icon.png?alt=media&amp;token=16257bf4-2b68-4417-91e6-78c5db741fdc" alt="" data-size="line"> to download a consolidated report of internal HRIS users in CSV format.
{% endhint %}

## Internal user details

Metadata for a specific internal user in HRIS is displayed as follows:

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FRW5RkK2865jTeh73eEFl%2FHiBob%20internal%20user%20details.png?alt=media&amp;token=f874b86a-bc04-47e4-adb0-f5bef804ce88" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="271">Internal user detail</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Internal user name</td></tr><tr><td>Employment status</td><td>Active, inactive, terminated or other</td></tr><tr><td>Work email </td><td>Email of internal user</td></tr><tr><td>Role</td><td>Organizational role of the user</td></tr><tr><td>Department</td><td>Organizational department the user belongs to</td></tr><tr><td>Personal email</td><td>Non-work email of the user</td></tr><tr><td>Manager full name</td><td>Name of the user's manager</td></tr><tr><td>Manager email</td><td>Email of the user's manager. Clicking the email opens the manager's user details.</td></tr><tr><td>Hired on</td><td>Start date of the user's employment</td></tr><tr><td>End employment date</td><td>End date of the user's employment</td></tr><tr><td>Job location</td><td>Geographical location of the user</td></tr></tbody></table>

## Employment status

You can filter HRIS users according to these employment statuses:

<table><thead><tr><th width="255.5">Employment status</th><th>Description</th></tr></thead><tbody><tr><td>Active</td><td>Employees with access to HRIS. This status is based on the employee lifecycle status. For example, people with a current or past start date who are actively employed in your organization, and do not have any other lifecycle status. </td></tr><tr><td>Inactive</td><td>Employees who don't have access to HRIS. For example, people with a future start date, unless specific permissions have been granted.</td></tr><tr><td>Terminated</td><td>People whose employment has been terminated. Their access status to HRIS is <strong>Inactive</strong> and therefore is not visible on the platform to other people unless specific permissions have been granted.</td></tr><tr><td>Other</td><td>Any status that is not active, inactive or terminated.</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/saas-data-monitoring/inventory/inventory-users/hris-users.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.
