QOpcUaKeyPair Class
QOpcUaKeyPair verwaltet Paare aus privaten und öffentlichen Schlüsseln. Mehr...
| Header: | #include <QOpcUaKeyPair> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS OpcUa) target_link_libraries(mytarget PRIVATE Qt6::OpcUa) |
| qmake: | QT += opcua |
| Erbt von: | QObject |
Öffentliche Typen
| enum class | Cipher { Aes128Cbc, Unencrypted } |
| enum class | KeyType { Rsa, Empty, Unknown } |
| enum class | RsaKeyStrength { Bits1024, Bits2048, Bits4096 } |
Öffentliche Funktionen
| QOpcUaKeyPair(QObject *parent = nullptr) | |
| virtual | ~QOpcUaKeyPair() |
| void | generateRsaKey(QOpcUaKeyPair::RsaKeyStrength strength) |
| bool | hasPrivateKey() const |
| bool | loadFromPemData(const QByteArray &data) |
| QByteArray | privateKeyToByteArray(QOpcUaKeyPair::Cipher cipher, const QString &password) const |
| QByteArray | publicKeyToByteArray() const |
| QOpcUaKeyPair::KeyType | type() const |
Signale
| void | passphraseNeeded(QString &passphrase, int maximumLength, bool writeOperation) |
Ausführliche Beschreibung
Diese Klasse ist derzeit als Technology Preview verfügbar; daher können sich die von der Klasse bereitgestellte API und die Funktionalität jederzeit ohne vorherige Ankündigung ändern.
Sie kann Schlüssel für die asymmetrische Verschlüsselung generieren, laden und speichern. Instanzen dieser Klasse müssen an Funktionen übergeben werden, die einen Schlüssel benötigen.
Dokumentation zu den Mitgliedstypen
enum class QOpcUaKeyPair::Cipher
Verschlüsselungsalgorithmen für private Schlüssel.
| Konstante | Wert | Beschreibung |
|---|---|---|
QOpcUaKeyPair::Cipher::Aes128Cbc | 0 | Verschlüsselung mit AES128 und CBC |
QOpcUaKeyPair::Cipher::Unencrypted | 1 | Der Schlüssel wird nicht verschlüsselt. |
enum class QOpcUaKeyPair::KeyType
Dieser Enum-Typ legt den Typ eines Schlüssels fest.
| Konstante | Wert | Beschreibung |
|---|---|---|
QOpcUaKeyPair::KeyType::Rsa | 0 | Ein RSA-Schlüssel |
QOpcUaKeyPair::KeyType::Empty | 1 | Es ist kein Schlüssel verfügbar. |
QOpcUaKeyPair::KeyType::Unknown | 2 | Der Schlüsseltyp wird nicht unterstützt. |
enum class QOpcUaKeyPair::RsaKeyStrength
Dieser Enum-Typ gibt die Stärke eines RSA-Schlüssels an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QOpcUaKeyPair::RsaKeyStrength::Bits1024 | 1024 | Eine Schlüsselstärke von 1024 Bit. |
QOpcUaKeyPair::RsaKeyStrength::Bits2048 | 2048 | Eine Schlüsselstärke von 2048 Bit. |
QOpcUaKeyPair::RsaKeyStrength::Bits4096 | 4096 | Eine Schlüssellänge von 4096 Bit. |
Dokumentation der Mitgliedsfunktionen
QOpcUaKeyPair::QOpcUaKeyPair(QObject *parent = nullptr)
Erstellt ein neues leeres Schlüsselpaar mit „ parent “ als übergeordnetem Objekt.
[virtual noexcept] QOpcUaKeyPair::~QOpcUaKeyPair()
Löscht das Schlüsselpaar.
void QOpcUaKeyPair::generateRsaKey(QOpcUaKeyPair::RsaKeyStrength strength)
Erzeugt ein neues asymmetrisches RSA-Schlüsselpaar.
Die Länge des Schlüssels wird durch ` strength` festgelegt.
bool QOpcUaKeyPair::hasPrivateKey() const
Gibt „ true “ zurück, wenn der aktuelle Schlüssel einen privaten Schlüssel enthält, andernfalls „ false “.
bool QOpcUaKeyPair::loadFromPemData(const QByteArray &data)
Lädt einen Schlüssel aus PEM-kodierten Daten in „ data “ . Gibt bei Erfolg „ true “ und andernfalls „ false “ zurück.
Anhand des PEM-Headers wird erkannt, ob die Daten einen privaten oder einen öffentlichen Schlüssel enthalten. Das Laden verschlüsselter Schlüssel ist möglich, indem eine Funktion an das Signal „ passphraseNeeded “ angehängt wird, um die Passphrase bereitzustellen.
[signal] void QOpcUaKeyPair::passphraseNeeded(QString &passphrase, int maximumLength, bool writeOperation)
Dieses Signal wird ausgelöst, wenn ein privater Schlüssel eine Passphrase ( passphrase ) zur Ver- oder Entschlüsselung benötigt.
writeOperation ist „ true “, wenn die Passphrase zum Exportieren eines Schlüssels benötigt wird, und „ false “, wenn die Passphrase zum Importieren eines Schlüssels benötigt wird.
maximumLength Gibt die maximale Länge der Passphrase in Byte an. Alle Zeichen in „ passphrase “, die diese Grenze überschreiten, werden ignoriert.
Falls Sie dieses Signal über Thread-Grenzen hinweg verwenden, müssen Sie es mit „ Qt::BlockingQueuedConnection “ verknüpfen.
QByteArray QOpcUaKeyPair::privateKeyToByteArray(QOpcUaKeyPair::Cipher cipher, const QString &password) const
Gibt den PEM-kodierten privaten Schlüssel zurück. Falls kein privater Schlüssel vorhanden ist, wird ein leeres Byte-Array zurückgegeben.
Die Verschlüsselung des Schlüssels muss mithilfe der Parameter „ cipher “ und „ password “ festgelegt werden. Um den Schlüssel unverschlüsselt zu speichern, muss die Verschlüsselungsmethode „ Cipher::Unencrypted “ verwendet werden.
QByteArray QOpcUaKeyPair::publicKeyToByteArray() const
Gibt den öffentlichen Schlüssel als Byte-Array zurück.
QOpcUaKeyPair::KeyType QOpcUaKeyPair::type() const
Gibt den Typ des aktuellen Schlüssels zurück.
© 2026 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.
