Zweck: Zentrale Passkontrolle des Gesamtsystems. Statt dass jede Software eine eigene Passwortliste führt, gibt es einen einzigen Anmeldepunkt (Keycloak auf VM 104). Nach dem Login stellt Keycloak ein zeitlich begrenztes Ticket (JWT) aus – damit bewegt man sich frei zwischen den zugelassenen Anwendungen (Single-Sign-On).
Architektur (Identity Brokering) Keycloak ist ein „Identity Broker". Aufbau:
- Realm: logischer Sicherheitsbereich → hier der
FORCAM-Realm. - Users: die menschlichen Maschinenbediener.
- Roles: z.B. Schichtleiter, Admin.
- Clients: externe Anwendungen (Next.js-Dashboard, Swagger-UI), die sich authentifizieren.
⚠ Single Point of Failure: Ohne Realm-Admin-Rechte kann man keine neuen Clients registrieren, keine Redirect-URIs freigeben und keine Service Accounts anlegen. Da die REST-API alle Anfragen ohne gültiges Token abweist, blockiert der fehlende Admin-Zugang die komplette Schnittstellen-Entwicklung. → siehe Bekannte Zugangsprobleme.
Protokolle
- OAuth 2.0: reines Autorisierungs-Framework. Das Dashboard greift im Namen des Nutzers auf die API zu, ohne dessen Passwort je zu sehen (Delegated Access).
- OpenID Connect (OIDC): Identitätsschicht auf OAuth 2.0. Liefert ein ID-Token zur sicheren Anmeldung.
JSON Web Token (JWT) – drei Base64-URL-codierte Blöcke:
- Header: Signaturalgorithmus (häufig RS256 = RSA + SHA-256).
- Payload (Claims): Nutzerdaten, Rollen, Ablaufzeitpunkt (
exp). - Signature: kryptografischer Hash, mit dem privaten Schlüssel des Keycloak-Servers signiert. Das Next.js-Backend prüft offline über den öffentlichen Schlüssel → Manipulation ausgeschlossen.
Konfiguration (Kurzreferenz)
ParameterWert
Identity Provider
Keycloak (Open Source IAM)
Protokolle
OAuth2, OIDC (SAML 2.0 verfügbar, nicht genutzt)
Realm
FORCAM
Endpunkt
https://<anwendungsserver>:25443/ffauth/realms/FORCAM/
Token-Typ
JWT (Bearer Token)
Admin
Realm-Admin-Rechte für Anlage technischer API-User
Authentifizierungsmethoden
- Username/Password: klassisch, für interaktive Nutzer über das Web-Interface.
- OAuth2 Client Credentials (bevorzugt für API): Service Accounts mit Client ID + Client Secret. Empfohlen für automatisierte Abfragen und System-zu-System-Kommunikation.
Sicherheitshinweise
- ✓ Client Secrets / Token nie im Klartext in Repos → Secret-Management verwenden.
- ✓ Realm-Admin-Rechte auf wenige vertrauenswürdige Accounts beschränken.
- ✓ Token-Laufzeiten (Access Token Lifespan) gemäß Sicherheitsrichtlinie setzen.
- ✓ HTTPS obligatorisch (Ports 15443 + 25443), reines HTTP deaktivieren.
- ✓ Aktive Sessions und Service-Account-Rechte regelmäßig prüfen.
- ✓ Firewall: Ports 15443, 25443 (FORCAM) + 8006 (Proxmox) nur aus dem DHBW-Intranet.
Verwandte Seiten: VM 104 App-Server · REST-API & Token-Beschaffung · Bekannte Zugangsprobleme · Grundlagen