Aufbauformen
Diese Seite zeigt, wie Sie COD bei Self Hosted auf einen oder mehrere Hosts verteilen und welche Regeln dabei fest gelten.
Stand: November 2026, COD 3.8.6
Dokumentation
Die fünf Aufbauformen
| Nr. | Aufbauform | Hosts | Wann sinnvoll |
|---|---|---|---|
| 1 | Alles auf einem Server | 1 | Einstieg, Test, kleine Umgebung |
| 2 | COD zuerst, Module später auf demselben Host | 1 | Der Modulumfang steht noch nicht fest |
| 3 | COD-Server plus Modul-Server für NAC, Backup, Passkeepr, Ansible oder TACACS+ | ab 2 | Segmentierung, RADIUS nahe an den Netzgeräten, ein Modul in einer DMZ |
| 4 | Vorhandene oder entfernte Datenbankserver | ab 2 | Ein Datenbank-Team oder Ihre Sicherung betreut MariaDB und PostgreSQL |
| 5 | Mehrere Standorte, mehrere Instanzen je Host | ab 1 | Mehrere Standorte teilen sich Modul-Server |
Die Formen lassen sich kombinieren. Ein Server reicht für den Anfang. Den Aufruf des Einrichtungsskripts erhalten Sie zusammen mit den Repository-Zugangsdaten.
Richtwerte für Ihre Größe nennt Ihr Partner.
Dienste und wo sie laufen
| Dienst | Wo | Instanzen je Host |
|---|---|---|
COD (cod-backend) mit Weboberfläche und Sammler | COD-Server | eine |
Schlüsseldienst (cod-jwks) | COD-Server, auf Wunsch eigener Server | eine |
| Cache (Redis, auf Ubuntu 26.04 Valkey) | immer COD-Server | eine |
| NAC mit FreeRADIUS | COD-Server oder eigener Server | eine |
| TACACS+ | COD-Server oder eigener Server | eine, einmandantig |
| Backup | COD-Server oder eigener Server | mehrere möglich |
| Passkeepr | nach Möglichkeit COD-Server | mehrere möglich |
| Ansible | COD-Server oder eigener Server | mehrere möglich |
| Hypervisor | immer COD-Server | mehrere möglich |
Feste Regeln
- Hypervisor immer auf dem COD-Server. COD erreicht den Dienst nur lokal.
- Passkeepr nach Möglichkeit auf dem COD-Server.
- Cache immer auf dem COD-Server.
- Nur einmal je Host: NAC (eine FreeRADIUS-Installation je Host), TACACS+ (einmandantig), COD (
cod-backend) und der Schlüsseldienst (cod-jwks). - Mehrfach je Host: Backup, Passkeepr, Ansible und Hypervisor. Jede Instanz gehört zu einem Standort und hat eine eigene Moduladresse.
- Rollout-Assistent: Er deckt nur Ansible, Backup, NAC und Passkeepr ab. TACACS+ und Hypervisor richten Sie auf dem Host von Hand ein.
- Ansible auf eigenem Server: Der Dienst lauscht ab Werk nur lokal. Läuft er auf einem eigenen Server, stellen Sie dort die Netzwerkadresse ein. Den Betrieb auf einem eigenen Server stimmen Sie mit Ihrem Partner ab.
- Vertrauenswürdiges Netz: Die Verbindung zwischen COD und Modul-Servern gehört in ein vertrauenswürdiges Netz.
Modul-Server
Auf jedem Modul-Server läuft das Einrichtungsskript wie auf dem COD-Server. Die Oberfläche spricht nie direkt mit einem Modul. Jeder Aufruf geht über COD. Die Module holen die Signierschlüssel beim Schlüsseldienst und prüfen jede Anmeldung damit selbst. Netzgeräte sprechen RADIUS direkt mit dem NAC-Server und TACACS+ direkt mit dem TACACS+-Server.
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Mehrere Standorte
- Ein COD bedient alle Standorte.
- Jeder Standort bekommt eine eigene Backup-Instanz mit eigenem Hostregister und eigener Ablage. Mehrere Standorte können sich auch eine Instanz teilen. Sie tragen dann dieselbe Moduladresse ein.
- Für Passkeepr und Ansible gilt dasselbe Muster.
- Die Moduladressen pflegen Sie je Standort unter „Location > Module URLs“.
Eigene Datenbankserver
| Bestandteil | Datenbank-Engine |
|---|---|
| COD | MariaDB |
| GRC | PostgreSQL |
| Backup | MariaDB |
| NAC und FreeRADIUS | MariaDB, zwei Datenbanken mit einem gemeinsamen Benutzer |
| Passkeepr | PostgreSQL |
| TACACS+ | PostgreSQL |
Bereiten Sie auf Ihren Datenbankservern vor:
- Die Server nehmen Verbindungen vom COD-Server und von den Modul-Servern über das Netz an.
- Jede Datenbank bekommt einen eigenen Benutzer. Er hat Rechte nur auf seine eigene Datenbank. Ausnahme ist NAC mit einem Benutzer für beide Datenbanken.
- PostgreSQL läuft ab Version 18. Ältere Versionen weist die Installation ab.
- PostgreSQL meldet die Clients mit scram-sha-256 an, je Datenbank für die Adressen der zugreifenden Hosts.
- NTP läuft auch auf den Datenbankservern.
Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt.
Shared Hosted und Private Hosted
Bei Shared Hosted und Private Hosted betreibt extocode die Instanz. Bei Private Hosted stellen und betreiben Sie Komponenten in Ihrem Netz selbst, etwa die NAC-Komponente. Mehr dazu unter Erste Schritte: Betriebsarten.
Weiterführend
- Architektur von COD
- Installation
- Voraussetzungen
- Updates bei getrennten Hosts
- FAQ: Installation und Updates