Les extraits de code sur cette page nécessitent les importations suivantes si vous êtes en dehors de la console pyqgis :

 1from qgis.core import (
 2  QgsApplication,
 3  QgsRasterLayer,
 4  QgsAuthMethodConfig,
 5  QgsDataSourceUri,
 6  QgsPkiBundle,
 7  QgsMessageLog,
 8)
 9
10from qgis.gui import (
11    QgsAuthAuthoritiesEditor,
12    QgsAuthConfigEditor,
13    QgsAuthConfigSelect,
14    QgsAuthSettingsWidget,
15)
16
17from qgis.PyQt.QtWidgets import (
18    QWidget,
19    QTabWidget,
20)
21
22from qgis.PyQt.QtNetwork import QSslCertificate

14. Infrastructure d’authentification

14.1. Introduction

Les infrastructures d’authentification de la référence utilisatieur peuvent être lu dans le manuel d’utilisateur le paragraphe Aperçu du Système d’authentification .

Ce chapitre décrit les les bonnes pratiques de développement pour l’utilisation du système d’authentification.

Dans QGIS Desktop, le système d’authentification est régulièrement utilisé par les fournisseurs de données lorsqu’une accréditation est nécessaire pour l’acquisition de certaines ressources, par exemple, lorsqu’une couche nécessite une connexion à une base Postgres.

Il existe aussi quelques widgets de la bibliothèque graphique de QGIS que les développeur de plugin peuvent utiliser pour intégrer facilement le système d’authentification dans leur code :

Les tests dans le code source sont un bon exemple d’infrastructure d’authentification.

Avertissement

Du fait de contraintes de sécurité ayant conduit au design de l’infrastructure d’authentification, seules quelques méthodes internes sont exposées en Python.

14.2. Glossaire

Voici quelques définitions des principaux éléments étudiés dans ce chapitre.

Mot de passe principal

Mot de passe permettant l’accès et le décryptage des informations stockées dans la base de données d’authentification de QGIS.

Base de données d’authentification

Une base de donnée sqlite qgis-auth.db cryptée des Mot de passe principal où les Configurations d’authentification sont stockées. Par exemple vos noms d’utilisateur et mots de passe, vos certificats et clés personnelles et plus généralement toutes vos méthodes d’authentification

Base de données d’authentification

Base de données d’authentification

Configuration de l’authentification

Un ensemble de données d’authentification dépendant de la Méthode d’authentification. Par exemple, une méthode basique d’authentification enregistre le couple Nom d’utilisateur / Mot de passe.

Configuration de l’authentification

Configuration de l’authentification

Méthode d’authentification

Une méthode pour s’authentifier. Chaque méthode a son propre protocole utilisé pour accorder le statut “authentifié”. Chaque méthode est mise à disposition comme une librairie chargée dynamiquement pendant la phase d’initialisation de l’infrastructure d’authentification de QGIS.

14.3. QgsAuthManager le point d’entrée

Le singleton QgsAuthManager est le point d’entrée pour utiliser les informations d’identification stockées dans la base de données QGIS cryptée Authentication DB, c’est-à-dire le fichier qgis-auth.db sous le dossier actif user profile.

Cette classe s’occupe de l’interaction avec l’utilisateur : en lui demandant de définir un mot de passe maître ou en l’utilisant de manière transparente pour accéder à des informations stockées cryptées.

14.3.1. Initier le gestionnaire et définir le mot de passe principal

L’extrait suivant donne un exemple de définition d’un mot de passe principal pour ouvrir l’accès aux paramètres d’authentification. Les commentaires du code sont importants pour comprendre l’extrait.

 1authMgr = QgsApplication.authManager()
 2
 3# check if QgsAuthManager has already been initialized... a side effect
 4# of the QgsAuthManager.init() is that AuthDbPath is set.
 5# QgsAuthManager.init() is executed during QGIS application init and hence
 6# you do not normally need to call it directly.
 7if authMgr.authenticationDatabasePath():
 8    # already initialized => we are inside a QGIS app.
 9    if authMgr.masterPasswordIsSet():
10        msg = 'Authentication master password not recognized'
11        assert authMgr.masterPasswordSame("your master password"), msg
12    else:
13        msg = 'Master password could not be set'
14        # The verify parameter checks if the hash of the password was
15        # already saved in the authentication db
16        assert authMgr.setMasterPassword("your master password",
17                                          verify=True), msg
18else:
19    # outside qgis, e.g. in a testing environment => setup env var before
20    # db init
21    os.environ['QGIS_AUTH_DB_DIR_PATH'] = "/path/where/located/qgis-auth.db"
22    msg = 'Master password could not be set'
23    assert authMgr.setMasterPassword("your master password", True), msg
24    authMgr.init("/path/where/located/qgis-auth.db")

14.3.2. Remplir authdb avec une nouvelle entrée de configuration d’authentification

