[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({4ed090ac-119c5103})
# Oggetto gruppo utenti

I seguenti oggetti sono direttamente correlati all'API `usergroup`.

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

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

L'oggetto gruppo utenti ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|usrgrpid|ID|ID del gruppo utenti.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *obbligatoria* per le operazioni di aggiornamento|
|name|string|Nome del gruppo utenti.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|debug\_mode|integer|Indica se la modalità di debug è abilitata o disabilitata.<br><br>Valori possibili:<br>0 - *(predefinito)* disabilitata;<br>1 - abilitata.|
|gui\_access|integer|Metodo di autenticazione del frontend per gli utenti del gruppo.<br><br>Valori possibili:<br>0 - *(predefinito)* usa il metodo di autenticazione predefinito del sistema;<br>1 - usa l'autenticazione interna;<br>2 - usa l'autenticazione LDAP;<br>3 - disabilita l'accesso al frontend.|
|mfa\_status|integer|Indica se l'MFA è abilitata o disabilitata per gli utenti del gruppo.<br><br>Valori possibili:<br>0 - disabilitata (per tutti i metodi MFA configurati);<br>1 - abilitata (per tutti i metodi MFA configurati).|
|mfaid|ID|[Metodo MFA](/manual/api/reference/mfa/object) utilizzato per gli utenti del gruppo.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* per utenti di tipo *Super admin*<br>- *supportata* se `mfa_status` dell'[oggetto Authentication](/manual/api/reference/authentication/object#authentication) è impostato su "Enabled"|
|users\_status|integer|Indica se il gruppo utenti è abilitato o disabilitato.<br>Per gli utenti [deprovisioned](/manual/web_interface/frontend_sections/users/authentication#configuration), il gruppo utenti non può essere abilitato.<br><br>Valori possibili:<br>0 - *(predefinito)* abilitato;<br>1 - disabilitato.|
|userdirectoryid|ID|ID della directory utenti utilizzata per l'autenticazione.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *supportata* per utenti di tipo *Super admin*<br>- *supportata* se `gui_access` è impostato su "use the system default authentication method" o "use LDAP authentication"|

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

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

L'oggetto permission ha le seguenti proprietà.

|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|id|ID|ID del gruppo host o del gruppo template a cui aggiungere il permesso.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|permission|integer|Livello di accesso al gruppo host o al gruppo template.<br><br>Valori possibili:<br>0 - accesso negato;<br>2 - accesso in sola lettura;<br>3 - accesso in lettura-scrittura.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio* per le operazioni di creazione|

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

[comment]: # ({fe7438fa-33ad932c})
### Permesso basato su tag

L'oggetto del permesso basato su tag ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|groupid|ID|ID del gruppo host a cui aggiungere il permesso.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio*|
|tag|string|Nome del tag.|
|value|string|Valore del tag.|

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