Netzgeräte vorbereiten
Diese Seite beschreibt, was Ihre Netzgeräte für COD können müssen und wie Sie es prüfen.
Stand: November 2026, COD 3.8.6
Dokumentation
Überblick
COD liest und steuert Netzgeräte über Standardprotokolle. Auf den Geräten installiert COD keine Agenten.
| Protokoll | Wofür | Richtung | Pflicht |
|---|---|---|---|
| LLDP | Nachbarn der Geräte, Kanten der Layer-2-Karte | zwischen den Geräten. COD liest die Nachbarn per SSH oder Hersteller-API aus | Pflicht für die Topologie |
| SNMP v1 oder v2c | Port-Discovery, Portstatus, Uptime | COD zum Gerät | Pflicht für das Netzwerk-Modul |
| SSH | Nachbarn, Clients, VLANs, Routen, Terminal, Sicherung, Konfiguration | COD, Backup-Dienst oder Ansible-Dienst zum Gerät | Pflicht |
| Hersteller-API | Erfassung über die Schnittstelle des Herstellers | COD zum Gerät | optional |
| RADIUS | Netzzugang mit NAC | Gerät zum NAC-Dienst | bei NAC |
| TACACS+ | Anmeldung von Administratoren am Gerät | Gerät zum TACACS+-Dienst | bei TACACS+ |
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Erfasst werden Geräte von neun Herstellern: Allied Telesis, Arista, Aruba, Cisco, Extreme, Juniper, MikroTik, Ruijie und Sophos. Konfigurieren lassen sich Allied Telesis, Cisco und Ruijie.
LLDP
| Anforderung | Warum | Prüfung |
|---|---|---|
| LLDP senden und empfangen auf allen Ports von Switches und Routern | Kanten der Layer-2-Karte entstehen nur aus LLDP | Nachbaransicht am Gerät zeigt die Nachbarn |
| TLV system-name | COD ordnet einen Nachbarn nur über seinen Systemnamen einem Asset zu. Ohne Systemnamen ist das Gerät für seine Nachbarn namenlos | Nachbaransicht des Nachbargeräts zeigt den Systemnamen |
| TLVs system-description, system-capabilities, management-address, port-description | vollständige Angaben zu Nachbar und Port | Nachbaransicht zeigt Beschreibung, Fähigkeiten, Adresse und Port |
| Systemname gleich Asset-Name in COD, Zeichen für Zeichen | sonst keine Kante | Systemname in der Nachbaransicht mit dem Asset-Namen vergleichen |
Geräte ohne LLDP, etwa Kameras, Speichersysteme oder Haustechnik, erscheinen nicht automatisch in der Topologie. Sie können diese Geräte von Hand einzeichnen. Ihre Verfügbarkeit überwachen Sie über die Zabbix-Anbindung.
Mehr zum Namen: Ein Name für alles
SNMP
COD fragt SNMP in den Versionen 1 und 2c mit Community ab.
| Anforderung | Warum | Prüfung |
|---|---|---|
| SNMP v1 oder v2c mit Community | Port-Discovery, Portstatus und Uptime | SNMP-Abfrage vom COD-Server aus |
| Community nur lesend | COD liest per SNMP nur | Community am Gerät ohne Schreibrecht |
| Zugriffsliste auf die Quelladresse von COD, dazu auf den Zabbix-Proxy, wenn Zabbix das Gerät per SNMP abfragt | Die Community wird ohne Verschlüsselung übertragen | Abfrage von einer anderen Adresse wird abgewiesen |
| SNMP nur im Management-Netz oder über VPN | Begrenzt, wer die Community mitlesen kann | Netzplan und Zugriffslisten |
| Die Port-MIB (IF-MIB) antwortet | Ohne sie scheitert die Port-Discovery | SNMP-Abfrage der IF-MIB vom COD-Server aus liefert die Ports |
Abfragetakt: COD fragt den Portstatus alle 30 Sekunden ab. Die vollständige Abfrage läuft nach Zeitplan, je Gerät einstellbar. Die Port-Historie reicht 90 Tage zurück.
| Grenze | Was Sie tun können |
|---|---|
| COD fragt SNMP in den Versionen 1 und 2c ab | Community nur lesend vergeben, auf die Quelladresse von COD beschränken, SNMP nur im Management-Netz oder über VPN zulassen |
| Scheitert die Port-Discovery per SNMP, gilt die ganze Abfrage als fehlgeschlagen, auch wenn SSH lief | SNMP und Zugriffsliste zuerst prüfen |
| Kleine Switches ohne Port-MIB bleiben im Status „port discovery failed“ | Diese Geräte als Asset führen und in der Topologie von Hand einzeichnen |
SSH
| Anforderung | Warum | Prüfung |
|---|---|---|
| SSH-Server am Gerät eingeschaltet | Nachbarn, Clients, VLANs, Routen, Terminal, Sicherung und Konfiguration laufen über SSH | Anmeldung vom COD-Server aus |
| Eigener Benutzer für COD, kein persönliches Konto | Nachvollziehbarkeit im Geräteprotokoll | Anmeldungen im Geräteprotokoll |
| Lesende Rechte für Erfassung und Sicherung, Konfigurationsrechte nur für die Automatisierung | Rechte so klein wie möglich. Die Mindestrechte erhalten Sie im Projekt. | Befehle der Erfassung mit dem Benutzer ausführen |
| SSH nur aus dem Management-Netz und von der Quelladresse von COD und der Modul-Server | Begrenzt die Angriffsfläche | Anmeldung von einer anderen Adresse wird abgewiesen |
| Seitenweise Ausgabe (Paging) abschaltbar | COD liest Befehlsausgaben am Stück | Lange Ausgabe ohne Unterbrechung |
| Anmeldung mit Benutzer und Passwort | Das Netzwerkobjekt speichert Benutzer und Passwort. Ob statt Passwort auch SSH-Schlüssel möglich sind, klären Sie im Projekt. | |
| Enable-Passwort nur, wenn das Enable-Secret vom Login-Passwort abweicht, etwa bei Cisco | Zugang zum privilegierten Modus |
Ältere Geräte: Am Netzwerkobjekt lassen sich SSH-Host-Key, Key Exchange und Cipher einstellen. Diese Einstellung nimmt ein Administrator in COD vor.
Sitzungsgrenze: Viele Geräte erlauben nur eine begrenzte Zahl gleichzeitiger SSH-Sitzungen. Der Sammler von COD öffnet ab Werk höchstens 5 Sitzungen gleichzeitig. Laufen viele Sicherungen über dasselbe Ziel, staffeln Sie die Startzeiten.
| Grenze | Was Sie tun können |
|---|---|
| Die Konfigurationssicherung setzt SSH oder SFTP am Gerät voraus | Geräte ohne SSH vorab mit Ihrem Partner klären |
Hersteller-API
Für einzelne Hersteller kann COD statt der CLI die Schnittstelle des Herstellers nutzen. Am Netzwerkobjekt tragen Sie dafür API-Port, API-Benutzer und API-Passwort ein und schalten „API“ ein. Ein Beispiel ist Aruba CX mit seiner REST-Schnittstelle über HTTPS.
RADIUS bei NAC
| Anforderung | Warum | Prüfung |
|---|---|---|
| Gerät kann 802.1X oder MAC-Authentifizierung | Grundlage von NAC | Datenblatt oder Konfiguration des Geräts |
| RADIUS-Quelladresse gleich Management-Adresse des Geräts | Sonst erscheinen keine NAC-Sitzungen am Port | NAC-Sitzungen erscheinen in COD am Switch-Port |
| Shared Secret in COD und am Gerät gleich | Sonst lehnt der RADIUS-Server ab | Testanmeldung an einem Port |
| Accounting senden | Verbindungsstatistik | Accounting-Einträge im NAC |
Mehr dazu: Modul NAC in der Doku
MikroTik
Router mit RouterOS führen Sie im MikroTik-Modul. Daraus kommen die Routen für die Layer-3-Karte, Live-Anzeigen und das Terminal.
| Anforderung | Warum | Prüfung |
|---|---|---|
| REST-Schnittstelle des Routers für COD erreichbar | Für den MikroTik-Abgleich muss die REST-Schnittstelle des Routers für COD erreichbar sein. Einzelheiten erhalten Sie im Projekt. | Abfrage aus COD liefert Routen und Interfaces |
| Zugang zur REST-Schnittstelle auf die Quelladresse von COD beschränkt | Nur COD soll sie erreichen | Zugriff von einer anderen Adresse wird abgewiesen |
| Eigener Benutzer mit kleinen Rechten | Nachvollziehbarkeit und kleine Angriffsfläche. Die Mindestrechte erhalten Sie im Projekt. | Anmeldungen im Router-Protokoll |
| SSH eingeschaltet | Terminal und Sicherung | Anmeldung vom COD-Server aus |
| Praxishinweis | Was Sie tun können |
|---|---|
| RouterOS lässt nur eine begrenzte Zahl gleichzeitiger SSH-Sitzungen zu, in der Praxis 20 | Startzeiten der Sicherungen staffeln |
| Für die Sicherung per Export sind in der Praxis volle Rechte am Router üblich | Eigenen Benutzer nur für die Sicherung anlegen |
| Router im MikroTik-Modul erscheinen nicht von selbst im Netzwerk-Inventar und damit nicht als Knoten der Layer-2-Karte | Wie Sie MikroTik-Router für die Layer-2-Karte führen, klären Sie im Projekt |
| RouterOS hat keinen eigenen TACACS+-Client | MikroTik-Router nicht über TACACS+ anbinden |
Firewalls
COD verwaltet Firewalls von AIMdefense, OPNsense, pfSense und DynFi. Plugin zur Selbstanmeldung und Captive Portal gibt es nur für OPNsense.
| Anforderung | Warum | Prüfung |
|---|---|---|
| Asset mit dem eingebauten Asset-Typ „Firewall“. Den Namen des Typs nicht ändern | COD erkennt Firewalls an diesem Typ | Typ am Asset |
| Asset aktiviert, Hersteller gesetzt | Zuordnung der richtigen Anbindung | Angaben am Asset |
| API-Benutzer mit API-Key und API-Secret. Ab Werk ein Administrator. Ohne Administratorrechte braucht die Layer-3-Karte bei Clustern mindestens die Rechte „Interfaces: Virtual IPs: Status“ und „System: High Availability“ | Firmware, Zustand, VPN, Aliase, Zonen. Die Mindestrechte erhalten Sie im Projekt. | Abfrage aus COD liefert den Zustand |
| SSH-Benutzer an der Firewall | Regeln lesen und Terminal | Anmeldung vom COD-Server aus |
| Eigene CA der Firewall in COD hinterlegt, wenn die Firewall ein Zertifikat Ihrer CA nutzt | Prüfung der Gegenstelle | Abfrage ohne Zertifikatsfehler |
| Erreichbarkeit per ICMP und Verbindungsaufbau zur API | COD prüft die Erreichbarkeit regelmäßig | Status in COD |
| Nur mit Plugin: Die Firewall erreicht die Adresse von COD | Die Firewall meldet sich einmalig selbst bei COD an | Firewall erscheint in COD zur Freigabe |
Mehr dazu: Modul Firewall in der Doku
Access Points
| Anforderung | Warum | Prüfung |
|---|---|---|
| Name des Access Points im Controller gleich Asset-Name | Dann zeichnet COD die Kante zwischen Access Point und Switch | Kante in der Layer-2-Karte |
| LLDP am Access Point und am Switch-Port | Der Switch lernt den Access Point als Nachbarn | Nachbaransicht des Switches |
Herstellerhinweise
Die allgemeinen Anforderungen dieser Seite gelten für alle neun Hersteller. Die Mindestrechte erhalten Sie im Projekt.
| Hersteller | Praxishinweis |
|---|---|
| Allied Telesis | Die optionalen LLDP-TLVs werden je Port ausgewählt (lldp tlv-select). Konfiguration über die Automatisierung möglich |
| Aruba | Aruba CX lässt sich optional über die REST-Schnittstelle über HTTPS erfassen |
| Cisco | Enable-Passwort nur eintragen, wenn das Enable-Secret vom Login-Passwort abweicht. Konfiguration über die Automatisierung möglich |
| MikroTik | Siehe Abschnitt MikroTik |
| Ruijie | Konfiguration über die Automatisierung möglich |
| Arista, Extreme, Juniper, Sophos | Keine geprüften Hinweise über die allgemeinen Anforderungen hinaus |
In COD am Asset
| Anforderung | Warum |
|---|---|
| Netzwerk-Kennzeichen am Asset gesetzt | Nur dann gehört das Gerät zum Netzwerk-Modul |
| Hersteller und Modellfamilie richtig gepflegt | Sie bestimmen, welcher Sammler läuft. Ein unbekannter Hersteller führt zu einem Fehler |
| „Routing“ am Netzwerkobjekt eingeschaltet, wenn das Gerät routet | Nötig für Layer 3 sowie Adressen und VLANs |