Rollen-Objekt

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

Rolle

Das Rollenobjekt hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
roleid ID ID der Rolle.

Eigenschaftsverhalten:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
name string Name der Rolle.

Eigenschaftsverhalten:
- erforderlich für Erstellungsvorgänge
type integer Benutzertyp.

Mögliche Werte:
1 - (Standard) Benutzer;
2 - Admin;
3 - Super-Admin.

Eigenschaftsverhalten:
- erforderlich für Erstellungsvorgänge
readonly integer Gibt an, ob die Rolle schreibgeschützt ist.

Mögliche Werte:
0 - (Standard) Nein;
1 - Ja.

Eigenschaftsverhalten:
- schreibgeschützt

Rollenregeln

Das Objekt für Rollenregeln hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
ui array Array der Objekte vom Typ UI-Element.
ui.default_access integer Gibt an, ob der Zugriff auf neue UI-Elemente aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (Standard) Aktiviert.
services.read.mode integer Schreibgeschützter Zugriff auf Services.

Mögliche Werte:
0 - Schreibgeschützter Zugriff auf die Services, die durch die Eigenschaften services.read.list angegeben oder durch services.read.tag abgeglichen werden;
1 - (Standard) Schreibgeschützter Zugriff auf alle Services.
services.read.list array Array von Service-Objekten.

Den angegebenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle schreibgeschützter Zugriff gewährt. Schreibgeschützter Zugriff überschreibt keinen Lese-/Schreibzugriff auf die Services.

Verhalten der Eigenschaft:
- unterstützt, wenn services.read.mode auf "0" gesetzt ist
services.read.tag object Array von Service-Tag-Objekten.

Den über Tags abgeglichenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle schreibgeschützter Zugriff gewährt. Schreibgeschützter Zugriff überschreibt keinen Lese-/Schreibzugriff auf die Services.

Verhalten der Eigenschaft:
- unterstützt, wenn services.read.mode auf "0" gesetzt ist
services.write.mode integer Lese-/Schreibzugriff auf Services.

Mögliche Werte:
0 - (Standard) Lese-/Schreibzugriff auf die Services, die durch die Eigenschaften services.write.list angegeben oder durch services.write.tag abgeglichen werden;
1 - Lese-/Schreibzugriff auf alle Services.
services.write.list array Array von Service-Objekten.

Den angegebenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle Lese-/Schreibzugriff gewährt. Lese-/Schreibzugriff überschreibt schreibgeschützten Zugriff auf die Services.

Verhalten der Eigenschaft:
- unterstützt, wenn services.write.mode auf "0" gesetzt ist
services.write.tag object Array von Service-Tag-Objekten.

Den über Tags abgeglichenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle Lese-/Schreibzugriff gewährt. Lese-/Schreibzugriff überschreibt schreibgeschützten Zugriff auf die Services.

Verhalten der Eigenschaft:
- unterstützt, wenn services.write.mode auf "0" gesetzt ist
modules array Array der Modul-Objekte.
modules.default_access integer Gibt an, ob der Zugriff auf neue Module aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (Standard) Aktiviert.
api.access integer Gibt an, ob der Zugriff auf die API aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (Standard) Aktiviert.
api.mode integer Modus für die Behandlung der in der Eigenschaft api aufgeführten API-Methoden.

Mögliche Werte:
0 - (Standard) Sperrliste;
1 - Zulassungsliste.
api array Array von API-Methoden.
actions array Array der Aktion-Objekte.
actions.default_access integer Gibt an, ob der Zugriff auf neue Aktionen aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (Standard) Aktiviert.

UI-Element

Das UI-Element-Objekt hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
name string Name des UI-Elements.

Mögliche Werte, wenn type des Role-Objekts auf "User", "Admin" oder "Super admin" gesetzt ist:
monitoring.dashboard - Dashboards;
monitoring.problems - Monitoring → Probleme;
monitoring.hosts - Monitoring → Hosts;
monitoring.latest_data - Monitoring → Letzte Daten;
monitoring.maps - Monitoring → Karten;
services.services - Services → Services;
services.sla_report - Services → SLA-Bericht;
inventory.overview - Inventar → Übersicht;
inventory.hosts - Inventar → Hosts;
reports.availability_report - Berichte → Verfügbarkeitsbericht;
reports.top_triggers - Berichte → Top 100 Auslöser.