Tout justificatif stocké est une instance Authentication Configuration de la classe QgsAuthMethodConfig à laquelle on accède en utilisant une chaîne unique comme la suivante: :

authcfg = 'fm1s770'

cette chaîne est générée automatiquement lors de la création d’une entrée en utilisant l’API ou l’interface graphique QGIS, mais il peut être utile de la définir manuellement à une valeur connue dans le cas où la configuration doit être partagée (avec des identifiants différents) entre plusieurs utilisateurs au sein d’une organisation.

QgsAuthMethodConfig est la classe de base pour toute Méthode d’authentification. Toute méthode d’authentification définit une table de hachage de configuration où les informations d’authentification seront stockées. Ci-après, un extrait utile pour stocker les informations d’identification de type PKI-path pour une hypothétique utilisatrice nommée alice :

 1authMgr = QgsApplication.authManager()
 2# set alice PKI data
 3config = QgsAuthMethodConfig()
 4config.setName("alice")
 5config.setMethod("PKI-Paths")
 6config.setUri("https://example.com")
 7config.setConfig("certpath", "path/to/alice-cert.pem" )
 8config.setConfig("keypath", "path/to/alice-key.pem" )
 9# check if method parameters are correctly set
10assert config.isValid()
11
12# register alice data in authdb returning the ``authcfg`` of the stored
13# configuration
14authMgr.storeAuthenticationConfig(config)
15newAuthCfgId = config.id()
16assert newAuthCfgId

14.3.2.1. Méthodes d’authentification disponibles

Les bibliothèques de Méthode d’authentification sont chargées dynamiquement pendant l’initialisation du gestionnaire d’authentification. Les méthodes d’authentification disponibles sont :

  1. Basique: authentification avec utilisateur et mot de passe

  2. Esri-Token: authentification basée sur le jeton ESRI

  3. Identity-Cert: authentification par certificat d’identité

  4. OAuth2: authentification OAuth2

  5. PKI-Paths PKI paths authentication

  6. PKI-PKCS#12 PKI PKCS#12 authentication

14.3.2.2. Populate Authorities

1authMgr = QgsApplication.authManager()
2# add authorities
3cacerts = QSslCertificate.fromPath( "/path/to/ca_chains.pem" )
4assert cacerts is not None
5# store CA
6authMgr.storeCertAuthorities(cacerts)
7# and rebuild CA caches
8authMgr.rebuildCaCertsCache()
9authMgr.rebuildTrustedCaCertsCache()

14.3.2.3. Manage PKI bundles with QgsPkiBundle

La classe QgsPkiBundle est une classe de commodité permettant d’emballer des paquets d’ICP composés sur la chaîne SslCert, SslKey et CA. Ci-après, un extrait pour obtenir la protection par mot de passe :

1# add alice cert in case of key with pwd
2caBundlesList = []  # List of CA bundles
3bundle = QgsPkiBundle.fromPemPaths( "/path/to/alice-cert.pem",
4                                     "/path/to/alice-key_w-pass.pem",
5                                     "unlock_pwd",
6                                     caBundlesList )
7assert bundle is not None
8# You can check bundle validity by calling:
9# bundle.isValid()

Référez-vous à la documentation de la classe QgsPkiBundle pour extraire les cert/clés/CA du bundle.

14.3.3. Supprimer une entrée de l’authdb

Nous pouvons supprimer une entrée de Base de données d’Authentification en utilisant son identifiant authcfg avec le code suivant :

authMgr = QgsApplication.authManager()
authMgr.removeAuthenticationConfig( "authCfg_Id_to_remove" )

14.3.4. Laissez l’extension authcfg à QgsAuthManager

La meilleure façon d’utiliser un Authentication Config stocké dans la Basse de données d’Authentication est de le référencer avec l’identifiant unique authcfg. L’expansion, signifie le convertir d’un identifiant en un ensemble complet de justificatifs d’identité. La meilleure façon d’utiliser la Configuration d’authentification stockée est de la laisser gérée automatiquement par le gestionnaire d’authentification. L’utilisation courante d’une configuration stockée est de se connecter à un service d’authentification comme un WMS ou un WFS ou à une base de données.

Note

Tenez compte du fait que tous les fournisseurs de données QGIS ne sont pas intégrés à l’infrastructure d’authentification. Chaque méthode d’authentification, dérivée de la classe de base QgsAuthMethod prend en charge un ensemble différent de fournisseurs. Par exemple, la méthode certIdentity() prend en charge la liste de fournisseurs suivante :

authM = QgsApplication.authManager()
print(authM.authMethod("Identity-Cert").supportedDataProviders())

Exemple de sortie :

['ows', 'wfs', 'wcs', 'wms', 'postgres']

