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 :

DossierDescription du dossier
propreEmplacement où sont stockés les propres certificats de l'application.
de confianceListe des certificats d'application approuvés ou des certificats d'autorité de certification approuvés.
émetteurListe 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épertoireDescription des sous-répertoires
certsContient les certificats X.509 v3 encodés en DER. Les fichiers doivent avoir une extension .der.
privateContient 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.
crlContient 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.