Benutzergruppen-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der usergroup API.

Benutzergruppe

Das Objekt „Benutzergruppe“ hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
usrgrpid ID ID der Benutzergruppe.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
name string Name der Benutzergruppe.

Verhalten der Eigenschaft:
- 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.

Verhalten der Eigenschaft:
- unterstützt für Benutzer vom Typ Super admin
- unterstützt, wenn mfa_status des Authentifizierungsobjekts auf „Enabled“ gesetzt ist
users_status integer Gibt an, ob die Benutzergruppe aktiviert oder deaktiviert ist.
Für deprovisionierte 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:
- 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

Berechtigung

Das Berechtigungsobjekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
id ID ID der Host-Gruppe oder Vorlagengruppe, der eine Berechtigung hinzugefügt werden soll.

Verhalten der Eigenschaft:
- 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:
- erforderlich für Erstellungsoperationen

Tag-basierte Berechtigung

Das Objekt für tag-basierte Berechtigungen hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
groupid ID ID der Host-Gruppe, der die Berechtigung hinzugefügt werden soll.

Property behavior:
- required
tag string Tag-Name.
value string Tag-Wert.