Konfiguration über YAML

Neben der Verwaltung der Unternehmen und Nutzenden über die grafische Oberfläche des Myra DataHub haben Sie zudem die Möglichkeit, sämtliche Konfigurationen mittels YAML-Dateien vorzunehmen.

Damit das Anlegen von Unternehmen, deren Nutzenden und deren Netzwerken funktioniert, müssen die Anweisungen als YAML im nachstehenden Format übergeben werden.

custname: 'Client A'                          
timestamp: 2025-02-27 143232                 
portal:
  enabled: true                               
  email: noc@myrasecurity.com                 
  lastname: Myra                              
  forename: Security                          
1.1.1.1/32:                                   
  enabled: true                               
  email:                                      
    - noc@myrasecurity.com
  pps_limit: 500000                           
  bw_limit: 4000                              
  duration: 14400                             
  type: ACTION_BLACKHOLE
  wholenet:
    enabled: true     
  nettype: RIPE (PI)                       
  extra:                                      
    INTERNET-SERVICEKENNUNG: L2220001         
    CUSTNETNAME: Network 1                    
    DIENST-ID: HWDDSxxx                       
    DEBITOR: Debitor 2                        
    CHANNEL: 1000   
    DETAILS: Description for the network

Note

Sie können mit der YAML-Datei nur Unternehmen und jeweils einen Nutzenden mit Admin-Rechten hinzufügen. Das Ändern und Löschen ist per YAML nicht möglich und muss in der grafischen Benutzeroberfläche vorgenommen werden.

Note

Sie können mit der YAML-Datei ein oder mehrere Netzwerke einem Unternehmen hinzufügen, ändern oder löschen.

Note

Sie können mit der YAML-Datei für Unternehmen nicht die SIEM-Integration (Security Information and Event Management) aktivieren. Die Aktivierung von SIEM für ein Unternehmen ist nur über die grafische Benutzeroberfläche des Myra DataHub möglich.

Die Werte, die im YAML-Format übergeben werden, entsprechen den Informationen in der grafischen Benutzeroberfläche des Myra DataHub und lassen sich wie folgt zuordnen:

Element	Beschreibung
Unternehmenskonten	YAML - Unternehmenskonten
Benutzerverwaltung	YAML - Nutzerverwaltung 1
	YAML - Nutzerverwaltung 2
Netzwerke	YAML - Netzwerke

Im Folgenden finden Sie eine tabellarische Zuordnung aller Werte in der YAML-Datei und auf der grafischen Benutzeroberfläche:

Abgleich der Felder in der Myra DataHub UI mit der YAML-Datei

Myra DataHub UI	YAML	Beschreibung
Unternehmen
Name	`Custname`	Name des Kunden
Kunden-ID	`Name der YAML-Datei`	Individuelle ID des Kunden

Nutzerverwaltung
E-Mail-Adresse	`Portal: email`	E-Mail-Adresse des ersten Adminkontos. ℹ️ Hinweis: Beim Hinzufügen eines neuen Unternehmens über die YAML-Datei wird nur ein Nutzender mit Admin-Rechten angelegt. Weitere Konten können nur über die grafische Benutzeroberfläche hinzugefügt werden.
Name	`portal: lastname`	Name des ersten Adminkontos.
Name	`portal: forename`	Vorname des ersten Adminkontos.
	`portal: enabled`	Nur in YAML: Definiert, ob ein Adminkonto für das neue Unternehmen angelegt wird. Die folgenden Werte sind verfügbar: `true`: Ein Adminkonto wird angelegt. `false`: Ein Adminkonto wird nicht angelegt.
Netzwerke
Name	`extra: CUSTNETNAME`	Der Name des Netzwerkes.
IP	`CIDR`	Die IP-Adresse des Netzwerkes.
Paketraten-Schwellenwert (Pakete/s)	`pps_limit`	Der Schwellenwert für die maximale Anzahl der erlaubten Pakete pro Sekunde.
Dienst-ID	`extra: DIENST-ID`	Ein Versatel-spezifischer Wert.
Channel	`extra: CHANNEL`	Ein Versatel-spezifischer Wert.
Netzwerktyp	`nettype`	Der Netzwerktyp für das entsprechende Netzwerk. Die folgenden Werte sind verfügbar: `RIPE`: Nutzt das Regional Internet Registry for Europe (RIPE) als Netzwerktyp. `RIPE (PI)`: Nutzt den Provider Independent Address Space (PI-Adressraum) als Netzwerktyp. `RIPE (LIR)`: Nutzt das Local Internet Registry (LIR) als Netzwerktyp. `RIPE (AS8881)`: Nutzt das autonome System (AS) von Versatel als Netzwerktyp. `SUBNET` or `Subnet`: Nutzt einen selbstdefinierten IP-Adressbereich als Netzwerktyp.
Netzwerk Referenz	`extra: INTERNET-SERVICEKENNUNG`	Enthält die Unique L-Number für die Internetleitung, über die die Kunden bei Versatel angebunden werden.
Bandbreiten-Schwellenwert (MBit/s)	`bw_limit`	Der Schwellenwert für die maximale Höhe der möglichen Bandbreite.
Dauer der Mitigation (in Sek)	`duration`	Die Dauer der Mitigation in Sekunden, nachdem der Datenverkehr unterhalb der Schwellwerte gefallen ist.
Debitor	`extra: DEBITOR`	Ein Versatel-spezifischer Wert.
Details	`extra: DETAILS`	Ein individueller Kommentar zur Beschreibung des Netzwerkes.
Mitigationstyp	`type`	Definition der Art und Weise, wie die Mitigation durchgeführt wird. Die folgenden Werte sind verfügbar: ACTION_BLACKHOLE: Bei Überschreitung des Schwellenwertes wird der komplette Traffic verworfen. ACTION_MITIGATE_ONPREM: Bei Überschreitung des Schwellenwertes wird der Traffic über die internen Server bereinigt. ACTION_MITIGATE_CLOUD: Bei Überschreitung des Schwellenwertes wird der Traffic über das Myra Scrubbing Center bereinigt.
Mitigationsstrategie	Wholenet: enabled	Definiert, ob nur eine einzelne IP-Adresse oder das ganze Netzwerk automatisch mitigiert wird. Die folgenden Werte sind verfügbar: `IP`: Es wird nur eine einzelne IP-Adresse des Netzwerkes automatisch mitigiert. `CIDR`: Es wird das komplette Netzwerk automatisch mitigiert.
E-Mail-Adresse für Benachrichtigungen	email	Die E-Mail-Adresse des Nutzenden, an den Mitteilungen zur Mitigation gehen.
Automatische Aktionen	enabled	Zeigt an, ob eine automatische Mitigation für das ausgewählte Netzwerk durchgeführt wird oder nicht. Die folgenden Werte sind verfügbar: `true`: Die automatische Mitigation ist aktiviert. `false`: Die automatische Mitigation ist deaktiviert.