# Chapter 4: Entities
# Managing Entities in Medulla
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/t2zHs5mC2C4luyf6-image.png)
This section guides you through managing entities within Medulla. You will learn how to view existing entities, add new ones, assign users to them, and download tagging agents directly based on the entities.
Entities in the Medulla module are provisioned directly in the GLPI or ITSMNG backend.
### The Entity List Section
Located in the center of the screen, this section displays all entities registered in your Medulla environment.
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/B8lCiwCDVjLwlInP-image.png)
#### Root Entities.
By default, a root entity is created in Medulla. This root entity can contain child entities and users within the root entity as well as within the child entities.
The following information is displayed for each entity:
- **Entity Name**: the unique name of the entity.
- **FullName**: the full name of the entity.
- **Number of users attached** to this entity.
- **Number of machines**: attached to this entity.
- **Actions**: options to**add an entity, assign a user to** the entity , and **download the agent** directly linked to the entity for inventory purposes.
#### Add a Sub-Entity
To create a sub-entity, click the [](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/odi9zC8jBVTMbxCe-image.png) on the parent entity's row, then give it a name and click the **"Create Entity"** button.
#### No users registered
If no users have been added yet, the users section will show a count of 0, as shown in the screenshot above.
#### Medulla Agent
**By default (on-premise or classic configuration), we provide a global agent for Medulla; entity management per workstation is handled via GLPI.**
However, if you wish **to benefit from automatic assignment of machines to entities directly via the agent**, it is also possible to **generate specific agents per entity**. This option is not enabled by default, but we can assist you in setting it up if it meets your needs.
If you choose to have one agent per Entity as explained in this post, you will find the "Download an agent" buttons in the actions for an entity[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/FbdaWiXpqAQG2bXN-image.png)
. Select the Windows or Linux agent, then click Submit to download the relevant agent.
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/xjpDbvQkZ4p1Ow39-image.png)
It will directly link the workstation to the entity configured in the downloaded agent.
# Add an entity and create users
[](https://docs.medulla-tech.io/uploads/images/gallery/2025-12/FN22APCny8p95UZb-image.png)
The button above opens the menu for creating a sub-entity of the root entity.
To create a new entity in Medulla, simply fill in the following field and then click the **Create Entity** button
- **Entity Name**
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/hnczm72sZbfpCXhi-image.png)
### Go to the user creation page for an entity.
In the side menu bar on the left side of the screen, click the button
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/KlhFDFMVeqXwWkHV-image.png)
Click the **“Add a user”** link to open the creation page.
The form will appear in the center of the screen.
#### Fill out the Creation Form
Here are the fields to fill out
- **User Profile**: Select the user profile you want to associate with the user.
- **Entity**: Select the entity you want to map to the user.
- **Apply to Sub-entities**: Whether you want the profile and user to apply to sub-entities recursively or not.
- **Authentication**: Either a local user based on GLPI or ITSM, or a user mapped from AD or OIDC.
- **Email**: An email address associated with the user.
- **Password** and **confirmation**: The password that will allow the user to log in.
- **Last Name / First Name**
- **Phone** and/or **Mobile**
Then click the "Create New User" button to confirm the user's creation.
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/dQGnVWxhIb2PvRjX-image.png)
### Edit an existing user
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/eZwgpuhfAYWbq3xc-image.png)
You can edit an existing user’s information at any time by clicking the button in Entity Management:
[](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/hlHkHJYRu8slRbFN-image.png)
- Go to the **User List** (center of the page).
- Locate the relevant user.
- Click " **Edit** " in the "Actions" column.
- Update the necessary fields (name, email, etc.).
- Save the changes.
#### Modify MMC Permissions
To adjust a user’s access rights in Medulla, you can modify their **MMC rights (also known as ACLs— *Access Control Lists***).
**Currently being redesigned.**
If they **do not** have **permissions** for a module (for example, “Imaging”), they will **not** be **able to view the logs** associated with that module in the history, even if access to the history is authorized.