Überblick
Kuglers Auth
Kuglers Auth ist das zentrale Authentifizierungssystem für die eigenen Kuglers-Projekte. Die Anwendung verwaltet Benutzer, Gruppen, Sessions, registrierte Clients, Authorization Codes und Audit Logs.
Die produktive Domain lautet auth.kuglers.at. Die App läuft eigenständig in Docker und wird über Caddy veröffentlicht.
Zweck
Kuglers Auth ersetzt verstreute Admin-Logins in einzelnen Projekten durch eine gemeinsame Anmelde- und Rechtebasis.
Das System stellt bereit:
| Bereich | Aufgabe |
|---|---|
| Benutzer | Verwaltung von E-Mail, Name, Passwort-Hash und Aktivstatus. |
| Gruppen | Zentrale Rechtebasis für Kuglers OS, Docs, Status und spätere Apps. |
| Sessions | Serverseitige, widerrufbare Login-Sessions. |
| Clients | Registrierung angebundener Apps mit Redirect URIs und Client Secret. |
| SSO | OIDC-ähnlicher Authorization-Code-Flow. |
| Audit Logs | Nachvollziehbarkeit sicherheitsrelevanter Aktionen. |
Produktgrenzen
Kuglers Auth ist kein öffentliches Registrierungsportal und kein Identity-Provider für fremde Nutzer. Es ist ein internes, selbst betriebenes Auth-System für die eigene Plattform.
Bestehende Projekte werden nicht automatisch umgebaut. Kuglers OS, Kuglers Docs und Kuglers Status können später schrittweise angebunden werden.
Wichtige URLs
| URL | Zweck |
|---|---|
https://auth.kuglers.at/login | Login-Seite. |
https://auth.kuglers.at/admin | Adminpanel. |
https://auth.kuglers.at/authorize | Start des Authorization-Code-Flows. |
https://auth.kuglers.at/api/token | Austausch eines Codes gegen Userdaten und optional Token. |
https://auth.kuglers.at/api/userinfo | Userinfo-Endpunkt. |
https://auth.kuglers.at/api/health | Healthcheck für App, Datenbank und Redis. |
https://auth.kuglers.at/.well-known/jwks.json | Öffentliche JWKS für signierte Tokens. |
Standardgruppen
| Gruppe | Bedeutung |
|---|---|
admin | Vollzugriff auf Kuglers Auth und alle angebundenen Apps. |
os-admin | Administrationsrechte für Kuglers OS. |
docs-admin | Administrationsrechte für Kuglers Docs. |
status-admin | Administrationsrechte für Kuglers Status. |
viewer | Lesender Zugriff für spätere Anwendungen. |
service | Technische Service-Konten und Automationen. |
Die Gruppe admin gilt als globale Administratorgruppe. Das Auth-Adminpanel ist ausschließlich für Benutzer mit dieser Gruppe zugänglich.
Zuletzt aktualisiert: 2. Juni 2026