# Mapping Identities to Employees

### Getting Started <a href="#h_01hq2t5372aqz7va3cnxpmsjrt" id="h_01hq2t5372aqz7va3cnxpmsjrt"></a>

Mapping SaaS application users to your employees is one of the primary functions supported in BalkanID. We are working hard to programmatically connect data but the BalkanID system still requires some human interaction for some applications.

Identity mapping is important to connect an application identity to an employee. This is an essential step will facilitate entitlement discovery and working with the BalkanID environment in general. The steps to map identities within the BalkanID environment are given below.

There are two ways to map identities to employees:

1. &#x20;Through .CSV upload
2. Directly on the application

### Map identities to employees through .CSV(Bulk) upload: <a href="#h_01hpgsgyymry3z4rfj1cw71he5" id="h_01hpgsgyymry3z4rfj1cw71he5"></a>

1. Go to the *Integrations* page under *Configurations*. Ensure that data has been fetched from applications.
2. Go to the *Identities page* under *Entities*. Here you will see a button, “*Map Identities*” which may have a number representing the count of unmapped identities in your tenant.<br>

   <figure><img src="/files/dLECetGpHUQrw2MQWIJi" alt=""><figcaption></figcaption></figure>
3. Click the *Map Identities* button to open a side view with further instructions.<br>

   <figure><img src="/files/yPVstd8SkJa7bK3TXzrR" alt=""><figcaption></figcaption></figure>
4. Download the CSV file of unmapped identities.
5. Fill up the columns with information that will help the BalkanID system match these identities to employees (*Employee email* field is required).

   Be sure to add the “IS” or “OWNS” relation to the row to ensure the identity is properly mapped. The IS relations refers to accounts that an employee logs into and uses. The OWNS relation is for mapping service accounts to the employee that is responsible for them.<br>

   <figure><img src="/files/ViaAXcRL7Mu7zS0dE3hn" alt=""><figcaption></figcaption></figure>
6. Once you have updated the .csv file, upload the edited .CSV file in the same sidebar.

### Map identities to employees through the application: <a href="#id-01j5qyrp02m24pmktj99eecj8t" id="id-01j5qyrp02m24pmktj99eecj8t"></a>

1. Go to the *Integrations* page under *Configurations*. Ensure that data has been fetched from applications.
2. Go to the *Identities page* under *Entities*. Here you will see a button, “*Map Identities*” which may have a number representing the count of unmapped identities in your tenant.<br>

   <figure><img src="/files/ooFzwEdHfFnQp5uiXGqC" alt=""><figcaption></figcaption></figure>
3. Select the identities you would like to map. You will see the number of selected identities to map on the *Map Identities* button. Click on the *Map Identities* button. <br>

   <figure><img src="/files/XxOuv7qNpnWJWkdBB70f" alt=""><figcaption></figcaption></figure>
4. You will see a sidebar in the below image open up. You can map multiple identities to one employee at a time through the application. Under *Identity Type,* select if it is an employee identity or a service account belonging to an employee. You can then either select a user to map it to or you can directly map it to the application owner. <br>

   <figure><img src="/files/3a69bbK7qR4jNzESP9ll" alt=""><figcaption></figcaption></figure>
5. After mapping the identity, it will take 2-3 mins to map the identity. Once updated, you can see the user as a mapped identity in the application.&#x20;

In case of any errors, feel free to reach out to our team for further assistance.&#x20;


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.balkan.id/getting-started/setting-up-your-tenant/application-integrations/mapping-identities-to-employees.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.