Zeit und DNS
Diese Seite beschreibt Zeitabgleich, DNS, Zertifikate und den Internetzugang, die COD für einen sauberen Betrieb braucht.
Stand: November 2026, COD 3.8.6
Dokumentation
Zeit (NTP)
| Wo | Anforderung | Warum |
|---|---|---|
| COD-Server | Pflicht | Ohne Zeitabgleich steht der Audit-Status auf „degraded“. Zeitpläne und Einmalcodes (TOTP) hängen an der Uhrzeit |
| Datenbankserver | Pflicht | Audit-Status, zusammenpassende Zeitstempel |
| Modul-Server (NAC, Backup, Passkeepr, Ansible, TACACS+) | Pflicht | Audit-Status, Zeitstempel der Sicherungen, Zeitpläne |
| Netzgeräte | empfohlen | Vergleichbare Zeitstempel in Protokollen und Sicherungen |
Nutzen Sie für alle Server dieselbe Zeitquelle. Prüfen Sie den Zeitabgleich auf jedem Server:
timedatectl
Die Ausgabe zeigt „System clock synchronized: yes“.
DNS
COD arbeitet mit IP-Adressen. Netzwerkobjekte und Backup-Hosts brauchen keinen DNS-Namen. Hosts für Zabbix legt COD wahlweise mit IP-Adresse oder DNS-Namen an.
Der Name von COD selbst zählt aber:
| Wofür | Warum |
|---|---|
| HTTPS-Adresse im Browser | Die Anmeldung gilt für genau diese Adresse |
| Zertifikat | Das Zertifikat lautet auf den Namen |
| Anmelde-Token | Der Name steht als Aussteller im Token, die Module prüfen ihn |
| Module auf eigenen Servern | Sie erreichen COD unter diesem Namen |
| Anforderung | Warum | Prüfung |
|---|---|---|
| Namen von COD vor der Ersteinrichtung festlegen | Name, Zertifikat und Token hängen zusammen | Name löst auf die Adresse von COD auf |
| Forward- und Reverse-Einträge für COD-Server und Modul-Server (empfohlen) | Zertifikate, Lesbarkeit in Protokollen | Auflösung in beide Richtungen |
| Nach einem Wechsel der öffentlichen Adresse von COD den Ansible-Dienst neu ausrollen | Bis zum neuen Rollout schlägt der Ansible-Dienst fehl | Auftrag an den Ansible-Dienst läuft durch |
Zertifikate
HTTPS ist Pflicht für jeden Zugriff auf COD. Die Sitzungs-Cookies gehen nur über HTTPS. Ohne HTTPS gelingt keine Anmeldung. Ausnahmen sind der Einrichtungsassistent, der vor dem Einrichten von HTTPS läuft, und eine Anmeldung lokal auf dem COD-Server. Details unter Ersteinrichtung.
| Weg | Wann | Hinweis |
|---|---|---|
| Installationseigene CA | Sie haben keine eigene PKI oder wollen schnell starten | Der Einrichtungsassistent erzeugt die CA und das Zertifikat |
| Eigenes Zertifikat | Zertifikat aus Ihrer PKI | Eintragen unter „Backend config“, Karte „TLS“. Speichern startet COD für alle neu. Ohne Bestätigung fällt COD nach 120 Sekunden auf die alte Einstellung zurück |
| Reverse Proxy | Sie betreiben schon einen Proxy vor Ihren Webdiensten | Der Proxy muss WebSocket (Terminal) und Server-Sent Events (Passkeepr) durchlassen. COD muss dem Proxy vertrauen (Einstellung „trust proxy“). Eine Beispielkonfiguration erhalten Sie im Projekt. |
Weitere Zertifikate:
| Gegenstelle | Was Sie hinterlegen |
|---|---|
| Firewall mit Zertifikat Ihrer CA | CA-Zertifikat am Firewall-Asset in COD |
| Verzeichnisdienst über LDAPS | CA-Zertifikat in den LDAP-Einstellungen von COD |
Internetzugang
COD braucht Internet für Installation und Updates. Sonst braucht COD nur die Ziele aus dieser Tabelle. Ob die Oberfläche von außen erreichbar sein soll, entscheiden Sie.
| Ziel | Wofür | Wann | Pflicht |
|---|---|---|---|
Paketquelle von extocode (apt.extoco.de) | COD-Pakete | Installation und Update, auf allen Hosts | Pflicht |
| Ubuntu-Archive | Betriebssystem und Abhängigkeiten | Installation und Update | Pflicht |
| NodeSource | Node.js 24 | Installation und Update | Pflicht |
| Paketquelle von PostgreSQL | PostgreSQL ab 18, nur auf Ubuntu 22.04 und 24.04 | Installation und Update | Pflicht auf diesen Versionen |
| Liste der Hersteller zu MAC-Adressen | Hersteller der Clients im „Vendor Dashboard“ | einmal pro Woche | optional. Die Adresse erhalten Sie im Projekt. |
| Rückmeldung an extocode | Fehler und Wünsche aus dem Feedback-Modul | wenn ein Nutzer eine Meldung schickt | optional |
| Leck-Prüfung von Passwörtern | Passkeepr prüft aus dem Browser des Anwenders, ob ein Passwort in bekannten Lecks vorkommt. Dabei gehen nur die ersten fünf Zeichen des Hashwerts hinaus | wenn Passkeepr die Prüfung ausführt | optional |
Die Server erreichen die Paketquellen direkt oder über einen HTTP-Proxy. Ein Proxy darf die wöchentliche Hersteller-Liste nicht blockieren.
Für Umgebungen ohne Internet gibt es ein Offline-Bündel, das als lokale Paketquelle dient. Sie erhalten es auf Anfrage. Fragen Sie Ihren Partner, oder stellen Sie die Anfrage über das Helpdesk-Formular.