TACACS+
Diese Seite beschreibt, wie der mitgelieferte TACACS+-Dienst aufgebaut ist, wie Sie ihn einrichten und anbinden 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 | Authentifizierung, Autorisierung und Accounting für Administratoranmeldungen an Netzwerkgeräten. Benutzer, Gruppen, Clients, Command-Sets, Rollen, Accounting |
| Standard | TACACS+ nach RFC 8907 |
| Lieferumfang | eigener TACACS+-Dienst mit eigener Datenbank und eigener Verwaltungs-API, Teil von COD. Einen fremden TACACS+-Server brauchen Sie nicht |
| Geräte | Switches, Router, Firewalls und Access-Server mit TACACS+-Client. MikroTik wird nicht unterstützt |
| Verbindungen und Richtung | Gerät zum TACACS+-Dienst. COD zur Verwaltungs-API. Die Oberfläche spricht die API nie direkt an, sondern immer über COD |
| TLS | TACACS+ über TLS ist vorhanden und ab Werk ausgeschaltet |
| Zugangsdaten am Gerät | Adresse des TACACS+-Dienstes und Shared Secret je Client |
| Menü | „Network > TACACS+“ |
| Freigaben | Die Liste der Verbindungen und Freigaben erhalten Kunden und Partner im Projekt. |
Voraussetzungen
Am Gerät
| Anforderung | Warum |
|---|---|
| TACACS+-Client nach RFC 8907 | RouterOS von MikroTik hat keinen eigenen TACACS+-Client |
| Adresse des TACACS+-Dienstes und Shared Secret eingetragen | Ohne Secret weist der Dienst klassisches TACACS+ ab |
| Client-Name in COD passt exakt zum Gerät | Die Zuordnung zum Client hängt am exakten Namen |
| Accounting eingeschaltet | Die Activity-Probe und das Accounting sehen nur Geräte, die Accounting senden |
In COD und auf dem Host
- Modul TACACS+ am Mandanten freigeschaltet.
- Der Dienst läuft einmal je Host und ist einmandantig.
- Das Feld für die Modul-URL ist nur sichtbar, wenn am Mandanten zusätzlich NAC, Backup oder Passkeepr freigeschaltet ist.
- Zeitabgleich per NTP auf dem Host. Siehe Zeit und DNS.
Einrichtung
Der Rollout-Assistent in COD deckt TACACS+ nicht ab. Den Dienst richten Sie auf dem Host von Hand ein.
- Installieren Sie die Pakete des TACACS+-Dienstes auf dem Host. Im Paket
cod-allsind sie enthalten. - Prüfen Sie die Konfiguration des Dienstes auf dem Host.
- Läuft der Dienst auf einem eigenen Server: Ab Werk ist die Verwaltungs-API nur lokal erreichbar. Öffnen Sie sie für den COD-Server. Die Verbindung zwischen COD und Modul-Servern gehört in ein vertrauenswürdiges Netz.
- Prüfen Sie die Dienste mit
systemctl list-units 'cod-*'. - Schalten Sie das Modul mit dem Manager-Konto unter „Admin Area > Tenant > Modules“ frei. Melden Sie sich danach ab und wieder an.
- Tragen Sie die Adresse der Verwaltungs-API unter „Location > Module URLs“ ein. Die Adresse endet auf
/api/v1. - Legen Sie unter „Network > TACACS+“ Benutzer, Benutzergruppen und Clients an. Je Client ein Shared Secret.
- Legen Sie unter „Access Control“ Command-Sets, Regeln und Rollen an.
- Richten Sie TACACS+ am Gerät ein: Adresse, Shared Secret, Accounting.
- Prüfen Sie mit der Activity-Probe, ob das Gerät TACACS+ spricht.
Hinweis: Behalten Sie am Gerät einen lokalen Notfallzugang, bis die Anmeldung über TACACS+ geprüft ist. An Fernstandorten gilt: immer ein zweiter Zugangsweg.
Hinweis: Der Hauptschlüssel des Dienstes darf sich nach der Einrichtung nie ändern. Nehmen Sie die Konfiguration des Dienstes in Ihre Sicherung auf. Die vollständige Liste erhalten Sie im Projekt.
Technische Details
| Merkmal | Wert |
|---|---|
| Typ | AAA-Server für die Administration von Netzwerkgeräten (Authentifizierung, Autorisierung, Accounting) |
| Protokoll | TACACS+ nach RFC 8907, optional über TLS |
| Autorisierung | PERMIT- und DENY-Regeln, musterbasierte Kommando-Autorisierung über Command-Sets, Privilege-Level 1 bis 15 je Benutzer |
| Rollen | Eine Rolle verbindet Benutzergruppe, Gerätegruppe und Regel. So erhält ein Benutzer je Gerätegruppe andere Rechte |
| Kryptografie | Argon2id für Passwörter (nicht umkehrbar), AES-256-GCM für sensible Felder |
| Verwaltung | REST-API, getrennt vom Server-Dienst. COD spricht sie über den eigenen Proxy an |
| Betrieb | Python, PostgreSQL |
| Deaktivieren | über ein enabled-Kennzeichen. Deaktivierte Benutzer und Regeln überspringt der Dienst bei der Prüfung |
| Accounting | Sitzungen mit Benutzer, Kommando, Gerät und Zeit. Detailzeilen mit Port, Remote-Adresse und Privilege-Level. Live-Log zuschaltbar |
| Diagnose | Activity-Probe auf Basis der Accounting-Daten: aktiv, inaktiv oder kein Traffic |
| Audit | Änderungen über COD stehen im Audit der Admin Area mit Vorher und Nachher |
Activity-Probe
COD greift nicht per SSH auf Ihre Geräte zu und liest keine Konfiguration aus. Die Activity-Probe wertet nur die Accounting-Daten aus. Ein Gerät ohne Accounting erscheint dort unter Umständen nicht.
Rollen-Simulator
Der Simulator rechnet im Browser aus der Konfiguration einer Rolle, ob sie ein Kommando erlaubt, verweigert oder keinen Treffer hat. Er kontaktiert nichts und ändert nichts. Ob der Dienst selbst zustimmt, zeigt er nicht.
Standort und Rechte
Die Anbindung gilt je Standort, die Rechte in COD je Modul und Standort. Ein TACACS+-Client ist nicht an ein Asset gebunden.
Bekannte Grenzen
| Grenze | Was Sie tun können |
|---|---|
| Einmandantig, einmal je Host | Planen Sie für einen weiteren Mandanten einen eigenen Server |
| Kein MikroTik | Verwalten Sie die Anmeldung an RouterOS mit den Mitteln von RouterOS |
| Der Rollout-Assistent deckt TACACS+ nicht ab | Richten Sie den Dienst auf dem Host von Hand ein, wie oben beschrieben |
| Das Feld für die Modul-URL ist nur sichtbar, wenn zusätzlich NAC, Backup oder Passkeepr freigeschaltet ist | Sprechen Sie in diesem Fall Ihren Partner an |
Die Adresse der Verwaltungs-API muss auf /api/v1 enden | Prüfen Sie die Adresse unter „Location > Module URLs“ |
| Der Client-Name muss exakt passen | Schreiben Sie den Namen in COD und am Gerät gleich |
| Ohne Shared Secret weist der Dienst klassisches TACACS+ ab | Vergeben Sie je Client ein Secret |
| Ohne Accounting keine Aussage der Activity-Probe | Schalten Sie Accounting am Gerät ein |
| Direkte Änderungen am Dienst stehen nicht im Audit. Der Dienst führt keine eigene Änderungshistorie | Ändern Sie Daten nur über COD |
| Der Rollen-Simulator zeigt nicht die Entscheidung des Dienstes | Prüfen Sie neue Rollen an einem Testgerät |
| TACACS+ über TLS ist ab Werk aus | Klären Sie den Einsatz von TLS mit Ihrem Partner |
Weiterführend
- Modulseite TACACS+
- Was Ihr Netz für TACACS+ braucht
- Aufbauformen
- Ersteinrichtung
- Fehlerbilder
- Fragen zu den Modulen
- Support: Zuerst hilft Ihr Partner. Technische Rückfragen an extocode stellen Sie über das Helpdesk-Formular.