Partner Login

Diese Anleitung beschreibt die Einrichtung der Statusübernahme aus N-central in venabo.SERVICE.

Damit Statusinformationen korrekt übernommen werden können, müssen zwei Voraussetzungen erfüllt sein:

  1. In N-central muss ein Benutzer mit den erforderlichen Leserechten eingerichtet werden.
  2. Die Statuswerte müssen in venabo.SERVICE exakt mit derselben Schreibweise vorhanden sein.

Schnittstellen dienen dazu, Daten automatisch zwischen Systemen auszutauschen und manuelle Arbeitsschritte zu vermeiden. venabo.SERVICE unterstützt hierfür verschiedene Integrationen und APIs zur Automatisierung von Prozessen.

Voraussetzungen

Für die Einrichtung der Schnittstelle benötigen Sie:

  • Administratorzugriff auf N-central
  • Zugriff auf die Administration von venabo.SERVICE
  • Einen dedizierten API-Benutzer in N-central

Schritt 1: Rolle für den API-Zugriff in N-central erstellen

Damit venabo Statusinformationen aus N-central abrufen kann, benötigt der verwendete Benutzer entsprechende Leserechte (Read Only).

Navigation

  1. Melden Sie sich in N-central an.
  2. Öffnen Sie:
Administration → User Management → Roles
  1. Erstellen Sie eine neue Rolle, z. B.:
Venabo API

Alternativ können Sie eine bestehende Rolle anpassen.

Schritt 2: Berechtigungen für die Rolle setzen

Öffnen Sie die Permissions der Rolle und setzen Sie die folgenden Bereiche mindestens auf Read Only.

Configuration 

Asset Discovery
Discovery Jobs – Read OnlyBackup
Configuration – Read Only

Monitoring 

Filters – Read Only
Service Templates – Read Only
Services / Tasks – Read Only

Security 

Security Profiles – Read Only
Security Servers – Read Only
Security Events – Read Only

Weitere benötigte Rechte 

Device Passphrase – Read Only
Scheduled Tasks – File Repository – Read Only
Update Exclusions – Read Only
Quarantine Management – Read Only
Hinweius
Alle benötigten Berechtigungen müssen mindestens Read Only sein, damit Statusinformationen über die API abgefragt werden können.

Schritt 3: Rolle einem Benutzer zuweisen

  1. Navigieren Sie zu:
Administration → User Management → Users
  1. Öffnen Sie den gewünschten Benutzer.
  2. Weisen Sie die zuvor erstellte Rolle Venabo API zu.

Empfehlung:
Verwenden Sie einen dedizierten API-Benutzer, der ausschließlich für die Integration genutzt wird.

Schritt 4: Statuswerte in venabo anlegen

Damit die Statusinformationen korrekt übernommen werden können, müssen die Statuswerte in venabo.SERVICE vorhanden sein.

Wichtig
Die Status müssen exakt mit derselben Schreibweise angelegt werden.

Benötigte Status

Legen Sie folgende Statuswerte an:

OK
Fehler
Warnung
Nicht verbunden

Schritt 5: Schreibweise prüfen

Die Schreibweise muss identisch zu den aus N-central gelieferten Statuswerten sein.

Beispiele:

N-central Statusvenabo Status
OKOK
FehlerFehler
WarnungWarnung
Nicht verbundenNicht verbunden

⚠️ Bereits kleine Abweichungen führen dazu, dass Status nicht korrekt zugeordnet werden.

Beispiele für falsche Schreibweisen:

ok
FEHLER
Nicht Verbunden
warning

Ergebnis

Nach erfolgreicher Einrichtung:

  • venabo kann Statusinformationen aus N-central abrufen
  • Monitoringmeldungen werden korrekt übernommen
  • Status werden automatisch in venabo verarbeitet

✅ Empfehlung

Für eine stabile Integration sollten:

  • API-Benutzer ausschließlich für Integrationen verwendet werden
  • Änderungen an Rollen regelmäßig überprüft werden
  • Statusbezeichnungen in beiden Systemen identisch gehalten werden
Inhaltsverzeichnis