[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({4ed090ac-119c5103})
# Objet groupe d'utilisateurs

Les objets suivants sont directement liés à l'API `usergroup`.

[comment]: # ({/4ed090ac-119c5103})

[comment]: # ({88416027-3c2622e5})
### Groupe d'utilisateurs

L'objet groupe d'utilisateurs possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|usrgrpid|ID|ID du groupe d'utilisateurs.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*<br>- *obligatoire* pour les opérations de mise à jour|
|name|string|Nom du groupe d'utilisateurs.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|debug\_mode|integer|Indique si le mode de débogage est activé ou désactivé.<br><br>Valeurs possibles :<br>0 - *(par défaut)* désactivé ;<br>1 - activé.|
|gui\_access|integer|Méthode d'authentification de l'interface pour les utilisateurs du groupe.<br><br>Valeurs possibles :<br>0 - *(par défaut)* utiliser la méthode d'authentification par défaut du système ;<br>1 - utiliser l'authentification interne ;<br>2 - utiliser l'authentification LDAP ;<br>3 - désactiver l'accès à l'interface.|
|mfa\_status|integer|Indique si l'authentification multifacteur (MFA) est activée ou désactivée pour les utilisateurs du groupe.<br><br>Valeurs possibles :<br>0 - désactivée (pour toutes les méthodes MFA configurées) ;<br>1 - activée (pour toutes les méthodes MFA configurées).|
|mfaid|ID|[Méthode MFA](/manual/api/reference/mfa/object) utilisée pour les utilisateurs du groupe.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *pris en charge* pour les utilisateurs de type *Super admin*<br>- *pris en charge* si `mfa_status` de l'[objet Authentication](/manual/api/reference/authentication/object#authentication) est défini sur "Enabled"|
|users\_status|integer|Indique si le groupe d'utilisateurs est activé ou désactivé.<br>Pour les utilisateurs [déprovisionnés](/manual/web_interface/frontend_sections/users/authentication#configuration), le groupe d'utilisateurs ne peut pas être activé.<br><br>Valeurs possibles :<br>0 - *(par défaut)* activé ;<br>1 - désactivé.|
|userdirectoryid|ID|ID du répertoire d'utilisateurs utilisé pour l'authentification.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *pris en charge* pour les utilisateurs de type *Super admin*<br>- *pris en charge* si `gui_access` est défini sur "use the system default authentication method" ou "use LDAP authentication"|

[comment]: # ({/88416027-3c2622e5})

[comment]: # ({28634bb8-ba46c802})
### Autorisation

L'objet d'autorisation possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|id|ID|ID du groupe d'hôtes ou du groupe de modèles auquel ajouter l'autorisation.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire*|
|permission|integer|Niveau d'accès au groupe d'hôtes ou au groupe de modèles.<br><br>Valeurs possibles :<br>0 - accès refusé ;<br>2 - accès en lecture seule ;<br>3 - accès en lecture-écriture.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* pour les opérations de création|

[comment]: # ({/28634bb8-ba46c802})

[comment]: # ({fe7438fa-33ad932c})
### Autorisation basée sur les tags

L'objet d'autorisation basée sur les tags possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|groupid|ID|ID du groupe d'hôtes auquel ajouter l'autorisation.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|tag|string|Nom du tag.|
|value|string|Valeur du tag.|

[comment]: # ({/fe7438fa-33ad932c})