# Entités

***

### Qu'est-ce qu'une entité ?

**Définition** : objet organisationnel utilisé pour partitionner la vue et la portée d'action des utilisateurs.

Les entités sont utilisées pour :

* Partitionner la vue des utilisateurs qui se connectent à GLPI.
* Montrer à chaque utilisateur seulement les choses qu'il a besoin de voir.
* Gérer les délégations d'administration.

{% hint style="success" %}
**Exemples de découpages**

Par entité budgétaire : l'équipement acheté dans chaque entité est bien séparé. La plupart du temps pour chaque service informatique, une entité séparée.

**Important** : GLPI peut être utilisé avec une seule entité.
{% endhint %}

{% hint style="success" %}
**Exemple de hiérarchie**

<img src="https://3914205414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVU1qbB9Oe25HAYDAQ4tR%2Fuploads%2Fgit-blob-9f950dbf1183a44219b3db0c6aeba69a9189be18%2Fglpi_entity.png?alt=media" alt="Entity hierarchy" data-size="original">
{% endhint %}

{% hint style="warning" %}
**Important à savoir**

GLPI ne limite pas la création d'entités. Plus vous augmentez le nombre d'entités :

* Plus le système devient complexe (règles, basculement, etc).
* Plus il faut de temps pour exécuter les requêtes.
  {% endhint %}

Les administrateurs veulent souvent des entités pour répondre à un besoin, alors que d'autres concepts nécessitant moins de complexité sont là pour y répondre :

* **Groupe** : pour assigner équipements/tickets à un service ou une équipe de personnes.
* **Localisation** : pour déterminer la position géographique de l'équipement/personne.

***

### Où puis-je gérer les entités ?

* se fait depuis le menu **`Administration`** > **`Entités`** ;
* l'**entité racine ne peut pas être supprimée**, seulement renommée.

***

### Comment naviguer dans les Entités ?

Cliquez sur le lien Entité racine (Arbre) :

<div align="left"><img src="https://3914205414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVU1qbB9Oe25HAYDAQ4tR%2Fuploads%2Fgit-blob-a29159e45c89c5e2e3c77aefc4b504da2f11f382%2Fentity-2.png?alt=media" alt="Alt text"></div>

Un menu apparaît, vous permettant de restreindre la vue de GLPI :

* soit sur une entité en cliquant sur son nom.
* soit une structure arborescente sous cette entité en cliquant sur la double flèche verte à droite du nom de l'entité.

<div align="left"><img src="https://3914205414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVU1qbB9Oe25HAYDAQ4tR%2Fuploads%2Fgit-blob-c54db22814a46940957d8fd433b97bb2cb4e96fa%2Fentity-3.png?alt=media" alt="Alt text" width="563"></div>

***

### Pourquoi puis-je ajouter une nouvelle sous-entité ?

Dès qu'il y a au moins une entité, GLPI ajoute un champ "Sous-entité" à certains objets.

En utilisant ce champ, vous pouvez choisir si l'objet a une portée :

* Local : il ne sera visible que dans l'entité dans laquelle il se trouve.
* Global : comme Local avec visibilité dans ses sous-entités.

{% hint style="success" %}
**Exemple**

**Fournisseurs**

* Un administrateur d'une entité crée ses fournisseurs (local).
* Un administrateur GLPI crée des fournisseurs communs à toutes les entités (global).

**Contrats et contacts**

* Un contrat est commun à toutes les entités (global).
* Un administrateur d'une entité crée ses propres contacts pour ce contrat (local).
  {% endhint %}

***

### Pourquoi les entités que j'ai créées ne sont-elles pas visibles même si mon profil super-admin est en mode récursif ?

Lors de la création d'une entité, pensez à vous déconnecter/reconnecter afin de pouvoir les voir dans la liste.

{% hint style="info" %}
**Pour les instances on-premise**

* Si, malgré la déconnexion, elles ne sont toujours pas visibles, allez dans le dossier GLPI sur votre serveur et entrez la commande **`php bin/console cache:clear`**.
* Enfin, vous pouvez aussi vider le cache MYSQL avec les commandes :

`mysql -u root -p reset query cache;`
{% endhint %}

***

### Comment personnaliser les informations d'une entité ?

Depuis **`Administration`** > **`Entités`**, allez dans l'onglet adresse pour modifier les informations spécifiques à votre entité.

***

### Puis-je personnaliser l'interface d'une entité ?

