Inventar und CMDB-Import
Diese Seite beschreibt, wie das Asset-Inventar aufgebaut ist, wie Assets nach COD kommen und welche Regeln für Namen und Kataloge gelten.
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
Mandanten, Standorte und Rechte beschreibt die Seite Plattform. Was COD mit i-doit und Odoo austauscht, steht unter Integrationen.
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Das Inventar ist das Rückgrat von COD. Network, Firewall, Monitoring, GRC und weitere Module arbeiten mit denselben Assets |
| Kataloge | Typ, Hersteller, Familie, Modell, Status, Zustand. Sie gelten installationsweit |
| Asset-Namen | Installationsweit eindeutig, höchstens 50 Zeichen |
| Flags am Asset | Netzwerk, Backup, NAC, Firewall |
| Standortbezug | Jedes Asset gehört zu einem Standort. Der Standort ist die kleinste Grenze für Rechte und Daten |
| Import | CSV-Import und i-doit-Import |
| i-doit | JSON-RPC über HTTPS, API-Schlüssel Pflicht, nur lesend |
| Verbindung und Richtung | COD baut die Verbindung zu i-doit und optional zu Odoo auf |
| Ticketsystem | Optional Odoo, über JSON-RPC per HTTPS |
Voraussetzungen
| Voraussetzung | Warum |
|---|---|
| Namensschema festgelegt | Asset-Name, Hostname, LLDP-Systemname und Zabbix-Hostname sollen gleich sein. COD verknüpft über exakte Namen. Siehe Namen und Adressen |
| Kataloge vollständig, Hersteller und Familie richtig | Hersteller und Familie entscheiden, welcher Sammler ein Gerät abfragt |
| Eingebauter Asset-Typ „Firewall“ unverändert | Das Firewall-Modul erkennt Firewalls an diesem Typ. Benennen Sie ihn nicht um |
| Rolle mit Recht auf das Modul Asset, für Importe mit dem Recht „CSV-Import“ | Ohne Recht kein Anlegen und kein Import |
| Für i-doit: API in i-doit eingeschaltet, API-Schlüssel, Erreichbarkeit per HTTPS vom COD-Server | COD liest über die API von i-doit |
| Für Odoo: erreichbares Odoo mit Ticketsystem | Tickets je Standort |
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Einrichtung
- Legen Sie die Kataloge an: Typ, Hersteller, Familie, Modell, Status, Zustand. Sie gelten für alle Mandanten der Installation.
- Legen Sie das Namensschema fest. Bewährt hat sich ein Schema aus Kunde, Standort, Gerätetyp und laufender Nummer.
- Wählen Sie in der Kopfzeile den Standort.
- Legen Sie Assets an: von Hand, per CSV-Import oder per i-doit-Import.
- Setzen Sie die Flags am Asset. Für die Erfassung im Netzwerk-Modul ist das Netzwerk-Flag Pflicht.
- Für i-doit: Tragen Sie in der CMDB-Konfiguration des Standorts Adresse und API-Schlüssel ein, bei Bedarf Benutzer und Passwort. Wählen Sie die Objekte und starten Sie den Import.
- Pflegen Sie Räume, Racks und Layer-1-Kabel. Dafür brauchen Sie GRC-Rechte.
- Optional: Richten Sie die Ticket-Anbindung an Odoo je Standort ein.
Technische Details
Kataloge
| Katalog | Gilt | Hinweis |
|---|---|---|
| Typ | installationsweit | Enthält den eingebauten Typ „Firewall“ |
| Hersteller | installationsweit | Muss zum Gerät passen. Ein unbekannter Hersteller führt bei der Erfassung zu einem Fehler |
| Familie | installationsweit | Wählt zusammen mit dem Hersteller den Sammler |
| Modell | installationsweit | |
| Status, Zustand | installationsweit |
Asset-Namen
- Höchstens 50 Zeichen.
- Installationsweit eindeutig, also auch über Mandanten und Standorte hinweg.
- Layer-2-Kanten, Zabbix-Abgleich und die Namensprüfung im Backup vergleichen ganze Namen. Ein abweichendes Zeichen genügt, damit keine Verknüpfung entsteht.
Flags am Asset
| Flag | Bedeutung |
|---|---|
| Netzwerk | Pflicht für die Erfassung im Netzwerk-Modul |
| Backup | Kennzeichnet das Asset für das Modul Backup |
| NAC | Kennzeichnet das Asset für das Modul NAC |
| Firewall | Kennzeichnet das Asset für das Firewall-Modul. Das Modul braucht außerdem den eingebauten Typ „Firewall“ und einen gesetzten Hersteller |
Hersteller, Familie und Sammler
Der Sammler von COD fragt Netzgeräte per SNMP, SSH oder Hersteller-API ab. Welcher Sammler läuft, entscheiden Hersteller und Familie am Asset. Ein unbekannter Hersteller ergibt einen Fehler. Welche Hersteller COD erfasst, steht unter Netzwerk und MikroTik.
CSV-Import
Den CSV-Import gibt es für Asset, Network, Backup und NAC. Er ist ein eigenes Recht in der Rolle.
i-doit-Import
| Merkmal | Wert |
|---|---|
| Schnittstelle | JSON-RPC von i-doit über HTTPS |
| Zugang | API-Schlüssel Pflicht, Benutzer und Passwort optional |
| Konfiguration | Je Standort |
| Richtung | COD liest aus i-doit. COD schreibt nichts zurück |
i-doit bleibt Ihre CMDB. COD liest nur und schreibt nichts zurück.
Asset-Seite
Jedes Asset hat eine eigene Seite mit Monitoring, Platzierung, Schnittstellen, Kontakten, Verträgen und Abhängigkeiten. Mit GRC-Recht zeigt sie zusätzlich Risiko und den Prozess, der über die Asset-Gruppe am Asset hängt.
Räume, Racks und Layer-1
Räume und Racks pflegen Sie per Ziehen und Ablegen. Layer-1-Kabel dokumentieren die Verkabelung. Alle drei brauchen GRC-Rechte.
Verschieben
Assets lassen sich zwischen Standorten verschieben. Über eine Mandantengrenze darf nur ein SuperAdmin verschieben. Ein zugeordneter OTP-Token zieht mit.
Kopien in den Modulen
Einige Module führen eigene Datensätze, die beim Anlegen aus dem Asset gefüllt werden und danach getrennt sind.
| Modul | Verhalten |
|---|---|
| Backup | Der Hosteintrag ist eine Kopie. Adresse und Passwort ändern sich dort nicht von selbst |
| NAC | Die Liste der NAS-Geräte ist nicht mit dem Asset verknüpft |
| Hypervisor | Keine Verbindung zum Asset |
Ticketsystem Odoo
COD sucht Tickets je Standort in Odoo und verknüpft sie mit GRC-Vorgang und Quittierung. Tickets legen Sie direkt aus COD an, mit vorbelegten Feldern. Andere Ticketsysteme sind nicht angebunden.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Asset-Namen installationsweit eindeutig, höchstens 50 Zeichen | Nehmen Sie Kunde und Standort in das Namensschema auf |
| Kataloge gelten installationsweit | Stimmen Sie Kataloge zwischen den Mandanten einer Installation ab |
| Falscher oder unbekannter Hersteller führt zu Fehlern bei der Erfassung | Prüfen Sie Hersteller und Familie vor dem ersten Abruf |
| Keine Rechte je Gerät | Trennen Sie Geräte über den Standort |
| i-doit-Import nur lesend, keine Rückschreibung | Pflegen Sie die CMDB weiter in i-doit |
| Module wie Backup und NAC führen eigene Kopien | Ändern Sie Adresse und Zugangsdaten auch dort |
| Räume, Racks und Layer-1 nur mit GRC-Recht | Geben Sie den Rollen, die das Inventar pflegen, das GRC-Recht |
| Nur Odoo als Ticketsystem | Andere Ticketsysteme bleiben außerhalb von COD |
| Änderungen an Adressen und Zugangsdaten am Gerät kommen nicht von selbst in COD an | Vergeben Sie feste Management-Adressen und pflegen Sie Änderungen in COD nach |
Weiterführend
- Plattform: Mandanten, Standorte, Rechte
- Integrationen
- Namen und Adressen
- Netzwerk und MikroTik
- GRC in der Doku
- Was Ihr Netz für Inventar und Anbindungen braucht
- Fehlerbilder
- Fragen zu den Modulen