Ersteinrichtung
Diese Seite führt durch die Einrichtung nach der Installation, von der ersten Anmeldung bis zu den ersten Modulen.
Stand: November 2026, COD 3.8.6
Dokumentation
Erste Anmeldung
Der Einrichtungsassistent legt zwei Konten an.
| Konto | Zweck | Anmeldung |
|---|---|---|
| Erster Superadmin | erster Administrator der Installation | mit der Mailadresse aus dem Assistenten |
| Manager-Konto | eingebautes Notfall- und Verwaltungskonto. Einziges Konto, das Module am Mandanten freischaltet | mit TOTP |
- Den QR-Code für TOTP und einen Schlüssel zeigt der Assistent genau einmal. Richten Sie TOTP sofort in einer Authenticator-App ein und bewahren Sie den Schlüssel sicher auf.
- Die Mailadresse des Manager-Kontos lässt sich später nicht ändern.
- Die Oberfläche ist englisch.
- Eine Sitzung gilt bis zu 7 Tage.
HTTPS
HTTPS ist für jeden Zugriff Pflicht. COD setzt seine Sitzungs-Cookies nur für sichere Verbindungen. Ohne HTTPS ist eine Anmeldung nur lokal auf dem COD-Server möglich.
| Weg | Einrichtung | Hinweis |
|---|---|---|
| Installationseigene Zertifizierungsstelle | im Einrichtungsassistenten | COD bringt dafür eine eigene Zertifizierungsstelle mit |
| Eigenes Zertifikat | „Backend config“, Karte „TLS“: Zertifikat, Schlüssel und CA angeben | Das Zertifikat lautet auf den Namen, unter dem Anwender COD aufrufen |
| Reverse Proxy | Proxy vor COD, in COD „trust proxy“ einschalten | Der Proxy muss WebSocket (Terminal) und Server-Sent Events (Passkeepr) durchlassen. Eine Beispielkonfiguration erhalten Sie im Projekt. |
Hinweis: Speichern in „Backend config“ startet COD für alle Anwender neu. Bestätigen Sie die Änderung nicht innerhalb von 120 Sekunden, kehrt COD zur vorigen Einstellung zurück.
Module freischalten
- Melden Sie sich mit dem Manager-Konto an.
- Öffnen Sie „Admin Area > Tenant > Modules“.
- Wählen Sie die lizenzierten Module und speichern Sie.
- Melden Sie sich ab und wieder an. Erst dann zeigt COD die Module.
- Rollen Sie die Module je Standort aus. Der Ablauf steht unter Installation: Module ausrollen.
Reihenfolge der Einrichtung
Richten Sie eine neue Installation in dieser Reihenfolge ein. Spätere Schritte bauen auf früheren auf.
- Organisation (Mandant) und Module, siehe Module freischalten
- Standorte
- Rollen, siehe Rollen und Rechte
- Benutzer
- Verzeichnisanbindung, siehe LDAP und Active Directory
- Mail je Standort, siehe Mail je Standort
- Asset-Kataloge: Typen, Hersteller, Familien und Modelle. Den eingebauten Typ „Firewall“ nicht umbenennen. Siehe Inventar
- Moduladressen je Standort unter „Location > Module URLs“
- Namensschema, siehe Namen und Adressen
- Assets und Netzwerkobjekte, siehe Inventar und Netzwerk
- Monitoring, siehe Monitoring
- Firewall, siehe Firewall
- Captive Portal, siehe Captive Portal
- Ansible-Konfiguration, siehe Automatisierung
- GRC, siehe GRC
- Optionale Integrationen, siehe Integrationen
- Branding
Rollen und Rechte
- Welche Rollen Sie anlegen, stimmen Sie mit Ihrem Partner ab.
- Der Standort ist die kleinste Grenze für Rechte und Daten. Rechte je Gerät gibt es nicht.
- Installationsweit gelten das Branding, die Asset-Kataloge und die Asset-Namen. Asset-Namen sind installationsweit eindeutig und höchstens 50 Zeichen lang.
- Module schaltet nur das Manager-Konto frei.
LDAP und Active Directory
- COD baut die Verbindung zum Domain Controller auf.
- LDAPS ist ab Werk eingeschaltet („Use LDAPS“). Hinterlegen Sie das CA-Zertifikat Ihres Verzeichnisdienstes in COD.
- Die Felder der Anbindung gibt es je Mandant und je Standort. Domain-Aliase sind möglich.
- Rechte vergeben Sie über eine Verzeichnisgruppe, die Sie an der Rolle eintragen.
- Behalten Sie für den Ausfall des Verzeichnisdienstes einen lokalen Zugang, etwa das Manager-Konto.
Mail je Standort
Die Mail-Einstellung gehört zum Standort. Sie ist praktisch Pflicht.
COD verschickt darüber:
- Meldungen über den Rückmeldeweg
- Meldungen zur Erreichbarkeit
- Meldungen zu Zertifikaten
- Einladungen und Links zum Setzen eines Passworts
Dazu gilt:
- „Send test e-mail“ in den Mail-Einstellungen der Location zeigt die Antwort des Mailservers.
- Backup und NAC haben eigene Mail-Einstellungen für ihre Meldungen. Die Backup-Instanz meldet fehlgeschlagene Sicherungen per Mail, wenn Mail dort eingeschaltet ist.
Erste Module
Empfohlen ist diese Reihenfolge: Inventar, Netzwerk, Monitoring, Backup. Das Inventar ist die Grundlage für alle weiteren Module.
Inventar
| Was Sie tun | Woran Sie sehen, dass es läuft |
|---|---|
| Kataloge prüfen (Typ, Hersteller, Familie, Modell). Assets von Hand, per CSV-Import oder per Import aus i-doit anlegen | Die Assets stehen in der Asset-Liste des Standorts. |
Mehr dazu unter Inventar und CMDB-Import.
Netzwerk
| Was Sie tun | Woran Sie sehen, dass es läuft |
|---|---|
| Am Asset das Netzwerk-Kennzeichen setzen, Hersteller und Modell richtig wählen. Netzwerkobjekt mit Adresse, SNMP-Community und SSH-Zugang anlegen. Für Layer 3 „Routing“ einschalten | Ports und Portstatus erscheinen. Der Portstatus wird alle 30 Sekunden aktualisiert. Kein Objekt steht auf „port discovery failed“. Die Layer-2-Karte zeigt Verbindungen zwischen Geräten, deren LLDP-Systemname dem Asset-Namen entspricht |
Mehr dazu unter Netzwerk und MikroTik und Netzgeräte vorbereiten.
Monitoring
| Was Sie tun | Woran Sie sehen, dass es läuft |
|---|---|
| Je Standort die Zabbix-Anbindung eintragen: API-Adresse, API-Token, auf Wunsch ein Filter auf Host-Gruppen. Der Token braucht Schreibrechte auf die eigenen Server-Gruppen | Hosts und Probleme aus Zabbix erscheinen in COD. Die Liste der nicht überwachten Assets zeigt, welchem Asset noch ein Zabbix-Host fehlt. Der nächtliche Abgleich verknüpft Assets und Zabbix-Hosts mit gleichem Namen |
Mehr dazu unter Monitoring.
Backup
| Was Sie tun | Woran Sie sehen, dass es läuft |
|---|---|
| Backup je Standort ausrollen. Host mit Adresse, Benutzer und Passwort anlegen, Vorlage wählen (Download, Command oder MariaDB-Dump), Zeitplan setzen | Nach „Execute Now“ oder dem ersten geplanten Lauf erscheint ein Stand mit Zeitstempel. Scheitert ein Lauf, steht der Host auf ERROR, und der Fehler ist in der Übersicht sichtbar |
Mehr dazu unter Backup.
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.