C'est possible, cette étape nécessite des connaissances en CSS. Depuis **`Administration`** > **`Entités`**, vous pouvez activer la personnalisation CSS. Insérez le code CSS dont vous avez besoin pour personnaliser votre interface.

***

### Comment changer les adresses email d'une entité ?

Si vous voulez que votre entité utilise une adresse d'envoi et/ou de réponse particulière, vous pouvez la changer afin qu'elle n'utilise pas l'adresse par défaut. Depuis **`Administration`** > **`Entités`**, allez dans **`Notifications`** et changez les informations souhaitées aux valeurs de votre choix.

***

### J'ai un modèle de ticket par défaut mais je veux en utiliser un autre pour une entité particulière, comment procéder ?

Depuis **`Administration`** > **`Entités`**, allez dans l'onglet **`Assistance`**. Vous pouvez changer les modèles de ticket, changement et problème par ceux qui vous conviennent le mieux. Vous pouvez toujours revenir en arrière en cliquant sur **`par défaut`**.

***

### Comment puis-je voir toutes les règles assignées à une entité ?

Depuis **`Administration`** > **`Entités`**, allez dans l'onglet **`Règles`**. Vous pourrez voir toutes les règles qui s'appliquent à l'entité.

***

### Que signifie "Attribut dans le répertoire LDAP représentant l'entité" ?

L'**"attribut d'information du répertoire LDAP représentant l'entité"** est utilisé dans l'action **"Entité basée sur les informations LDAP"** au sein des règles d'autorisation. Cette règle s'appuie sur le résultat d'une expression régulière (regex) dans les critères pour déterminer l'assignation d'entité.

**Exemple** : Si l'attribut **"(LDAP) Organisation"** correspond à la regex `\bTechnician\b` (assurant la présence exacte du mot "Technician"), l'action **"Entité basée sur les informations LDAP"** assignera l'entité définie par l'ID **"#0"**. En utilisant cette règle, GLPI assignera automatiquement les utilisateurs à l'entité où le champ **"Entité basée sur les informations LDAP"** contient la valeur "Technician."

***

### Que signifient **"Répertoire LDAP d'une entité"** et **"Filtre LDAP associé à l'entité (si nécessaire)"** ?

Le **"Répertoire LDAP d'une entité"** et le **"Filtre LDAP associé à l'entité (si nécessaire)"** sont utilisés dans l'interface pour rechercher des utilisateurs depuis un répertoire LDAP en fonction de l'entité spécifiée.

**Exemple** : Si un répertoire LDAP par défaut est défini dans GLPI mais que vous souhaitez ajuster le filtre en fonction de l'entité lors d'un import manuel, ce champ sera utilisé pour affiner la recherche (sinon, le filtre par défaut de la configuration LDAP sera appliqué).

***

### Comment empêcher les utilisateurs de sélectionner manuellement le serveur d'autorisation lorsque plusieurs répertoires Active Directory sont configurés ?

Dans GLPI, vous pouvez décocher cette option pour simplifier le processus de connexion :

<figure><img src="https://3914205414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVU1qbB9Oe25HAYDAQ4tR%2Fuploads%2Fgit-blob-6ba1d0c7f9c54f92dc1b85fcbceb7074b1f908f7%2Fimage%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

* Si l'utilisateur s'est déjà connecté, GLPI tentera la connexion LDAP sur le dernier serveur connu.
* Si l'utilisateur n'est pas trouvé ou ne s'est jamais connecté, GLPI essaiera tous les serveurs LDAP configurés.

Il est essentiel d'assurer des connexions uniques pour vos utilisateurs. Si LDAP1 et LDAP2 ont tous deux un utilisateur avec la connexion "FooBar", GLPI authentifiera l'utilisateur en fonction du premier répertoire qui répond.

Pour garantir l'unicité, vous devriez adapter la configuration GLPI en définissant l'adresse email de l'utilisateur comme champ de connexion. Cette approche aidera à éviter les conflits entre répertoires, comme ceci :

La connexion GLPI de l'utilisateur, ici doit être l'adresse email :

<figure><img src="https://3914205414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVU1qbB9Oe25HAYDAQ4tR%2Fuploads%2Fgit-blob-6d9a34999614c2dfff66cf36c82bc103a4d2862b%2F%7BFD3B7E33-B3A6-4814-B24B-27D86ABD5378%7D.png?alt=media" alt=""><figcaption></figcaption></figure>
