QOpcUaKeyPair Class
QOpcUaKeyPair behandelt private und öffentliche Schlüsselpaare. Mehr...
| Kopfzeile: | #include <QOpcUaKeyPair> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS OpcUa)target_link_libraries(mytarget PRIVATE Qt6::OpcUa) |
| qmake: | QT += opcua |
| Vererbt: | 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) |
Detaillierte Beschreibung
Diese Klasse ist derzeit als Technologievorschau verfügbar. Daher können die API und die von der Klasse bereitgestellten Funktionen jederzeit ohne vorherige Ankündigung geändert werden.
Sie kann Schlüssel für asymmetrische Verschlüsselung erzeugen, laden und speichern. Instanzen dieser Klasse müssen an Funktionen übergeben werden, die einen Schlüssel benötigen.
Dokumentation der Mitgliedstypen
enum class QOpcUaKeyPair::Cipher
Chiffren für die Verschlüsselung von privaten Schlüsseln.
| Konstante | Wert | Beschreibung |
|---|---|---|
QOpcUaKeyPair::Cipher::Aes128Cbc | 0 | Verschlüsselung AES128 mit CBC |
QOpcUaKeyPair::Cipher::Unencrypted | 1 | Der Schlüssel wird nicht verschlüsselt. |
enum class QOpcUaKeyPair::KeyType
Dieser Enum-Typ gibt den Typ eines Schlüssels an.
| 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 Typ des Schlüssels wird nicht behandelt. |
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üsselstärke von 4096 Bits. |
Dokumentation der Mitgliedsfunktionen
QOpcUaKeyPair::QOpcUaKeyPair(QObject *parent = nullptr)
Erzeugt ein neues leeres Schlüsselpaar mit parent als übergeordnetem Objekt.
[virtual noexcept] QOpcUaKeyPair::~QOpcUaKeyPair()
Zerstört 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.
Sie erkennt anhand des PEM-Headers, ob die Daten einen privaten oder öffentlichen Schlüssel enthalten. Das Laden von verschlüsselten Schlüsseln ist möglich, indem eine Funktion mit dem Signal passphraseNeeded zur Bereitstellung der Passphrase verbunden wird.
[signal] void QOpcUaKeyPair::passphraseNeeded(QString &passphrase, int maximumLength, bool writeOperation)
Dieses Signal wird ausgegeben, wenn ein privater Schlüssel eine passphrase für die Verschlüsselung oder Entschlüsselung benötigt.
writeOperation ist true, wenn die Passphrase zum Exportieren eines Schlüssels benötigt wird, und ist false, wenn die Passphrase zum Importieren eines Schlüssels benötigt wird.
maximumLength gibt die maximale Länge in Bytes für die Passphrase an. Alle Zeichen in passphrase, die diese Grenze überschreiten, werden ignoriert.
Falls Sie dieses Signal über Threadgrenzen hinweg verwenden, müssen Sie es mit Qt::BlockingQueuedConnection verbinden.
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 mit den Parametern cipher und password angegeben werden. Um den Schlüssel unverschlüsselt zu speichern, muss die Chiffre 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.
© 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.
