Création de clients OPC UA avec prise en charge de la sécurité
L'une des principales caractéristiques d'OPC UA est la prise en charge de la sécurité, ce qui signifie que nous disposons d'un protocole crypté et signé, ainsi que d'un support d'authentification et d'autorisation de l'utilisateur.
Pour que cela fonctionne, chaque instance d'application (installation d'un programme) doit avoir son propre Application Instance Certificate et la clé privée correspondante.
Les applications peuvent soit générer elles-mêmes des certificats auto-signés, soit en obtenir auprès d'une autorité de certification à l'aide d'OPC UA GDS, soit être configurées avec des certificats créés manuellement par l'utilisateur.
Étant donné qu'à l'heure actuelle, Qt OPC UA ne prend pas en charge la génération de certificats ou le GDS, ce tutoriel décrit comment générer un certificat OPC UA auto-signé en ligne de commande à l'aide d'OpenSSL.
Créer un nouveau certificat d'application
Pour pouvoir générer un certificat x509v3 correct avec toutes les extensions requises pour OPC UA, nous devons d'abord configurer un fichier de configuration avec toutes les informations nécessaires.
N'oubliez pas de modifier subject et subjectAltName en fonction de votre cas.
Il est important d'insérer le ApplicationURI de l'application dans le champ URI de subjectAltName, et que le nom d'hôte de votre PC ou appareil soit inséré dans les champs DNS de subjectAltName. Vous pouvez également utiliser le champ IP si votre appareil ne prend pas en charge les noms d'hôte et que vous travaillez avec des IP statiques. Les prochaines versions de Qt OPC UA pourront générer le certificat pour vous avec les informations correctes. Pour l'instant, vous pouvez en créer un à l'aide de l'outil de ligne de commande OpenSSL.
Exemple : opcuaviewer.config
[ req ] default_bits = 2048 default_md = sha256 distinguished_name = subject req_extensions = req_ext x509_extensions = req_ext string_mask = utf8only prompt = no [ req_ext ] basicConstraints = critical, CA:FALSE keyUsage = critical, nonRepudiation, digitalSignature, keyEncipherment, dataEncipherment extendedKeyUsage = clientAuth subjectAltName = URI:urn:foo.com:The%20Qt%20Company:QtOpcUaViewer,DNS:foo.com subjectKeyIdentifier = hash authorityKeyIdentifier=keyid:always,issuer:always [ subject ] countryName = DE stateOrProvinceName = Berlin localityName = Berlin organizationName = The Qt Company commonName = QtOpcUaViewer
À l'aide de ce fichier de configuration, OpenSSL est en mesure de créer un certificat correspondant pour un usage local.
# create a self-signed certificate and private key openssl req -new -x509 -config opcuaviewer.config -newkey rsa:2048 -keyout opcuaviewer.key -nodes -outform der -out opcuaviewer.der # install the certificate and key into the application PKI directory mv opcuaviewer.der /path/to/application/pki/own/certs/opcuaviewer.der mv opcuaviewer.key /path/to/application/pki/own/private/opcuaviewer.pem # secure private key file permissions chmod 600 /path/to/application/pki/own/private/opcuaviewer.pem
Il est important de sécuriser les droits d'accès au fichier de la clé privée, afin que seule l'application UA puisse la lire. Pour les services (démons), il est recommandé de créer des comptes d'utilisateurs non privilégiés dédiés à cet effet et de faire de cet utilisateur le propriétaire de la clé. Pour les applications interactives, cette clé doit être propre à l'utilisateur. Pour les applications interactives, il est également possible de protéger la clé par un mot de passe. Dans ce cas, l'utilisateur doit introduire le mot de passe à chaque fois que l'application est lancée et qu'il charge la clé. Pour cette raison, les clés protégées par un mot de passe ne sont pas une bonne solution pour les applications non surveillées, car il faudrait alors stocker le mot de passe dans un fichier de configuration.
Vous pouvez extraire les données du certificat à l'aide d'OpenSSL pour inspecter le contenu du certificat :
openssl x509 -in opcuaviewer.der -text -noout Certificate: Data: Version: 3 (0x2) Serial Number: be:aa:41:79:8a:b0:4f:9a Signature Algorithm: sha512WithRSAEncryption Issuer: C = DE, ST = Berlin, L = Berlin, O = The Qt Company, CN = QtOpcUaViewer Validity Not Before: Nov 7 14:38:52 2018 GMT Not After : Dec 7 14:38:52 2018 GMT Subject: C = DE, ST = Berlin, L = Berlin, O = The Qt Company, CN = QtOpcUaViewer Subject Public Key Info: Public Key Algorithm: rsaEncryption Public-Key: (2048 bit) Modulus: [ skipped ] Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Basic Constraints: critical CA:FALSE X509v3 Key Usage: critical Digital Signature, Non Repudiation, Key Encipherment, Data Encipherment, Certificate Sign X509v3 Subject Alternative Name: URI:urn:foo.com:The%20Qt%20Company:QtOpcUaViewer, DNS:foo.com X509v3 Subject Key Identifier: B2:E8:5E:34:21:EA:67:CF:61:FC:14:94:18:C1:AD:13:89:83:CA:9B X509v3 Authority Key Identifier: keyid:B2:E8:5E:34:21:EA:67:CF:61:FC:14:94:18:C1:AD:13:89:83:CA:9B DirName:/C=DE/ST=Berlin/L=Berlin/O=The Qt Company/CN=QtOpcUaViewer serial:BE:AA:41:79:8A:B0:4F:9A Signature Algorithm: sha512WithRSAEncryption [ skipped ]
Configuration de l'application UA
Pour que la sécurité fonctionne avec le certificat créé à l'étape précédente, il est important de
-
Configurer
- l'identité d'application correcte
m_identity = m_pkiConfig.applicationIdentity();
- Configurer les emplacements PKI pour que le SDK puisse trouver le certificat, la clé privée, la liste de confiance, etc.
Voir, par exemple, le code de l'exemple du visualisateurQt OPC UA :
void MainWindow::setupPkiConfiguration() { const QDir pkidir =QDir(QStandardPaths::writableLocation(QStandardPaths::AppLocalDataLocation) + "/pki") ; if (!pkidir.exists() && !copyDirRecursively(":/pki", pkidir.path())) qFatal("Could not set up directory %s!", qUtf8Printable(pkidir.path())); m_pkiConfig.setCertificateFile(pkidir.absoluteFilePath("own/certs/opcuaviewer.der")) ; m_pkiConfig.setPrivateKeyFile(pkidir.absoluteFilePath("own/private/opcuaviewer.pem")) ; m_pkiConfig.setTrustListDirectory(pkidir.absoluteFilePath("trusted/certs")) ; m_pkiConfig.setRevocationListDirectory(pkidir.absoluteFilePath("trusted/crl")) ; m_pkiConfig.setIssuerListDirectory(pkidir.absoluteFilePath("issuers/certs")) ; m_pkiConfig.setIssuerRevocationListDirectory(pkidir.absoluteFilePath("issuers/crl")) ; const QStringList toCreate = { m_pkiConfig.issuerListDirectory(),m_pkiConfig.issuerRevocationListDirectory() } ; for(const QString &dir: toCreate) { if (!QDir().mkpath(dir)) qFatal("Could not create directory %s!", qUtf8Printable(dir)); } }
Dans l'exemple, nous extrayons les certificats propres et de confiance préconfigurés du système de ressources Qt Location vers un emplacement accessible en écriture dans le système de fichiers. Les autres répertoires pour les listes d'émetteurs (de révocation) sont créés manuellement.
Disposition des dossiers PKI
Qt OPC UA utilise la structure de dossier suivante :
| Dossier | Description du dossier |
|---|---|
| propre | Emplacement où sont stockés les propres certificats de l'application. |
| de confiance | Liste des certificats d'application approuvés ou des certificats d'autorité de certification approuvés. |
| émetteur | Liste de certificats d'autorités de certification qui ne sont pas approuvés mais qui sont nécessaires pour vérifier les signatures sur les certificats. |
| rejeté | L'application stocke ici les certificats rejetés, afin qu'ils puissent être approuvés ultérieurement par un administrateur. Il est important de configurer ici un nombre maximum de fichiers. Si ce nombre est atteint, le fichier le plus ancien doit être supprimé en premier. Sans limite, un attaquant pourrait remplir le disque dur de la machine avec des tentatives de connexion non valides. |
Chacun des dossiers own, trusted, et issuers contient la structure de sous-répertoire définie par le tableau suivant.
| Sous-répertoire | Description des sous-répertoires |
|---|---|
| certs | Contient les certificats X.509 v3 encodés en DER. Les fichiers doivent avoir une extension .der. |
| private | Contient les clés privées. Le format du fichier peut être spécifique au backend. Les fichiers codés en PEM doivent porter l'extension .pem. Les fichiers encodés PKCS#12 doivent porter l'extension .pfx. Le nom du fichier racine doit être le même que celui du fichier de clé publique correspondant dans le répertoire certs. Ce dossier n'existe qu'à l'intérieur du dossier own. |
| crl | Contient la CRL codée en DER pour tous les certificats d'autorité de certification trouvés dans les répertoires certs. Les fichiers doivent avoir une extension .crl. |
Première connexion
Lors de la première connexion, le client doit faire confiance au certificat du serveur.
Le client doit afficher un avertissement concernant le certificat (avec les détails du certificat) et offrir la possibilité d'enregistrer le certificat dans sa liste de confiance. Pour un exemple, voir Qt OPC UA Viewer Example.
Lorsque le client a accepté le certificat du serveur, vous pouvez essayer de vous connecter à nouveau. Il se peut alors que le serveur rejette le certificat du client. Cela est indiqué par le code d'erreur générique BadSecurityChecksFailed. Le serveur stocke normalement les certificats rejetés dans un dossier spécial rejected. L'administrateur peut les placer dans la liste de confiance pour autoriser les clients à se connecter. Cela évite de copier manuellement le certificat du client sur la machine serveur.
Dès que le serveur a fait confiance au client, vous devriez pouvoir vous connecter en toute sécurité.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.