Voraussetzungen
Diese Seite fasst zusammen, was Server und Netz für COD brauchen. Die Checkliste hilft der IT-Leitung, das Projekt vorzubereiten.
Stand: November 2026, COD 3.8.6
Dokumentation
Überblick
| Bereich | Gilt für | Details |
|---|---|---|
| Server und Datenbanken | Self Hosted | Server auf dieser Seite |
| Namen und Adressen | alle Betriebsarten | Namen und Adressen |
| Netzgeräte: LLDP, SNMP, SSH, RADIUS | alle Betriebsarten | Netzgeräte |
| Zeit, DNS, Zertifikate, Internetzugang | Zeit und DNS für alle, Server-Themen für Self Hosted | Zeit und DNS |
| Verbindungen und Freigaben | alle Betriebsarten | Verbindungen und Freigaben auf dieser Seite |
Checkliste „Bereit für COD“
Gehen Sie die Liste mit Ihrem Team durch. Tragen Sie ein, wer zuständig ist. Offene Punkte klären Sie mit Ihrem Partner vor dem Installationstermin.
| Punkt | Warum | Zuständig |
|---|---|---|
| Betriebsart gewählt: Self Hosted, Shared Hosted oder Private Hosted | bestimmt, was Sie selbst stellen | IT-Leitung |
| Bei Self Hosted: Server mit Ubuntu Server 22.04, 24.04 oder 26.04 LTS (amd64), frisch installiert, Zugang mit root oder sudo | Installation und Updates laufen über apt | Server |
| Bei Self Hosted: Zugangsdaten zum Paket-Repository liegen vor | ohne Zugangsdaten keine Pakete | IT-Leitung |
| Bei Self Hosted: Zugang zur Paketquelle direkt oder über einen Proxy | Installation und Updates | Server, Firewall |
| Weg zum HTTPS-Zertifikat entschieden: installationseigene CA, eigenes Zertifikat oder Reverse Proxy | COD arbeitet nur über HTTPS | Server |
| Zeitabgleich (NTP) auf COD-Server, Datenbankservern und Modul-Servern, auf Netzgeräten empfohlen | sonst Audit-Status „degraded“ und Zeitstempel, die nicht zusammenpassen | Server, Netz |
| Namensschema festgelegt, ein Name je Gerät in allen Systemen | COD verknüpft Topologie, Monitoring und Sicherung über den Namen | Netz |
| Management-Adressen fest vergeben, statisch oder per DHCP-Reservierung | Netzwerkobjekt, Sicherung und Monitoring hängen an der Adresse | Netz |
| DNS vorwärts und rückwärts für COD-Server und Modul-Server (empfohlen) | Zertifikat und Lesbarkeit | Server |
| LLDP auf Switches und Routern an, mit Systemname und Management-Adresse | Grundlage der Netzkarte | Netz |
| SNMP v1 oder v2c auf den Netzgeräten, nur lesend, mit Zugriffsliste auf die COD-Quelladresse | Ports und Portstatus | Netz |
| SSH mit eigenem Benutzer für COD auf Geräten, die ausgelesen oder gesichert werden | Nachbarn, Clients, Sicherung | Netz |
| Weg vom COD-Server zu jedem Standort, etwa über VPN, mit fester Quelladresse | alle Abfragen kommen von dort | Netz, Firewall |
| Freigaben aus der Liste „Verbindungen und Freigaben“ eingerichtet | ohne Freigabe keine Abfrage | Firewall |
| Für Monitoring: eigene Zabbix-Instanz, API-Token mit Schreibrecht auf die eigenen Server-Gruppen | COD liest aus Ihrem Zabbix und legt dort Hosts an | Monitoring |
| Für NAC: Switches senden RADIUS von ihrer Management-Adresse | sonst keine NAC-Sitzungen am Port | Netz |
| An Fernstandorten zwei unabhängige Zugangswege | eine Änderung darf den Zugang nicht kosten | Netz |
Hinweis: Geräte ohne LLDP, etwa Kameras oder Haustechnik, erscheinen nicht automatisch in der Netzkarte. Sie lassen sich von Hand einzeichnen. Geräte ohne SSH lassen sich nicht direkt sichern. Klären Sie solche Geräte vorab mit Ihrem Partner.
Server (Self Hosted)
Bei Shared Hosted und Private Hosted stellt extocode den COD-Server. Dieser Abschnitt gilt dann nur für Komponenten, die Sie selbst betreiben.
| Punkt | Anforderung |
|---|---|
| Betriebssystem | Ubuntu Server 22.04 LTS, 24.04 LTS oder 26.04 LTS, frisch installiert. |
| Architektur | amd64 |
| Rechte | root oder sudo |
| Auslieferung | Debian-Pakete über apt, etwa das Gesamtpaket cod-all. Kein Container |
| Repository | Zugangsdaten von extocode für apt.extoco.de. Die Repository-Zugangsdaten erhalten Sie im Projekt. |
| Internet bei Installation und Update | Paketquelle von extocode, Ubuntu-Archive, NodeSource und auf 22.04 und 24.04 die Paketquelle von PostgreSQL. Direkt oder über einen HTTP-Proxy. Details unter Internetzugang |
| Laufzeit | Node.js 24. Das installiert das Einrichtungsskript |
| Datenbanken | MariaDB und PostgreSQL ab Version 18. Lokal mitinstalliert oder auf vorhandenen Datenbankservern. Eine ältere PostgreSQL-Version weist die Installation ab |
| Cache | Redis, auf Ubuntu 26.04 Valkey. Läuft immer auf dem COD-Server |
| HTTPS | Pflicht für jeden Zugriff. Siehe Zertifikate |
| Zeit | NTP auf COD-Server, Datenbankservern und Modul-Servern. Siehe Zeit |
| Hardware | Richtwerte für Ihre Größe nennt Ihr Partner. |
| Firewall auf dem Server | Die Pakete richten keine Firewall-Regeln ein. Die Regeln legen Sie selbst fest |
Für die Arbeitsplätze:
| Punkt | Anforderung |
|---|---|
| Browser | Zugriff auf COD nur über HTTPS |
| Passkeepr-Erweiterung | Chrome ab Version 137 oder Firefox ab Version 140. Ab COD 3.8.6 Erweiterung mindestens in Version 3.3.6 |
| Sprache der Oberfläche | Englisch |
Wie Sie Dienste auf einen oder mehrere Server verteilen, steht unter Aufbauformen.
Verbindungen und Freigaben
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Diese Grundsätze gelten für die Richtung der Verbindungen:
| Von | Nach | Wofür |
|---|---|---|
| Browser der Anwender | COD | Oberfläche über HTTPS. Davor kann ein Reverse Proxy stehen |
| COD | Netzgeräte, Firewalls, Zabbix, vCenter, Verzeichnisdienst, Mailserver | COD baut die Verbindung auf und fragt ab oder steuert |
| Backup-Dienst | gesicherte Geräte | SSH oder SFTP, auf Wunsch über einen Jump-Host |
| Ansible-Dienst | Switches | SSH für die Konfiguration |
| Netzgeräte | NAC-Dienst | RADIUS |
| Netzgeräte | TACACS+-Dienst | TACACS+ |
| Browser der Anwender | Weboberfläche eines Geräts | nur „Open web UI“. Der Browser muss das Gerät dann selbst erreichen |
Laufen Module auf eigenen Servern, gilt: Die Verbindung zwischen COD und Modul-Servern gehört in ein vertrauenswürdiges Netz.
Alle Zugänge an den Geräten beschränken Sie auf die Quelladresse von COD und der Modul-Server. Mehr dazu unter Namen und Adressen.
Was Ihr Netz je Modul braucht
Netzwerk und MikroTik
- COD fragt Switches und Router per SNMP v1 oder v2c, SSH und optional Hersteller-API ab.
- LLDP mit Systemname, Systemname gleich Asset-Name.
- MikroTik-Router liest COD über die REST-Schnittstelle von RouterOS und per SSH.
- Details: Netzgeräte
Automatisierung
- Der Ansible-Dienst konfiguriert Switches von Allied Telesis, Cisco und Ruijie per SSH.
- Der Benutzer braucht Konfigurationsrechte am Gerät. Die Mindestrechte erhalten Sie im Projekt.
- Die Erfassung im Netzwerk-Modul muss vorher gelaufen sein.
NAC
- Switches und Access Points sprechen RADIUS mit dem NAC-Dienst. Der NAC-Dienst sendet Change-of-Authorization und Disconnect an die Geräte.
- Geräte können 802.1X oder MAC-Authentifizierung und senden RADIUS von ihrer Management-Adresse.
- Shared Secret je Gerät, in COD und am Gerät gleich.
TACACS+
- Netzgeräte sprechen TACACS+ mit dem TACACS+-Dienst.
- Am Gerät: TACACS+-Client mit Server-Adresse und Shared Secret, Accounting eingeschaltet.
- RouterOS hat keinen eigenen TACACS+-Client. MikroTik-Router binden Sie deshalb nicht über TACACS+ an.
Firewall und Captive Portal
- COD spricht die Firewall über ihre HTTPS-API und per SSH an. Die Erreichbarkeit prüft COD per ICMP und Verbindungsaufbau zur API.
- Unterstützt: AIMdefense, OPNsense, pfSense und DynFi. Plugin zur Selbstanmeldung und Captive Portal nur für OPNsense.
- Mit dem Plugin meldet sich die Firewall einmalig selbst bei COD an. Sie muss die Adresse von COD dafür erreichen.
- Details: Firewalls
Monitoring
- COD spricht die API Ihres Zabbix-Frontends an. Zabbix fragt die Geräte selbst ab, bewährt hat sich ein Zabbix-Proxy je Standort.
- API-Token mit Schreibrecht auf die eigenen Server-Gruppen.
- Asset-Name gleich Zabbix-Hostname.
Backup
- Der Backup-Dienst baut SSH oder SFTP zum Gerät auf, auf Wunsch über einen Jump-Host. Geräte ohne SSH lassen sich nicht direkt sichern.
- Für Datenbank-Sicherungen verbindet sich der Backup-Dienst mit dem MariaDB-Server.
- Für Fehlermails braucht die Backup-Instanz einen Mailserver.
Hypervisor
- Der Hypervisor-Dienst auf dem COD-Server spricht vCenter oder ESXi über HTTPS an.
- Zugangsdaten je Verbindung und Standort. Die Mindestrechte erhalten Sie im Projekt.
Passkeepr
- Die Browser-Erweiterung spricht COD über HTTPS. Passkeepr bleibt nach Möglichkeit auf dem COD-Server.
- Optional prüft der Browser Passwörter gegen eine öffentliche Leck-Datenbank. Details unter Internetzugang.
Inventar und weitere Anbindungen
- i-doit: COD liest über die API von i-doit, nur lesend, mit API-Schlüssel.
- Verzeichnisdienst: COD spricht den Domain Controller per LDAPS an, LDAP ist möglich.
- Mail je Standort: COD versendet über Ihren Mailserver.
- Audit: COD sendet das Audit-Protokoll per Syslog über TLS an Ihr SIEM.
- OTP und GRC haben keine eigenen Anforderungen an das Netz.
Handout
Den Inhalt dieser Seite und der drei Unterseiten gibt es als Handout „COD vorbereiten: Voraussetzungen“. Handout als PDF auf der Seite Downloads