Par exemple, pour accéder à un service WMS en utilisant des informations d’identification stockées identifiées par authcfg = 'fm1s770', il suffit d’utiliser authcfg dans l’URL de la source de données comme dans l’extrait suivant :

 1authCfg = 'fm1s770'
 2quri = QgsDataSourceUri()
 3quri.setParam("layers", 'usa:states')
 4quri.setParam("styles", '')
 5quri.setParam("format", 'image/png')
 6quri.setParam("crs", 'EPSG:4326')
 7quri.setParam("dpiMode", '7')
 8quri.setParam("featureCount", '10')
 9quri.setParam("authcfg", authCfg)   # <---- here my authCfg url parameter
10quri.setParam("contextualWMSLegend", '0')
11quri.setParam("url", 'https://my_auth_enabled_server_ip/wms')
12rlayer = QgsRasterLayer(str(quri.encodedUri(), "utf-8"), 'states', 'wms')

En majuscules, le provider wms prendra soin d’étendre le paramètre URI authcfg avec l’identifiant juste avant d’établir la connexion HTTP.

Avertissement

Le développeur devra laisser l’extension authcfg à la QgsAuthManager, de cette façon il sera sûr que l’extension ne sera pas faite trop tôt.

Habituellement, une chaîne URI, construite en utilisant la classe QgsDataSourceURI, est utilisée pour définir une source de données de la manière suivante :

authCfg = 'fm1s770'
quri = QgsDataSourceUri("my WMS uri here")
quri.setParam("authcfg", authCfg)
rlayer = QgsRasterLayer( quri.uri(False), 'states', 'wms')

Note

Le paramètre False est important pour éviter l’expansion complète de l’URI de l’id authcfg présent dans l’URI.

14.3.4.1. Exemples PKI avec d’autres fournisseurs de données

Un autre exemple peut être lu directement dans les tests QGIS en amont comme dans test_authmanager_pki_ows ou test_authmanager_pki_postgres.

14.4. Adapter les plugins pour utiliser l’infrastructure d’authentification

De nombreux plugins tiers utilisent httplib2 ou d’autres bibliothèques réseau Python pour gérer les connexions HTTP au lieu de s’intégrer avec QgsNetworkAccessManager et l’intégration de l’infrastructure d’authentification correspondante.

Pour faciliter cette intégration, une fonction d’aide Python a été créée, appelée « NetworkAccessManager ». Son code se trouve ici.

Cette classe d’aide peut être utilisée comme dans l’extrait suivant :

1http = NetworkAccessManager(authid="my_authCfg", exception_class=My_FailedRequestError)
2try:
3  response, content = http.request( "my_rest_url" )
4except My_FailedRequestError, e:
5  # Handle exception
6  pass

14.5. Interfaces d’authentification

Ce paragraphe liste les fenêtres utiles à l’intégration d’une infrastructure d’authentification dans des interfaces personnalisées.

14.5.1. Fenêtre de sélection des identifiants

S’il est nécessaire de sélectionner une configuration d’authentification à partir du jeu stocké dans la Base de données d’authentification, il est disponible dans la classe d’interface QgsAuthConfigSelect.

../../_images/QgsAuthConfigSelect.png

et peut être utilisé comme dans l’extrait suivant :

1# create the instance of the QgsAuthConfigSelect GUI hierarchically linked to
2# the widget referred with `parent`
3parent = QWidget()  # Your GUI parent widget
4gui = QgsAuthConfigSelect( parent, "postgres" )
5# add the above created gui in a new tab of the interface where the
6# GUI has to be integrated
7tabGui = QTabWidget()
8tabGui.insertTab( 1, gui, "Configurations" )

L’exemple ci-dessus est tiré du code source de QGIS. Le deuxième paramètre du constructeur de l’interface graphique se réfère au type de fournisseur de données. Ce paramètre est utilisé pour restreindre la compatibilité de la Méthode d’authentification avec le fournisseur spécifié.

14.5.2. Authentication Editor GUI

L’interface graphique complète utilisée pour gérer les références, les autorités et pour accéder aux utilitaires d’authentification est gérée par la classe QgsAuthEditorWidgets.

../../_images/QgsAuthEditorWidgets.png

et peut être utilisé comme dans l’extrait suivant :

1# create the instance of the QgsAuthEditorWidgets GUI hierarchically linked to
2# the widget referred with `parent`
3parent = QWidget()  # Your GUI parent widget
4gui = QgsAuthConfigSelect( parent )
5gui.show()

Un exemple intégré peut être trouvé dans le fichier test.

14.5.3. Authorities Editor GUI

Une interface graphique utilisée pour gérer uniquement les autorités est gérée par la classe QgsAuthAuthoritiesEditor.

../../_images/QgsAuthAuthoritiesEditor.png

et peut être utilisé comme dans l’extrait suivant :

1# create the instance of the QgsAuthAuthoritiesEditor GUI hierarchically
2#  linked to the widget referred with `parent`
3parent = QWidget()  # Your GUI parent widget
4gui = QgsAuthAuthoritiesEditor( parent )
5gui.show()