Sicherheit
Diese Seite beschreibt die Sicherheitsfunktionen von COD und was Sie im Betrieb dafür tun. Sie nennt nur, was für COD 3.8.6 belegt ist.
Stand: November 2026, COD 3.8.6
Dokumentation
Zugriff und Rollen
| Merkmal | Wert |
|---|---|
| Rolle | Gehört zu einem Mandanten. Die Rechte gelten je Modul und je Standort |
| Rechte | Fünf einzeln vergebbare Rechte: Anlegen, Lesen, Ändern, Löschen und CSV-Import. Frei kombinierbar |
| CSV-Import | Nur für Asset, Network, Backup und NAC |
| Ohne Leserecht | Der Menüpunkt des Moduls erscheint für diesen Anwender nicht |
| Kleinste Grenze | Der Standort ist die kleinste Grenze für Rechte und Daten. Rechte je Gerät gibt es nicht. Wer Geräte abgrenzen will, trennt sie über den Standort |
| Installationsweit | Branding, Asset-Kataloge und Asset-Namen gelten für die ganze Installation |
| Prüfung | Jeder Aufruf an ein Modul geht über COD. COD prüft die Modulrechte bei jeder Anfrage. Die Module prüfen das signierte Anmelde-Token zusätzlich selbst |
| Verzeichnisgruppe | Jede Rolle kann eine Gruppe aus Active Directory oder LDAP tragen |
| Abgleich mit dem Verzeichnis | Der zeitgesteuerte Abgleich sperrt Konten, die nicht mehr in der Zugriffsgruppe stehen. Er legt keine Konten an und entsperrt keine |
| Sperren | Konten werden mit Begründung gesperrt. Die Spur bleibt erhalten |
| Manager-Konto | Nur das Manager-Konto schaltet Module am Mandanten frei. Das Branding ändert nur die Manager-Rolle |
Die Rechte im Überblick zeigt auch die Seite Mandanten, Standorte und Rollen.
Anmeldung
| Merkmal | Wert |
|---|---|
| Konten | Lokale Konten oder Anmeldung über Active Directory bzw. LDAP |
| Verzeichnisdienst | LDAPS ist ab Werk eingeschaltet. Die Zertifizierungsstelle Ihres Verzeichnisdienstes hinterlegen Sie in COD |
| Ausfall des Verzeichnisdienstes | Behalten Sie einen lokalen Zugang, etwa das Manager-Konto. |
| Zweiter Faktor | TOTP mit Wiederherstellungscodes. Eine Rolle kann den zweiten Faktor verlangen. Ein Administrator kann den Faktor eines Kontos zurücksetzen |
| Modul OTP | Speichert Einmalcodes für fremde Systeme. Es ist vom zweiten Faktor der COD-Anmeldung getrennt |
| Lokale Konten | Ein neuer Benutzer ohne Passwort bekommt eine Einladung. Der Link zum Setzen des Passworts gilt einmal. COD schreibt dem Konto, wenn sich Passwort oder Mailadresse ändern |
| Manager-Konto | Eingebautes Notfall- und Verwaltungskonto mit TOTP. Der Einrichtungsassistent legt es an und zeigt den QR-Code für TOTP genau einmal. Die Mailadresse des Manager-Kontos lässt sich später nicht ändern |
| Sitzung | Gilt bis zu sieben Tage |
| Transport | HTTPS ist im Betrieb Pflicht. Ohne HTTPS ist eine Anmeldung nur lokal auf dem COD-Server möglich. Die Sitzungs-Cookies sind als sicher gekennzeichnet und gehen nur über HTTPS |
| Passkeepr | Der Web-Tresor sperrt sich nach einer Stunde ohne Aktivität. Jede Person kann eine kürzere Zeit wählen. Die Zeit des Administrators unter „Auto-lock when idle“ ist die Obergrenze |
Empfehlung: Bewahren Sie den TOTP-Zugang des Manager-Kontos getrennt vom Server und getrennt von den persönlichen Konten auf. Das Manager-Konto ist Ihr Notfallzugang.
Verschlüsselung
| Bereich | Verfahren |
|---|---|
| Browser zu COD | HTTPS. Zertifikat aus der installationseigenen Zertifizierungsstelle des Einrichtungsassistenten, eigenes Zertifikat oder ein vorgeschalteter Reverse Proxy |
| Gespeicherte Zugangsdaten zu Geräten und Systemen | Verschlüsselt in der Datenbank. Die Schlüssel gehören zur Installation |
| Switch-Konfiguration (Ansible) | Zugangsdaten verschlüsselt im Vault des Ansible-Dienstes |
| Konfigurationssicherungen (Backup) | Optional verschlüsselt, einschaltbar je Host oder Vorlage. Gilt für lokal abgelegte Sicherungen. Ordner-Sicherungen sind ausgenommen |
| Passkeepr | Ende-zu-Ende verschlüsselt. Der Server speichert nur Chiffrat. Argon2id für die Schlüsselableitung, X25519 für die Schlüssel, AES-GCM für die Einträge |
| TACACS+ | Passwörter als Argon2id-Hash, nicht umkehrbar. Sensible Felder mit AES-256-GCM |
| Audit an Ihr SIEM | Syslog über TLS mit Zertifikaten auf beiden Seiten |
Passkeepr kennt eine gewollte Ausnahme: Enterprise-Tresore gehören der Organisation. Auch das Organisationskonto kann sie öffnen. Dessen Entsperren und Änderungen werden protokolliert.
Hinweis: Ohne die Schlüssel der Installation lassen sich verschlüsselte Zugangsdaten nicht wiederherstellen. Nehmen Sie diese Schlüssel in die Sicherung des COD-Servers auf. Die vollständige Liste erhalten Sie im Projekt.
Audit und Protokolle
| Protokoll | Inhalt | Schutz |
|---|---|---|
| GRC, Verlauf je Objekt | Jede Änderung an Assets, Controls, Richtlinien und Risikobewertungen: wer, wann, was, wo, warum. Feldgenauer Vergleich, Nachvollzug von Sammeländerungen über eine Korrelations-ID | Wird nur fortgeschrieben. Datenbank-Trigger verhindern nachträgliches Ändern und Löschen. Eigene PostgreSQL-Datenbank. Seit 3.7.8 versiegelt COD neue Einträge jede Nacht in einem signierten Prüfpunkt |
| „Admin Area > Audit“ (seit 3.7.8) | Änderungen und Zugriffe über die Module, Anmeldungen und Exporte. Bericht für die jährliche Rechteprüfung | Die Datenbank lässt keine Änderung der Einträge zu. COD versiegelt neue Einträge jede Nacht mit einer Signatur |
Der signierte Prüfpunkt macht eine nachträgliche Änderung sichtbar. Unmöglich macht er sie nicht.
Passkeepr zeigt unter „History“ frühere Stände jedes Eintrags, wer ihn gespeichert hat und was sich unterscheidet (seit 3.8.6). Die Betriebsprotokolle von COD und der Dienste NAC, Backup, Passkeepr und TACACS+ stehen unter „Admin Area > Log“. Den Dienst wählen Sie über „Service“.
| Thema | Regel |
|---|---|
| Weiterleitung | Auf Wunsch geht das Audit-Protokoll per Syslog über TLS nach RFC 5424 an Ihr SIEM oder zentrales Log-System. COD baut die Verbindung auf |
| Zeit | NTP auf dem COD-Server, den Datenbankservern und den Modul-Servern. Ohne Zeitabgleich steht der Audit-Status auf „degraded“ |
Mehr zur Zeit: Zeit und DNS.
Netz und Betrieb
- COD installiert keine Agenten auf Netzgeräten. Es liest und steuert über SNMP, SSH und Hersteller-APIs. COD baut die Verbindung zum Gerät auf.
- Beschränken Sie die Gerätezugänge für SNMP, SSH und API auf die Quelladresse des COD-Servers und der Modul-Server.
- Verwalten Sie Geräte aus einem eigenen Management-Netz.
- Die Verbindung zwischen COD und Modul-Servern gehört in ein vertrauenswürdiges Netz. Passkeepr gehört nach Möglichkeit auf den COD-Server.
- Der Hypervisor-Dienst ist nur lokal auf dem COD-Server erreichbar. Der Ansible-Dienst lauscht ab Werk nur lokal.
- Ob die Oberfläche von außen erreichbar sein soll, entscheiden Sie.
- Die Pakete richten keine Firewall-Regeln auf dem Server ein. Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
- Empfohlen: je Gerät und System ein eigener Dienstbenutzer für COD, kein persönliches Konto. Rechte so klein wie möglich. Die Mindestrechte erhalten Sie im Projekt. Ob statt Passwort auch SSH-Schlüssel möglich sind, klären Sie im Projekt.
Grenzen
| Grenze | Was Sie tun können |
|---|---|
| SNMP nur in v1 und v2c mit Community. Die Community geht im Klartext | Community nur lesend vergeben. SNMP nur aus dem Management-Netz und nur von der Quelladresse des COD-Servers zulassen |
| Konfigurationssicherung setzt SSH voraus | SSH am Gerät einschalten und auf die Quelladresse des Backup-Hosts beschränken |
Einzelheiten je Gerät: Netzgeräte vorbereiten.
Welche Daten die Installation verlassen
Die Tabelle gilt für Self Hosted. Bei Shared Hosted und Private Hosted betreibt extocode die Instanz.
| Verbindung | Wann | Was übertragen wird | Von |
|---|---|---|---|
Paketquellen: apt.extoco.de sowie die Paketquellen von Ubuntu, Node.js und auf 22.04 und 24.04 PostgreSQL | Installation und Update | Abruf der Pakete, direkt oder über einen HTTP-Proxy | Alle COD-Server |
| Hersteller-Namensliste für MAC-Adressen | Einmal pro Woche | Abruf der Liste. Die Adresse erhalten Sie im Projekt. | COD-Server |
| Rückmeldung an extocode | Nur wenn ein Nutzer eine Meldung abschickt | Inhalt der Meldung, an den Issue-Tracker des Herstellers oder per Mail | COD-Server |
| Leck-Prüfung in Passkeepr | Wenn Passkeepr ein Passwort prüft | Die ersten fünf Zeichen des Hashs eines Passworts, nie das Passwort. Ziel ist der öffentliche Dienst Pwned Passwords | Browser des Anwenders |
Darüber hinaus braucht COD kein Internet. Verbindungen zu Ihren eigenen Systemen wie Verzeichnisdienst, Zabbix, Mailserver oder SIEM richten Sie selbst ein. Für abgeschottete Umgebungen gibt es auf Anfrage ein Offline-Bündel als lokale Paketquelle.
Sicherheitskorrekturen
- Sicherheitskorrekturen gibt es nur für die jeweils neueste Version. Halten Sie COD deshalb aktuell.
- Automatische Updates sind für die COD-Pakete ab Werk nicht eingerichtet. Sie spielen Updates selbst ein.
- Bei Shared Hosted und Private Hosted spielt extocode neue Versionen selbst ein.
- Ein Beispiel: COD 3.8.6 enthält Sicherheitskorrekturen bei Assets, Protokollen und Active Directory.
Wie Sie aktualisieren: Updates einspielen. Welche Version aktuell ist: Versionen.
Sicherheitslücken melden
Melden Sie vermutete Sicherheitslücken in COD vertraulich per Mail an security@extocode.com.
Bitte nennen Sie:
- die COD-Version, etwa aus
apt policy cod-backend - die betroffene Komponente, etwa Modul, Dienst, Paket oder Browser-Erweiterung
- die Schritte, mit denen sich die Lücke nachvollziehen lässt
- wie Sie erreichbar sind
| Regel | Warum |
|---|---|
| Testen Sie nur an eigenen Installationen oder mit Erlaubnis des Betreibers | Fremde Installationen, auch gehostete Instanzen anderer Kunden, sind tabu |
| Schicken Sie keine echten Passwörter, Schlüssel oder Kundendaten mit | Beispieldaten reichen zum Nachvollziehen |
| Behandeln Sie die Meldung vertraulich | Betroffene sollen zuerst eine Korrektur erhalten |
Fristen für Antwort oder Korrektur und eine Belohnung sagen wir nicht zu. Sicherheitskorrekturen erscheinen für die jeweils neueste Version, siehe Sicherheitskorrekturen.
Weiterführend
- Mandanten, Standorte und Rollen
- Architektur von COD
- Modul Passkeepr in der Doku
- Modul GRC in der Doku
- Ersteinrichtung mit HTTPS und Manager-Konto
- FAQ zur Sicherheit