Mögliche Werte, wenn type des Role-Objekts auf "Admin" oder "Super admin" gesetzt ist:
monitoring.discovery - Monitoring → Discovery;
services.sla - Services → SLA;
reports.scheduled_reports - Berichte → Geplante Berichte;
reports.notifications - Berichte → Benachrichtigungen;
configuration.template_groups - Datenerfassung → Vorlagengruppen;
configuration.host_groups - Datenerfassung → Host-Gruppen;
configuration.templates - Datenerfassung → Vorlagen;
configuration.hosts - Datenerfassung → Hosts;
configuration.maintenance - Datenerfassung → Wartung;
configuration.discovery - Datenerfassung → Discovery;
configuration.trigger_actions - Warnmeldungen → Aktionen → Auslöser-Aktionen;
configuration.service_actions - Warnmeldungen → Aktionen → Service-Aktionen;
configuration.discovery_actions - Warnmeldungen → Aktionen → Discovery-Aktionen;
configuration.autoregistration_actions - Warnmeldungen → Aktionen → Aktionen zur automatischen Registrierung;
configuration.internal_actions - Warnmeldungen → Aktionen → Interne Aktionen.

Mögliche Werte, wenn type des Role-Objekts auf "Super admin" gesetzt ist:
reports.system_info - Berichte → Systeminformationen;
reports.audit - Berichte → Auditprotokoll;
reports.action_log - Berichte → Aktionsprotokoll;
configuration.event_correlation - Datenerfassung → Ereigniskorrelation;
administration.media_types - Warnmeldungen → Medientypen;
administration.scripts - Warnmeldungen → Skripte;
administration.user_groups - Benutzer → Benutzergruppen;
administration.user_roles - Benutzer → Benutzerrollen;
administration.users - Benutzer → Benutzer;
administration.api_tokens - Benutzer → API-Tokens;
administration.authentication - Benutzer → Authentifizierung;
administration.general - Administration → Allgemein;
administration.audit_log - Administration → Auditprotokoll;
administration.housekeeping - Administration → Bereinigung;
administration.proxy_groups - Administration → Proxy-Gruppen;
administration.proxies - Administration → Proxys;
administration.macros - Administration → Makros;
administration.queue - Administration → Warteschlange.

Verhalten von Eigenschaften:
- erforderlich
status integer Gibt an, ob der Zugriff auf das UI-Element aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (Standard) Aktiviert.

Service

Eigenschaft Typ Beschreibung
serviceid ID ID des Service.

Verhalten der Eigenschaft:
- erforderlich

Service-Tag

Eigenschaft Typ Beschreibung
tag string Tag-Name.

Wenn eine leere Zeichenfolge angegeben wird, wird das Service-Tag nicht für den Service-Abgleich verwendet.

Verhalten der Eigenschaft:
- erforderlich
value string Tag-Wert.

Wenn kein Wert oder eine leere Zeichenfolge angegeben wird, wird nur der Tag-Name für den Service-Abgleich verwendet.

Modul

Das Modulobjekt hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
moduleid ID ID des Moduls.

Eigenschaftsverhalten:
- erforderlich
status integer Gibt an, ob der Zugriff auf das Modul aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (Standard) Aktiviert.

Aktion

Das Aktionsobjekt hat die folgenden Eigenschaften:

Eigenschaft Typ Beschreibung
name string Name der Aktion.

Mögliche Werte, wenn type des Role-Objekts auf "User", "Admin" oder "Super admin" gesetzt ist:
edit_dashboards - Dashboards erstellen und bearbeiten;
edit_maps - Karten erstellen und bearbeiten;
add_problem_comments - Problemkommentare hinzufügen;
change_severity - Problemschweregrad ändern;
acknowledge_problems - Probleme bestätigen;
suppress_problems - Probleme unterdrücken;
close_problems - Probleme schließen;
execute_scripts - Skripte ausführen;
manage_api_tokens - API-Tokens verwalten;
change_problem_ranking - Die Problemrangfolge von Ursache zu Symptom und umgekehrt ändern;
edit_own_media - Erstellen/Bearbeiten eigener Medien erlauben.

Mögliche Werte, wenn type des Role-Objekts auf "Admin" oder "Super admin" gesetzt ist:
edit_maintenance - Wartungen erstellen und bearbeiten;
manage_scheduled_reports - Geplante Berichte verwalten,
manage_sla - SLA verwalten.

Mögliche Werte, wenn type des Role-Objekts auf "User" oder "Admin" gesetzt ist:
invoke_execute_now - erlaubt das Ausführen von Datenpunkt-Prüfungen für Benutzer, die nur Leseberechtigungen auf dem Host haben.

Mögliche Werte, wenn type des Role-Objekts auf "Super admin" gesetzt ist:
edit_user_media - Erstellen/Bearbeiten von Medien für Benutzer erlauben.

Eigenschaftsverhalten:
- erforderlich
status integer Ob der Zugriff zum Ausführen der Aktion aktiviert ist.

Mögliche Werte:
0 - Deaktiviert;
1 - (Standard) Aktiviert.