SHD Connect - Macmon-Adapter

SHD Connect - Macmon-Adapter

Mit dem Macmon-Adapter ist es möglich, Netzwerkgeräte, Endpunkte und Netzwerk-Segmente von Macmon nach i-doit zu importieren.

Zur Nutzung des Adapters benötigen Sie eine entsprechende Lizenz, welche Sie über den Marketplace von synetics oder direkt von SHD erhalten können.

Inhalt

Basiseinstellungen

Neben den allgemeinen Basiseinstellungen können Sie für den Macmon-Adapter folgende Einstellungen vornehmen:

 

grafik-20250926-030827.png
Basiseinstellungen des Macmon-Adapters
  • API URL: Die Basis-URL zur Macmon-Instanz einschließlich der API-Version, ohne abschließenden “/”.

  • Nutzername: Ein gültiger Nutzername mit Zugriff auf die API der Macmon-Instanz.

  • Passwort: Das entsprechende Passwort des Nutzers.

  • Import Modus: Auswahl, welcher Elementtyp importiert werden soll. Folgende Möglichkeiten stehen dabei zur Verfügung:

    • Netzwerkgeräte

    • Endpunkte

    • Netzwerk-Segmente

  • Import Limit: Maximale Anzahl der Objekte, welche importiert werden.

  • Filter: Individueller Filter, basierend auf den Optionen der Macmon REST-API. Die Dokumentation der Macmon REST-API können Sie direkt im Hilfemenü Ihrer Macmon-Instanz herunterladen. Beispiele:

    • networkDeviceGroup.name == “Switch”

    • endpointGroup.name == “Infrastruktur“

  • Anschlüsse importieren: Importiert Anschlüsse von Netzwerk- und Endgeräten

  • Verbindungen importieren: Importiert Verbindungen zwischen Netzwerk- und Endgeräten

Konfiguration des Mappings

Zum Bearbeiten der Konfiguration wechseln Sie bitte mit einem Klick auf den Knopf “Editieren” in den Bearbeitungsmodus.

Die Konfiguration des Objekttyp-Mappers und des Objekt-Matchings sind unter folgendem Link beschrieben: https://smdocu.atlassian.net/wiki/x/AQDli

Import

Neben dem automatischen, zeitgesteuerten Import haben Sie zusätzlich die Möglichkeit, einen Import manuell zu starten.

grafik-20250926-030940.png
Start eines manuellen Imports

Mit einem Klick auf den Knopf “Import starten” werden die jeweiligen Daten nach i-doit importiert.

Durch Klicken auf den Knopf “Bisherige Importe anzeigen” können Sie sich eine Übersicht der bereits durchgeführten Importe anzeigen lassen.

Welche Daten werden importiert?

Folgende Daten können grundsätzlich importiert werden:

  • Netzwerkgeräte

    • mit allgemeinen Werten

    • mit Hostadress-Daten

    • mit Seriennummer (falls vorhanden)

    • optional: mit vorhandenen Anschlüssen und deren MAC-Adresse

  • Endpunkte

    • mit allgemeinen Werten

    • mit Hostadress-Daten

    • optional: mit vorhandenem Anschluss und dessen MAC-Adresse

    • optional: mit deren Verbindungen zu Netzwerkgeräten (die Beziehung zwischen Endgerät und Netzwerkgerät wird dabei über die MAC-Adresse des Anschlusses aufgelöst)

  • Netzwerk-Segmente

    • mit allgemeinen Werten

    • mit Netzbereichs-Daten

Standardzuweisung

Ohne dass ein Mapping vorgenommen wird werden bereits folgende Standardwerte befüllt.

Für Netzwerkgeräte:

Quell-Wert

Ziel-Kategorie

Ziel-Wert

Quell-Wert

Ziel-Kategorie

Ziel-Wert

label

Allgemein

title

description

Allgemein

description

label

Hostadresse

hostname

label

Hostadresse

fqdn

address

Hostadresse

ip_address

interfaces.*.ifName

Port

title

interfaces.*.ifSpeed

Port

speed

interfaces.*.ifPhysAddress

Port

mac_address

interfaces.*.ifMtu

Port

mtu

interfaces.*.ifType

Port

type

serial_numbers

Modell

serial

Für Endpunkte:

Quell-Wert

Ziel-Kategorie

Ziel-Wert

Quell-Wert

Ziel-Kategorie

Ziel-Wert

comment

Allgemein

description

endpointDeviceStatus.lastDns

Hostadresse

hostname

endpointDeviceStatus.lastDns

Hostadresse

fqdn

endpointDeviceStatus.lastIp

Hostadresse

ip_address

networkSessions.interface.ifPhysAddress

Port

mac_address

Für Netzwerk-Segmente:

Quell-Wert

Ziel-Kategorie

Ziel-Wert

Quell-Wert

Ziel-Kategorie

Ziel-Wert

networkAddress | subnetMask

Allgemein

title

comment

Allgemein

description

networkAddress

Netz

address

subnetMask

Netz

netmask

© 2025 SHD System-Haus-Dresden GmbH | Impressum https://www.shd-online.de/impressum/