NAC
Diese Seite beschreibt, wie das Modul NAC mit FreeRADIUS arbeitet, was Geräte und COD dafür brauchen und wo die Grenzen liegen.
Was das Modul leistet, steht auf der Modulseite.
Stand: November 2026, COD 3.8.6
Inhalt der Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Dokumentation
- Übersicht
- Erste Schritte
- Voraussetzungen
- Namen und Adressen
- Netzgeräte
- Zeit und DNS
- Installation
- Aufbauformen
- Ersteinrichtung
- Updates
- Module
- Netzwerk und MikroTik
- Automatisierung
- NAC
- TACACS+
- Firewall
- Captive Portal
- Monitoring
- Backup
- Hypervisor
- OTP
- Passkeepr
- GRC
- Inventar und CMDB-Import
- Fehlerbilder
- Sicherheit
- Versionen
- Versionsverlauf
- Support
Überblick
| Merkmal | Wert |
|---|---|
| Zweck | Oberfläche und Steuerung für FreeRADIUS: MAC-Authentifizierung (MAB), 802.1X mit EAP-TLS, dynamische VLAN-Zuweisung, NAS-Verwaltung, eigene Zertifizierungsstelle |
| Geräte | Switches und Access Points mit 802.1X oder MAC-Authentifizierung und RADIUS, herstellerunabhängig |
| Dienst | NAC-Dienst mit FreeRADIUS und eigener Datenbank. Auf dem COD-Server oder auf einem eigenen Server, einmal je Host |
| Verbindungen und Richtung | Gerät zum NAC-Server: RADIUS-Authentisierung und RADIUS-Accounting. NAC-Server zum Gerät: Disconnect-Request (CoA) und ICMP für Heartbeat und Test. COD zum NAC-Dienst: alle Aufrufe aus der Oberfläche |
| Zugangsdaten | Shared Secret je NAS, am Gerät gleich eingetragen |
| Freigaben | Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt. |
Läuft der NAC-Dienst auf einem eigenen Server, etwa nahe an den Netzgeräten, gilt: Die Verbindung zwischen COD und Modul-Servern gehört in ein vertrauenswürdiges Netz. Bei Private Hosted stellen und betreiben Sie die NAC-Komponente in Ihrem Netz selbst.
Voraussetzungen
Am Switch oder Access Point
| Anforderung | Warum |
|---|---|
| 802.1X oder MAC-Authentifizierung (MAB) mit RADIUS | Grundlage der Zugangskontrolle |
| NAC-Server als RADIUS-Server, Shared Secret wie im NAS-Eintrag | Ohne passendes Secret weist FreeRADIUS die Anfrage ab |
| RADIUS-Quelladresse gleich Management-Adresse des Geräts | Sonst erscheinen keine NAC-Sitzungen am Port in Network |
| RADIUS-Accounting an den NAC-Server senden | Sitzungen und Verbindungsstatistik |
| Disconnect-Requests (CoA) vom NAC-Server annehmen | Trennen einer Sitzung aus COD, Secret-Test |
Für Allied Telesis, Cisco und Ruijie rollt ein Auth-Profil die 802.1X- und RADIUS-Zeilen aus. Siehe Automatisierung.
In COD und auf dem Host
- Modul NAC am Mandanten freigeschaltet.
- NAC-Dienst für den Standort ausgerollt.
- Zeitabgleich per NTP auf dem NAC-Server. Siehe Zeit und DNS.
- Optional: Mail-Einstellung des NAC-Dienstes für Benachrichtigungen.
Einrichtung
- Schalten Sie das Modul mit dem Manager-Konto unter „Admin Area > Tenant > Modules“ frei. Melden Sie sich danach ab und wieder an.
- Rollen Sie den NAC-Dienst unter „Admin Area > Module Rollout“ aus: Modul NAC, Standort, dann Install, Connect, Configure und Apply.
- Legen Sie eine CA an oder importieren Sie eine. Stellen Sie das Serverzertifikat aus. COD rollt es zu FreeRADIUS aus.
- Legen Sie jeden Switch und Access Point als NAS mit Shared Secret an.
- COD meldet danach, dass FreeRADIUS neu starten muss. „Restart Now“ startet FreeRADIUS ohne Rückfrage auf allen NAC-Servern des Standorts neu. Wählen Sie den Zeitpunkt bewusst.
- Richten Sie RADIUS am Gerät ein: Server, Shared Secret, Quelladresse, Accounting.
- Legen Sie VLANs, Client-Gruppen mit Prioritäten und MAC-Freigaben an. Größere Bestände übernehmen Sie per CSV-Import.
- Für 802.1X: Stellen Sie Client-Zertifikate aus und verteilen Sie sie als PKCS#12.
- Prüfen Sie Anmeldungen in den Authentisierungs- und Accounting-Logs und die Sitzungen unter der Portkarte in Network.
Hinweis: „Test Connection“ sendet einen echten Disconnect-Request an das Gerät. Nutzen Sie den Test, wenn eine getrennte Sitzung niemanden stört.
Technische Details
| Merkmal | Wert |
|---|---|
| Typ | COD-eigene, herstellerunabhängige NAC-Lösung auf Basis von FreeRADIUS |
| Authentifizierung | 802.1X mit EAP-TLS (Zertifikate), MAC-Authentifizierung (MAB) |
| EAP-Methoden | bestimmt die FreeRADIUS-Konfiguration auf dem Host. Die Oberfläche hat keine EAP-Einstellungen |
| Zugriffssteuerung | dynamische VLAN-Zuweisung über die RADIUS-Attribute Tunnel-Private-Group-Id, Cisco-AVPair und Egress-VLANID. Client-Gruppen mit Prioritäten |
| PKI | CAs mit RSA, ECDSA oder EdDSA, Leaf-Zertifikate mit SANs, CRL, PKCS#12-Export, CSV-Import vorhandener Bestände. Serverzertifikate gehen automatisch an FreeRADIUS, neue CAs erkennt COD selbst |
| NAS-Verwaltung | Switches und Access Points mit Shared Secret |
| Protokollierung | Authentisierungs- und Accounting-Logs (Erfolg, Fehler, Sitzungen), Verbindungsstatistik je Client, optionales Log-Streaming |
| Import | CSV-Massenimport von MAC-Adressen, VLAN-Zuweisungen und Gruppen mit Prüfung und Konflikterkennung |
| Zeitbasierte Freigaben | Gäste und befristete Mitarbeitende kommen nur im festgelegten Zeitfenster ins Netz |
| Dienststeuerung | Start, Stop und Restart von FreeRADIUS in der Oberfläche, mit Status und Uptime |
| Audit | Änderungen im NAC-Dienst stehen im Audit der Admin Area, mit dem handelnden Benutzer |
| Weiterleitung | optional Protokolle per GELF an Graylog, vom NAC-Server aus |
VLAN-Zuweisung
Ein Gerät lässt sich jedem angelegten VLAN zuweisen, auch einem eigenen Quarantäne- oder Gäste-VLAN. Ob ein Endgerät konform ist, prüft das Modul nicht.
Sitzungen am Port
Network zeigt unter der Portkarte die RADIUS-Sitzungen des Geräts: Benutzer, MAC, IP, Start, Dauer und Ende. COD fragt NAC dafür in jeder gängigen Schreibweise von Port und MAC. Voraussetzung ist, dass der Switch RADIUS von seiner Management-Adresse sendet.
Wer war wann verbunden
Das zeigen die Authentisierungs- und Accounting-Logs und die Verbindungsstatistik je Client.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Die NAS-Liste ist nicht mit dem Asset verknüpft | Ändert sich die Adresse eines Geräts, ziehen Sie den NAS-Eintrag von Hand nach |
| „Test Connection“ sendet einen echten Disconnect-Request | Testen Sie, wenn eine getrennte Sitzung niemanden stört |
| Bei mehreren NAC-Instanzen erreicht die Konfiguration nur die erste, die antwortet | Rechnen Sie nicht mit einem Abgleich zwischen Instanzen. Planen Sie Redundanz mit Ihrem Partner |
| NAC läuft einmal je Host | Eine weitere Instanz braucht einen eigenen Server |
| Keine EAP-Einstellungen in der Oberfläche | EAP-Methoden legt die FreeRADIUS-Konfiguration fest. Änderungen stimmen Sie mit Ihrem Partner ab |
| „Restart Now“ startet ohne Rückfrage auf allen NAC-Servern des Standorts neu | Starten Sie neu, wenn kurze Anmeldepausen niemanden stören |
| Keine NAC-Sitzungen am Port, wenn die RADIUS-Quelladresse nicht die Management-Adresse ist | Stellen Sie die Quelladresse am Gerät auf die Management-Adresse |
| Keine Anbindung einer vorhandenen Windows-CA | Nutzen Sie die Zertifizierungsstelle von COD für 802.1X |
| Keine Anbindung von PacketFence | Die Zugangskontrolle in COD arbeitet mit FreeRADIUS |
| Keine Konformitätsprüfung der Endgeräte | Weisen Sie auffällige Geräte einem Quarantäne-VLAN zu |
Weiterführend
- Modulseite NAC
- Was Ihr Netz für NAC braucht
- Auth-Profile mit dem Modul Automatisierung
- Aufbauformen mit eigenem NAC-Server
- Fehlerbilder
- Fragen zu den Modulen
- Support: Zuerst hilft Ihr Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular.