Authentifizierung¶
QField unterstützt die Verbindung zu OAuth2-geschützten Webdiensten. Durch die Verwendung von OAuth2 ist es möglich, Layer und Dienste mit einer breiten Anzahl an Authentifizierungsschemata wie z.B. Zwei-Faktor-Authentifizierung zu schützen .
Um OAuth2-geschützte Layer erfolgreich in QField zu laden, muss das QGIS-Projekt für die Verwendung von OAuth2 eingerichtet sein.
Bereiten Sie die Authentifizierung in QGIS vor¶
Desktop Vorbereitung
Um ein WFS mit OAuth2 in QGIS einzurichten, folgen Sie diesen Schritten in der QGIS-Projektkonfiguration.
In der WFS-Layer-Konfiguration:
Fügen Sie eine neue Authentifizierungskonfiguration hinzu. Parameter müssen an das OAuth2-Server-Setup angepasst werden :
Exportieren Sie die Authentifizierung aus QGIS¶
Desktop Vorbereitung
Anmerkung
Für das Exportieren einer Authentifizierungskonfiguration ist mindestens QGIS 3.20 erforderlich. Es ist möglich, QGIS 3.20 zur Vorbereitung der Authentifizierungskonfiguration und um das QGIS-Projekt selbst mit einer früheren Version von QGIS zu nutzen.
Anmerkung
Es ist wichtig, dass die Konfigurations-ID der exportierten Konfiguration und die im QGIS-Projekt gespeicherte Konfiguration identisch sind.
Stellen Sie an dieser Stelle sicher, dass Sie eine Verbindung mit dem Service von QGIS herstellen können. Diese Authentifizierungskonfiguration muss zunächst aus QGIS exportiert werden.
Öffnen Sie dazu den QGIS-Optionsdialog und die Authentifizierungs-Schaltfläche. Dort können Sie die OAuth2-Konfiguration auswählen, die von den Projektlayern verwendet wird, indem Sie auf die entsprechende Zeile in dem Widget für die Konfigurationstabelle tippen. Verwenden Sie dann unten rechts die Utilities-Schaltfläche, um die Option Ausgewählte Authentifizierungs-Konfiguration in Datei exportieren auszuwählen.
Wenn Sie zur Eingabe eines Kennworts aufgefordert werden, lassen Sie das Feld leer. Sie werden gewarnt dass möglicherweise sensible Informationen preisgegeben werden. Im Falle von OAuth2-Konfigurationen ist es sicher, dies zu tun.
Nachdem Sie die Authentifizierungskonfiguration in eine XML-Datei exportiert haben, muss diese Datei auf die Geräte, auf denen QField ausgeführt wird, kopiert werden. Die Datei muss in das QField-Verzeichnis <drive>:/Android/data/ch.opengis.qfield/files/QField/auth/ des Geräts kopiert werden. Der /QField/auth/ Pfad wird erstellt, wenn Sie zum ersten Mal QField starten.
Anmerkung
Seit QField 2 müssen die Authentifizierungsdateien im App-Verzeichnis <drive>:/Android/data/ch.opengis.qfield/files/QField/auth statt im Hauptverzeichnis des Geräts <drive>:/QField/auth gespeichert werden.
Nachdem die XML-Datei für die Authentifizierungskonfiguration kopiert wurde, können Sie die Projektdatei mit OAuth2-geschützten Layern auf das/die Gerät(e) kopieren und das Projekt in QField öffnen. Sie werden aufgefordert, Benutzer, Kennwort und Authentifizierungscode für die 2-Faktor-Verifizierung innerhalb eines Browser-Panels einzugeben, das sich in QField öffnet.
Nach der Authentifizierung werden Inhalte gerendert, ohne dass für die Dauer der Sitzung eine erneute Eingabe der Benutzerinformationen nötig ist.