QOpcUaKeyPair Class
QOpcUaKeyPair gestiona pares de claves privadas y públicas. Más información...
| Encabezado: | #include <QOpcUaKeyPair> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS OpcUa) target_link_libraries(mytarget PRIVATE Qt6::OpcUa) |
| qmake: | QT += opcua |
| Heredado de: | QObject |
Tipos públicos
| enum class | Cipher { Aes128Cbc, Unencrypted } |
| enum class | KeyType { Rsa, Empty, Unknown } |
| enum class | RsaKeyStrength { Bits1024, Bits2048, Bits4096 } |
Funciones públicas
| 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 |
Señales
| void | passphraseNeeded(QString &passphrase, int maximumLength, bool writeOperation) |
Descripción detallada
Esta clase está disponible actualmente como vista previa tecnológica, por lo que la API y la funcionalidad que ofrece pueden estar sujetas a cambios en cualquier momento sin previo aviso.
Permite generar, cargar y almacenar claves para el cifrado asimétrico. Las instancias de esta clase deben pasarse a las funciones que requieran una clave.
Documentación sobre los tipos de miembros
enum class QOpcUaKeyPair::Cipher
Algoritmos de cifrado para claves privadas.
| Constante | Valor | Descripción |
|---|---|---|
QOpcUaKeyPair::Cipher::Aes128Cbc | 0 | Cifrado AES128 con CBC |
QOpcUaKeyPair::Cipher::Unencrypted | 1 | La clave no se cifrará. |
enum class QOpcUaKeyPair::KeyType
Este tipo de enumeración especifica el tipo de una clave.
| Constante | Valor | Descripción |
|---|---|---|
QOpcUaKeyPair::KeyType::Rsa | 0 | Una clave RSA |
QOpcUaKeyPair::KeyType::Empty | 1 | No hay ninguna clave disponible. |
QOpcUaKeyPair::KeyType::Unknown | 2 | No se gestiona este tipo de clave. |
enum class QOpcUaKeyPair::RsaKeyStrength
Este tipo de enumeración especifica la solidez de una clave RSA.
| Constante | Valor | Descripción |
|---|---|---|
QOpcUaKeyPair::RsaKeyStrength::Bits1024 | 1024 | Una clave de 1024 bits. |
QOpcUaKeyPair::RsaKeyStrength::Bits2048 | 2048 | Una clave con una longitud de 2048 bits. |
QOpcUaKeyPair::RsaKeyStrength::Bits4096 | 4096 | Una clave de 4096 bits. |
Documentación de las funciones de miembro
QOpcUaKeyPair::QOpcUaKeyPair(QObject *parent = nullptr)
Crea un nuevo par de claves vacío con « parent » como objeto padre.
[virtual noexcept] QOpcUaKeyPair::~QOpcUaKeyPair()
Elimina el par de claves.
void QOpcUaKeyPair::generateRsaKey(QOpcUaKeyPair::RsaKeyStrength strength)
Genera un nuevo par de claves RSA asimétricas.
La longitud de la clave se especifica mediante ` strength`.
bool QOpcUaKeyPair::hasPrivateKey() const
Devuelve « true » si la clave actual contiene una clave privada; en caso contrario, devuelve « false ».
bool QOpcUaKeyPair::loadFromPemData(const QByteArray &data)
Carga una clave a partir de datos codificados en formato PEM en data. Devuelve true si la operación se realiza correctamente y false en caso contrario.
Detecta a partir del encabezado PEM si los datos contienen una clave privada o pública. Es posible cargar claves cifradas conectando una función a la señal passphraseNeeded para proporcionar la frase de contraseña.
[signal] void QOpcUaKeyPair::passphraseNeeded(QString &passphrase, int maximumLength, bool writeOperation)
Esta señal se emite cuando una clave privada necesita una frase de contraseña ( passphrase ) para el cifrado o el descifrado.
writeOperation true cuando se necesita la frase de contraseña para exportar una clave, y cuando se necesita la frase de contraseña para importar una clave. false
maximumLength Especifica la longitud máxima en bytes de la frase de contraseña. Todos los caracteres de passphrase que superen este límite se ignorarán.
En caso de que utilices esta señal cruzando los límites de los subprocesos, debes conectarla con Qt::BlockingQueuedConnection.
QByteArray QOpcUaKeyPair::privateKeyToByteArray(QOpcUaKeyPair::Cipher cipher, const QString &password) const
Devuelve la clave privada codificada en formato PEM. En caso de que no haya clave privada, se devuelve una matriz de bytes vacía.
El cifrado de la clave debe especificarse mediante los parámetros cipher y password. Para almacenar la clave sin cifrar, debe utilizarse el cifrado Cipher::Unencrypted.
QByteArray QOpcUaKeyPair::publicKeyToByteArray() const
Devuelve la clave pública como una matriz de bytes.
QOpcUaKeyPair::KeyType QOpcUaKeyPair::type() const
Devuelve el tipo de la clave actual.
© 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.