Skip to content

Authentifizierung

Authentifizierung im Produktivbetrieb

Authorization-Code-Flow mit PKCE (RFC 7636):

[QGIS-Plugin]  ──OIDC-Auth──▶  [Keycloak]
     │                              │
     │  JWT (Bearer-Token)          │ (prüft)
     ▼                              ▼
[FastAPI/NiceGUI-Backend]  ◀── JWT-Prüfung
     │
     ▼
[NiceGUI-Frontend, eingebettet in QGIS WebEngine]

Wichtig: Das QGIS-Plugin ist in diesem Aufbau der öffentliche Client und darf das client_secret nicht kennen. Das Plugin läuft auf Rechnern, die die Nutzer selbst kontrollieren; ein eingebettetes Geheimnis ließe sich dort auslesen. PKCE ersetzt das Client-Geheimnis als Besitznachweis.

Konfiguration des QGIS-Plugins

  1. Die Authentifizierungseinstellungen von QGIS öffnen.
  2. Eine neue Authentifizierungskonfiguration anlegen.
  3. OAuth2 auswählen.
  4. Unter Berechtigungsfluss PKCE auswählen.
  5. Anfrage-URL auf http://localhost:8080/realms/xmas/protocol/openid-connect/auth setzen. Dieser Wert gilt für den lokalen Betrieb; sonst den Wert eintragen, den der Betreiber der App nennt.
  6. Token-URL auf http://localhost:8080/realms/xmas/protocol/openid-connect/token setzen. Auch dieser Wert gilt für den lokalen Betrieb; sonst den Wert eintragen, den der Betreiber der App nennt.
  7. Client-ID auf xmas-plugin setzen.
  8. Umgeleitete URL auf 127.0.0.1:17070 setzen.
  9. Diese Authentifizierungskonfiguration in den Einstellungen des XMAS-Plugins auswählen.

Die Zugangsdaten für die Entwicklung sind der Benutzername xmas-test-user und das Passwort test.

Konfiguration der XMAS-App

Die XMAS-App muss für die Authentifizierung über Keycloak konfiguriert sein:

AUTH_MODE=keycloak

Authentifizierung für die lokale Entwicklung

Die lokale Entwicklung verwendet ein statisches Bearer-Token.

Konfiguration des QGIS-Plugins

  1. Die Authentifizierungseinstellungen von QGIS öffnen.
  2. Eine neue Authentifizierungskonfiguration anlegen.
  3. API-Kopf auswählen.
  4. Kopfschlüssel auf Authorization setzen.
  5. Kopfwert auf Bearer <local-dev-token> setzen.
  6. Diese Authentifizierungskonfiguration in den Einstellungen des XMAS-Plugins auswählen.

Konfiguration der XMAS-App

Die XMAS-App muss dasselbe Token akzeptieren, zum Beispiel:

AUTH_TOKENS={"local-dev-token": "<user-name>", ...}
AUTH_MODE=static

Anfragen müssen diesen Header enthalten: Authorization: Bearer local-dev-token

Das Token wird intern einer Benutzer-ID zugeordnet, die als angemeldeter Benutzer gilt.

Dieser Aufbau ist nur für die lokale Entwicklung und zum Testen gedacht. Im Produktivbetrieb muss das statische Token durch ein gültiges, von Keycloak ausgestelltes Bearer-Access-Token ersetzt werden.

Rasterdaten (Plandokumente)

Die Raster-Scans eines Plans (die Dokumente, die seine refScans benennen) und ihre World-Files werden vollständig über den Requester heruntergeladen, authentifiziert wie jede andere Anfrage. Sie landen im temporären Processing-Ordner von QGIS, den QGIS beim Beenden löscht. Diese Kopie liest der GDAL-Provider von QGIS, hinter dem Raster-Provider des Plugins (xmas_plugin/core/components/raster.py).

Die Quelle eines Scan-Layers benennt Plan, SRID, Bild und World-File, nie einen Host, ein Token oder einen lokalen Pfad. Ein gespeichertes Projekt öffnet seine Scans deshalb wieder: Sie werden beim Einlesen des Projekts im Hintergrund heruntergeladen, genauso wie bei jedem Laden eines Plans. Bis die Dateien eines Scans vorliegen, zeichnet sein Layer nichts; ein Download wartet darauf, dass die App das Plugin akzeptiert, wie die Vektor-Layer des Plans auch. Ohne das Plugin sind die Scan-Layer nicht verfügbar.