Netzwerk und MikroTik
Diese Seite beschreibt, wie COD Switches und Router erfasst, wie daraus die Topologie entsteht, was Sie einrichten müssen und wo die Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Erfassung von Ports, VLANs, Clients, LLDP-Nachbarn, PoE und Routen. Layer-2- und Layer-3-Karte, Route Trace, Port History, SSH-Terminal |
| Erfassung | Neun Hersteller: Allied Telesis, Arista, Aruba (CX, AOS-S), Cisco (IOS, IOS XE, Nexus), Extreme, Juniper, MikroTik, Ruijie, Sophos |
| Konfiguration | Drei Hersteller: Allied Telesis, Cisco, Ruijie. Siehe Automatisierung |
| Protokolle | SNMP v1 und v2c, SSH, optional Hersteller-API. Für MikroTik zusätzlich die RouterOS-REST-Schnittstelle |
| Richtung | Der COD-Server baut alle Verbindungen zu den Geräten auf. Auf den Geräten läuft kein Agent |
| Sammler | Läuft im COD-Backend auf dem COD-Server. Kein eigener Dienst, kein eigener Server |
| Zugangsdaten | SNMP-Community, SSH-Benutzer und Passwort, bei Bedarf Enable-Passwort, optional API-Benutzer und API-Passwort. COD speichert sie verschlüsselt |
| Freigaben | Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt. |
Voraussetzungen
Am Gerät
| Anforderung | Warum |
|---|---|
| SNMP v1 oder v2c mit Community, nur lesend. Die Port-MIB (IF-MIB) muss antworten | Port-Discovery und Portstatus. Scheitert die SNMP-Port-Discovery, gilt die ganze Abfrage als fehlgeschlagen |
| SSH-Server an, eigener Benutzer für COD, Paging abschaltbar | Abfrage von LLDP, Clients, VLANs und Routen über die CLI. Terminal |
| LLDP senden und empfangen auf allen Switch- und Router-Ports | Kanten der Layer-2-Karte entstehen nur aus LLDP |
| LLDP-TLVs system-name, system-description, system-capabilities, management-address, port-description | Ohne system-name ist das Gerät für seine Nachbarn namenlos |
| Hostname am Gerät gleich Asset-Name in COD | COD ordnet LLDP-Nachbarn über den Systemnamen einem Asset zu |
| Feste Management-Adresse, statisch oder per DHCP-Reservierung | Das Netzwerkobjekt hängt an der IP-Adresse |
| Gerätezugänge auf die Quelladresse des COD-Servers beschränkt | Alle Abfragen kommen vom COD-Server |
| Rechte des COD-Benutzers: lesend für die Erfassung | Die Mindestrechte erhalten Sie im Projekt. |
Hinweis: Bei SNMP v1 und v2c geht die Community unverschlüsselt über das Netz. Lassen Sie SNMP nur im Management-Netz zu und beschränken Sie den Zugriff per Zugriffsliste auf die Quelladresse des COD-Servers.
In COD
- Modul Network am Mandanten freigeschaltet, Rechte für den Standort vergeben.
- Asset mit Netzwerk-Kennzeichen, richtigem Hersteller und richtigem Modell mit Familie. Hersteller und Familie entscheiden, welcher Sammler läuft. Ein unbekannter Hersteller führt zu einem Fehler.
- Asset-Name höchstens 50 Zeichen, installationsweit eindeutig.
- Für die Layer-3-Karte: Schalter „Routing“ am Netzwerkobjekt.
- Für das Terminal: Modul Remote und ein Benutzername am Netzwerkobjekt.
- Ob statt Passwort auch SSH-Schlüssel möglich sind, klären Sie im Projekt.
Internetzugang
COD lädt einmal pro Woche die Liste der MAC-Hersteller aus dem Internet. Daraus erkennt das „Vendor Dashboard“ die Hersteller der Clients. Ein Proxy darf diesen Abruf nicht blockieren. Die Adresse erhalten Sie im Projekt.
Die vollständige Prüfliste für Ihre Geräte steht unter Netzgeräte vorbereiten. Wie Sie Geräte benennen, steht unter Namen und Adressen.
Einrichtung
- Legen Sie das Asset an oder importieren Sie es. Setzen Sie Hersteller, Familie und Modell aus dem Katalog.
- Schalten Sie am Asset das Netzwerk-Kennzeichen ein.
- Legen Sie das Netzwerkobjekt an: IP-Adresse, Zugangsdaten und die Abfragearten SNMP, SSH und bei Bedarf API.
- Schalten Sie „Routing“ ein, wenn das Gerät routet und in der Layer-3-Karte erscheinen soll.
- Prüfen Sie nach der ersten Abfrage den Status des Objekts. Steht dort „port discovery failed“, prüfen Sie zuerst SNMP.
- Prüfen Sie die Layer-2-Karte. Fehlt eine Kante, vergleichen Sie den LLDP-Systemnamen des Nachbarn mit dem Asset-Namen.
Formularfelder des Netzwerkobjekts
| Feld | Bedeutung |
|---|---|
| Asset | das zugehörige Asset |
| IP-Adresse | Management-Adresse des Geräts |
| SSH-Port | Port des SSH-Dienstes am Gerät |
| Benutzer, Passwort | SSH-Anmeldung |
| Enable-Passwort | nur nötig, wenn das Enable-Secret vom Anmeldepasswort abweicht, etwa bei Cisco |
| SNMP-Community | Community für SNMP v1 oder v2c |
| Schalter SNMP, SSH, API | welche Abfragearten COD für dieses Gerät nutzt |
| Schalter Routing | Routen und Adressen für die Layer-3-Karte erfassen |
| Update-Cron | eigener Zeitplan für die vollständige Abfrage dieses Geräts |
| API-Port, API-Benutzer, API-Passwort | Zugang zur Hersteller-API. Der API-Port hat keine Vorgabe |
| SSH-Host-Key, Key Exchange, Cipher | SSH-Algorithmen für ältere Geräte. Diese Felder setzt nur ein Administrator |
Hersteller-API
Für einzelne Hersteller nutzt der Sammler zusätzlich die API des Geräts. Beispiel Aruba CX: COD spricht die REST-Schnittstelle des Switches über HTTPS an, auf dem Port aus dem Feld API-Port. Tragen Sie dafür API-Port, API-Benutzer und API-Passwort ein und schalten Sie API ein.
MikroTik
Router mit RouterOS führen Sie im Modul MikroTik in einer eigenen Routerliste. Das Modul liefert die Router-Knoten der Layer-3-Karte.
| Merkmal | Wert |
|---|---|
| Zweck | Routen für die Layer-3-Karte, Live-Anzeigen, WinBox-Adresse, SSH-Terminal |
| Abgleich | über die REST-Schnittstelle des Routers. Für den MikroTik-Abgleich muss die REST-Schnittstelle des Routers für COD erreichbar sein. Einzelheiten erhalten Sie im Projekt. |
| Terminal | SSH vom COD-Server zum Router |
| Richtung | COD-Server zum Router |
| Rechte | eigener Benutzer für COD mit REST-Zugriff und kleinen Rechten. Die Mindestrechte erhalten Sie im Projekt. |
Router vorbereiten
- Machen Sie die REST-Schnittstelle des Routers für COD erreichbar und beschränken Sie den Zugang per Adressliste auf die Quelladresse des COD-Servers. Einzelheiten erhalten Sie im Projekt.
- Schalten Sie SSH ein und beschränken Sie es ebenso.
- Legen Sie einen eigenen Benutzer für COD an. Geben Sie ihm nur die Rechte, die der Abgleich braucht.
- Tragen Sie den Router in der Routerliste des Moduls MikroTik ein.
MikroTik in der Layer-2-Karte
Ein Router in der MikroTik-Liste ist nicht automatisch ein Netzwerkobjekt. Wie Sie MikroTik-Router in der Layer-2-Karte führen, klären Sie im Projekt.
Weitere Hinweise
- Bearbeiten Sie einen Router nur, wenn er erreichbar ist. Bearbeiten bei Router offline löscht die gespeicherten Routen.
- RouterOS hat keinen eigenen TACACS+-Client. Die Anmeldung am Router verwalten Sie mit den Mitteln von RouterOS.
- Richtwerte für viele Geräte nennt Ihr Partner.
Technische Details
Sammler und Abfragetakt
| Wert | Vorgabe |
|---|---|
| Portstatus per SNMP | alle 30 Sekunden |
| Vollständige Abfrage | nach Zeitplan („Update cron“ in der Backend-Konfiguration), je Gerät überschreibbar |
| Clients eines Switches | zusätzlich höchstens alle 5 Minuten |
| Abbruch einer Abfrage | nach 20 Minuten |
| Gleichzeitige Sitzungen (SNMP, SSH, API) | höchstens 5, einstellbar in „Backend config“, Bereich „Network“ |
| Zwischenspeicher der Topologie | 6 Stunden, Neuaufbau frühestens nach 5 Minuten |
| Port History | 90 Tage |
| Kapazität je Sammler | Richtwerte für viele Geräte nennt Ihr Partner. |
Hinweis: Speichern in „Backend config“ startet COD für alle Anwender neu. Bestätigen Sie die Änderung nicht, kehrt COD nach 120 Sekunden zur vorigen Einstellung zurück.
Topologie Layer 2
- Knoten sind die Netzwerkobjekte.
- Kanten entstehen aus den LLDP-Nachbarn der Switches und Router.
- COD ordnet einen Nachbarn über seinen LLDP-Systemnamen einem Asset zu. Der Vergleich ist exakt.
- Die Karte zeigt Geschwindigkeit und LACP-Status der Verbindungen.
- Geräte ohne LLDP zeichnen Sie von Hand in die Karte.
Topologie Layer 3
- Knoten sind routende Switches mit Schalter „Routing“, Router aus dem Modul MikroTik und Firewalls aus dem Modul Firewall.
- Route Trace folgt den Routen über diese Geräte hinweg.
- Erfasst werden IPv4-Routen der globalen Routingtabelle.
Clients
- COD liest je Switch die Clients mit MAC- und IP-Adresse.
- Das „Vendor Dashboard“ ordnet die Clients über die MAC-Herstellerliste einem Hersteller zu.
- Aus der Client-Liste starten Sie Ping und Port-Scan. Beide laufen vom COD-Server aus gegen die Client-Adresse.
Terminal und Weboberfläche
- Das Terminal ist eine SSH-Sitzung im Browserfenster. Den Aufbau zum Gerät macht der COD-Server mit den gespeicherten Zugangsdaten.
- Browser und COD sprechen dafür über WebSocket. Ein vorgeschalteter Reverse Proxy muss WebSocket und Server-Sent Events durchlassen. Eine Beispielkonfiguration erhalten Sie im Projekt.
- RDP und VNC bietet das Terminal nicht.
- „Open web UI“ öffnet nur einen Link im Browser des Anwenders. Der Browser muss das Gerät selbst erreichen.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Eine Kante in Layer 2 entsteht nur, wenn der LLDP-Systemname exakt einem Asset-Namen entspricht | Ein Name für jedes Gerät in allen Systemen. Siehe Namen und Adressen |
| Geräte ohne LLDP erscheinen nicht automatisch in der Karte | Zeichnen Sie sie von Hand. Ihre Verfügbarkeit überwachen Sie über Monitoring |
| Switches ohne Port-MIB bleiben bei „port discovery failed“ | Führen Sie solche Geräte als Asset ohne Netzwerkobjekt oder setzen Sie Geräte mit IF-MIB ein |
| Eine Abfrage gilt als fehlgeschlagen, wenn die SNMP-Port-Discovery scheitert, auch wenn SSH lief | Prüfen Sie zuerst Community, Zugriffsliste und Erreichbarkeit per SNMP vom COD-Server |
| SNMP nur in v1 und v2c | Nur lesende Community, Management-Netz, Zugriffsliste auf die Quelladresse des COD-Servers |
| Layer 3 nur mit IPv4 und nur mit der globalen Routingtabelle | Routen in VRFs und IPv6-Routen dokumentieren Sie gesondert |
| SSH-Algorithmen für ältere Geräte setzt nur ein Administrator | Ziehen Sie für solche Geräte einen Administrator hinzu |
| Änderungen an Adressen und Zugangsdaten übernimmt COD nicht von selbst | Ziehen Sie jede Änderung am Gerät in COD nach |
| Rechte gelten je Standort, nicht je Gerät | Teilen Sie Standorte so, wie Sie Rechte vergeben wollen |
| Bearbeiten eines MikroTik-Routers, der offline ist, löscht die gespeicherten Routen | Bearbeiten Sie Router nur, wenn sie erreichbar sind |
| Kein TACACS+ für MikroTik | Anmeldung am Router mit den Mitteln von RouterOS verwalten |
| MikroTik-Router in der Layer-2-Karte | Klären Sie das im Projekt. |
Weiterführend
- Modulseite Netzwerk
- Netzgeräte vorbereiten
- Namen und Adressen
- Was Ihr Netz für das Modul Netzwerk braucht
- Switches konfigurieren mit dem Modul Automatisierung
- Fehlerbilder
- Fragen zu den Modulen
- Handout „COD vorbereiten: Voraussetzungen“ als PDF auf der Seite Downloads
- Support: Zuerst hilft Ihr Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular.