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¶
- Die Authentifizierungseinstellungen von QGIS öffnen.
- Eine neue Authentifizierungskonfiguration anlegen.
- OAuth2 auswählen.
- Unter Berechtigungsfluss PKCE auswählen.
- Anfrage-URL auf
http://localhost:8080/realms/xmas/protocol/openid-connect/authsetzen. Dieser Wert gilt für den lokalen Betrieb; sonst den Wert eintragen, den der Betreiber der App nennt. - Token-URL auf
http://localhost:8080/realms/xmas/protocol/openid-connect/tokensetzen. Auch dieser Wert gilt für den lokalen Betrieb; sonst den Wert eintragen, den der Betreiber der App nennt. - Client-ID auf
xmas-pluginsetzen. - Umgeleitete URL auf
127.0.0.1:17070setzen. - 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:
Authentifizierung für die lokale Entwicklung¶
Die lokale Entwicklung verwendet ein statisches Bearer-Token.
Konfiguration des QGIS-Plugins¶
- Die Authentifizierungseinstellungen von QGIS öffnen.
- Eine neue Authentifizierungskonfiguration anlegen.
- API-Kopf auswählen.
- Kopfschlüssel auf
Authorizationsetzen. - Kopfwert auf
Bearer <local-dev-token>setzen. - Diese Authentifizierungskonfiguration in den Einstellungen des XMAS-Plugins auswählen.
Konfiguration der XMAS-App¶
Die XMAS-App muss dasselbe Token akzeptieren, zum Beispiel:
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.