[comment]: # aside: 1
[comment]: # translation:outdated
[comment]: # ({4ed090ac-119c5103})
# Benutzergruppen-Objekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der `usergroup` API.
[comment]: # ({/4ed090ac-119c5103})
[comment]: # ({88416027-3c2622e5})
### Benutzergruppe
Das Objekt „Benutzergruppe“ hat die folgenden Eigenschaften.
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|usrgrpid|ID|ID der Benutzergruppe.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*
- *erforderlich* für Aktualisierungsvorgänge|
|name|string|Name der Benutzergruppe.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsvorgänge|
|debug\_mode|integer|Gibt an, ob der Debug-Modus aktiviert oder deaktiviert ist.
Mögliche Werte:
0 - *(Standard)* deaktiviert;
1 - aktiviert.|
|gui\_access|integer|Authentifizierungsmethode im Frontend für die Benutzer in der Gruppe.
Mögliche Werte:
0 - *(Standard)* die standardmäßige Authentifizierungsmethode des Systems verwenden;
1 - interne Authentifizierung verwenden;
2 - LDAP-Authentifizierung verwenden;
3 - Zugriff auf das Frontend deaktivieren.|
|mfa\_status|integer|Gibt an, ob MFA für die Benutzer in der Gruppe aktiviert oder deaktiviert ist.
Mögliche Werte:
0 - deaktiviert (für alle konfigurierten MFA-Methoden);
1 - aktiviert (für alle konfigurierten MFA-Methoden).|
|mfaid|ID|Für die Benutzer in der Gruppe verwendete [MFA-Methode](/manual/api/reference/mfa/object).
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *unterstützt* für Benutzer vom Typ *Super admin*
- *unterstützt*, wenn `mfa_status` des [Authentifizierungsobjekts](/manual/api/reference/authentication/object#authentication) auf „Enabled“ gesetzt ist|
|users\_status|integer|Gibt an, ob die Benutzergruppe aktiviert oder deaktiviert ist.
Für [deprovisionierte](/manual/web_interface/frontend_sections/users/authentication#configuration) Benutzer kann die Benutzergruppe nicht aktiviert werden.
Mögliche Werte:
0 - *(Standard)* aktiviert;
1 - deaktiviert.|
|userdirectoryid|ID|ID des für die Authentifizierung verwendeten Benutzerverzeichnisses.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *unterstützt* für Benutzer vom Typ *Super admin*
- *unterstützt*, wenn `gui_access` auf „die standardmäßige Authentifizierungsmethode des Systems verwenden“ oder „LDAP-Authentifizierung verwenden“ gesetzt ist|
[comment]: # ({/88416027-3c2622e5})
[comment]: # ({28634bb8-ba46c802})
### Berechtigung
Das Berechtigungsobjekt hat die folgenden Eigenschaften.
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|id|ID|ID der Host-Gruppe oder Vorlagengruppe, der eine Berechtigung hinzugefügt werden soll.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *erforderlich*|
|permission|integer|Zugriffsebene auf die Host-Gruppe oder Vorlagengruppe.
Mögliche Werte:
0 - Zugriff verweigert;
2 - schreibgeschützter Zugriff;
3 - Lese-/Schreibzugriff.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsoperationen|
[comment]: # ({/28634bb8-ba46c802})
[comment]: # ({fe7438fa-33ad932c})
### Tag-basierte Berechtigung
Das Objekt für tag-basierte Berechtigungen hat die folgenden Eigenschaften.
|Eigenschaft|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|groupid|ID|ID der Host-Gruppe, der die Berechtigung hinzugefügt werden soll.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|tag|string|Tag-Name.|
|value|string|Tag-Wert.|
[comment]: # ({/fe7438fa-33ad932c})