En esta página

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.

ConstanteValorDescripción
QOpcUaKeyPair::Cipher::Aes128Cbc0Cifrado AES128 con CBC
QOpcUaKeyPair::Cipher::Unencrypted1La clave no se cifrará.

enum class QOpcUaKeyPair::KeyType

Este tipo de enumeración especifica el tipo de una clave.

ConstanteValorDescripción
QOpcUaKeyPair::KeyType::Rsa0Una clave RSA
QOpcUaKeyPair::KeyType::Empty1No hay ninguna clave disponible.
QOpcUaKeyPair::KeyType::Unknown2No se gestiona este tipo de clave.

enum class QOpcUaKeyPair::RsaKeyStrength

Este tipo de enumeración especifica la solidez de una clave RSA.

ConstanteValorDescripción
QOpcUaKeyPair::RsaKeyStrength::Bits10241024Una clave de 1024 bits.
QOpcUaKeyPair::RsaKeyStrength::Bits20482048Una clave con una longitud de 2048 bits.
QOpcUaKeyPair::RsaKeyStrength::Bits40964096Una 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.