Skip to content

ERP-Kopplung (DATAZONE ERP) ​

Die ERP-Kopplung verbindet DATAZONE Control optional mit dem DATAZONE ERP. Sie ist standardmaessig ausgeschaltet; ein Update verschickt nie von selbst Daten. Ohne ERP laeuft Control vollstaendig weiter.

Die Kopplung arbeitet in zwei Richtungen:

RichtungWas passiert
Kundenabruf (ERP -> Control)Control zieht die komplette Kundenliste aus dem ERP und haelt sie lokal vor. Techniker koennen damit auch Kunden zuordnen, die in Control noch keine Hosts haben.
Inventar-Push (Control -> ERP)Control meldet pro Kunde, welche Produkte ueberwacht werden (Merkmale mit Anzahl). Das ERP nutzt das fuer Segmente wie "alle PVE-Kunden ohne PBS".

Einrichtung ​

Pfad: Seitenleiste Verwaltung → Einstellungen > ERP-Kopplung. Nur fuer Administratoren sichtbar.

FeldBeschreibung
Kopplung aktivSchaltet Abruf und Push ein. Zum Aktivieren muessen Adresse und Secret gesetzt sein.
ERP-AdresseBasis-Adresse ohne Pfad, z. B. http://10.0.0.12:8000. Die Endpunkte werden angehaengt.
SecretDasselbe Secret wie im ERP unter Einstellungen > Integrationen > DATAZONE Control. Wird nur geschrieben, nie angezeigt.
Intervall KundenabrufMinuten zwischen inkrementellen Abrufen (Standard 60).
Intervall Inventar-PruefungMinuten zwischen Aenderungspruefungen des Inventars (Standard 5).
NachtlaufUhrzeit (UTC), zu der einmal taeglich der komplette Kundenabruf und der Vollbestand aller Kunden laufen.

Ablauf:

  1. Im ERP das Secret erzeugen und die Inventar-Kopplung einschalten.
  2. In Control Adresse und Secret eintragen, Verbindung testen.
  3. Kopplung aktiv setzen und Speichern.
  4. Optional Kunden jetzt abrufen und Inventar jetzt senden fuer den Erstabgleich. Sonst erledigt das der Hintergrundlauf innerhalb weniger Minuten.

TIP

Der Verbindungstest funktioniert auch bei ausgeschalteter Kopplung. Er prueft Erreichbarkeit und Secret, ohne Daten zu veraendern.

Kundenabruf ​

  • Die Zuordnung erfolgt ausschliesslich ueber die Kundennummer als Zeichenkette. Namen dienen nur der Anzeige, da sie im ERP mehrfach vorkommen und sich aendern koennen.
  • Vom ERP ueberschrieben werden Name, Namenszusatz, Ort und der Aktiv-Status. Control-eigene Felder (Tags, Wazuh-Level, Kontakt) bleiben erhalten.
  • Inaktive Kunden kommen mit und bleiben auswaehlbar, werden aber markiert und in Auswahllisten hinten einsortiert.
  • Kunden, die in Control existieren, aber nicht in der ERP-Liste sind, werden nie geloescht, sondern mit dem Hinweis nicht im ERP markiert.
  • Bei aktiver Kopplung koennen in Control keine Kunden angelegt werden. Neue Kunden entstehen im ERP und erscheinen nach dem naechsten Abruf.
  • Ein leerer Vollbestand vom ERP wird verworfen, der lokale Stand bleibt. Ist das ERP nicht erreichbar, arbeitet Control mit dem letzten Stand weiter.

Inventar-Push ​

Gemeldete Merkmale (Schluessel in Kleinschreibung):

SchluesselQuelleAnzahl
pveModul Proxmox VEPVE-Hosts
pve_vmModul Proxmox VEVMs + Container ueber alle PVE-Hosts
pbsModul Proxmox Backup ServerPBS-Hosts
opnsenseModul OPNsenseFirewalls
windowsModul Windowsueberwachte Windows-Maschinen (nur mit Agent)
linuxModul Linuxueberwachte Linux-Maschinen (nur mit Agent; PVE/PBS-Hosts zaehlen nicht)
vmwareHardware-Hersteller der Agent-HostsHosts, die als VM auf VMware laufen (schwaches Signal)
veeamWindows-SoftwareinventarHosts mit Veeam Backup & Replication (schwaches Signal, keine Agents/Plug-ins)

Zu jedem Merkmal gehen das aelteste bekannte Datum (seit) und die Hostnamen (ref) mit, damit das ERP die Herkunft nachvollziehen kann.

Regeln:

  • Jede Meldung ist ein Vollbestand des Kunden: nicht gelistete Merkmale gelten im ERP als entfernt (dort nur datiert, nie geloescht).
  • Control erkennt Aenderungen ueber einen Hash des zuletzt gemeldeten Stands und meldet nur geaenderte Kunden. Kunden ohne Hosts, die frueher gemeldet wurden, werden einmal mit leerer Liste gemeldet.
  • Fehlgeschlagene Meldungen bleiben offen und werden mit steigendem Abstand (bis 60 Minuten) wiederholt. Der Nachtlauf sendet alle Kunden und heilt verlorene Einzelmeldungen.
  • Die Signatur ist ein HMAC-SHA256 ueber die gesendeten Rohbytes (X-DC-Signature: sha256=<hex>).
  • Antwortet das ERP mit ok: false, gilt die Meldung als abgelehnt und bleibt offen. Manueller Lauf und Hintergrundlauf sperren sich gegenseitig, ein paralleler Start wird mit einem Hinweis abgewiesen.
  • Der Schalter Kopplung aktiv ist nur mit gesetzter Adresse und Secret wirksam; der Verbindungstest funktioniert unabhaengig davon.

Status und Kontrolle ​

Der Tab zeigt fuer Kundenabruf und Inventar-Push den letzten Erfolg, Anzahl, Auslöser (manuell, automatisch, Nachtlauf) und den letzten Fehler. Unbekannte Kundennummern und unbekannte Merkmale aus der ERP-Antwort werden angezeigt und ins Audit-Log geschrieben.

Die Vorschau listet pro Kunde, was Control melden wuerde, und ob die Meldung ausstehend oder bereits gemeldet ist.

Hinweis zur Datenqualitaet

windows und linux zaehlen nur Maschinen mit DATAZONE-Agent, nicht den gesamten Bestand des Kunden. vmware und veeam basieren auf wenigen Agent-Hosts und sind als Vertriebssignal gedacht, nicht als Inventar.

DATAZONE Control Documentation