Einstellungen einer Organisation ändern¶

Senden einer PATCH-Anfrage an den Endpunkt /organisations/{organisation}.

Beschreibung¶

Nur SOC. Mit der Change-Organisation-Anfrage ändern Sie die Einstellungen einer Organisation.

Voraussetzungen¶

Werte der Anfrage: Organisation-ID {organisation}

Objekte: keine

Anfrage¶

Um die Einstellungen einer Organisation zu ändern, fügen Sie die Organisation-ID {organisation} in den Pfad der Anfrage ein.

Für eine detaillierte Spezifikation, welche Informationen zum Ändern der Einstellungen einer Organisation erforderlich sind, können die folgenden Attribute im Body definiert werden.

Die folgenden Attribute sind optional:

Attribut	Beschreibung	Werte
`name`	Der Name der Organisation.	`string`
`customer_id` (falls Kundenreferenzen aktiviert)	Eine eindeutige Kundenreferenz für die Organisation.	`string`
`showReports`	Definiert, ob Berichte für diese Organisation angezeigt werden.	`true` `false`
`siemEnabled`	Definiert, ob SIEM für diese Organisation aktiviert ist.	`true` `false`
`siemProvider`	Der Name des SIEM-Anbieters.	`string`
`thresholdsInPercentageEnabled` (falls prozentuale Schwellenwerte aktiviert)	Zeigt an, ob Mitigations-Schwellenwerte für diese Organisation als Prozentwert definiert sind.	`true` `false`
`trafficReportsEnabled` (falls Traffic-Reports aktiviert)	Zeigt an, ob Traffic-Reports für diese Organisation angezeigt und heruntergeladen werden können.	`true` `false`
`anomaliesEnabled` (falls Anomalien aktiviert)	Definiert, ob die Funktion Anomalien für diese Organisation aktiviert ist, einschließlich der Benachrichtigungs-E-Mails zu erkannten Anomalien und zu startenden und endenden Mitigationen.	`true` `false`
`emails`	Die vollständige Liste der Benachrichtigungsadressen der Organisation. Jeder Eintrag muss eine gültige und eindeutige E-Mail-Adresse sein. Die übermittelte Liste ersetzt die bisherigen Adressen; neu hinzugefügte Adressen erhalten eine Bestätigungs-E-Mail und werden erst nach der Bestätigung für Benachrichtigungen verwendet.	`array` von `string`

Das System gibt bei einer erfolgreichen Anfrage lediglich einen HTTP-Statuscode 200 zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "name": "string",
  "customer_id": "string",
  "showReports": true,
  "siemEnabled": true,
  "siemProvider": "string",
  "thresholdsInPercentageEnabled": true,
  "trafficReportsEnabled": true,
  "anomaliesEnabled": true,
  "emails": [
    "alerts@example.com"
  ]
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.
422	Die Anfrage war nicht erfolgreich, da die übermittelten Daten nicht verarbeitet werden konnten.