En esta página

QOpcUaX509CertificateSigningRequest Class

QOpcUaX509CertificateSigningRequest: crear una solicitud de firma de certificado. Más...

Encabezado: #include <QOpcUaX509CertificateSigningRequest>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpcUa)
target_link_libraries(mytarget PRIVATE Qt6::OpcUa)
qmake: QT += opcua

Tipos públicos

enum class Encoding { PEM, DER }
enum class MessageDigest { SHA256 }

Funciones públicas

QOpcUaX509CertificateSigningRequest()
~QOpcUaX509CertificateSigningRequest()
void addExtension(QOpcUaX509Extension *extension)
QByteArray createRequest(const QOpcUaKeyPair &privateKey)
QByteArray createSelfSignedCertificate(const QOpcUaKeyPair &privateKey, int validityInDays = 365)
QOpcUaX509CertificateSigningRequest::Encoding encoding() const
QOpcUaX509CertificateSigningRequest::MessageDigest messageDigest() const
void setEncoding(QOpcUaX509CertificateSigningRequest::Encoding encoding)
void setMessageDigest(QOpcUaX509CertificateSigningRequest::MessageDigest digest)
void setSubject(const QOpcUaX509DistinguishedName &subject)
const QOpcUaX509DistinguishedName &subject() const

Descripción detallada

Esta clase está disponible actualmente como «Technology Preview» (vista previa tecnológica) y, por lo tanto, la API y la funcionalidad que ofrece la clase pueden estar sujetas a cambios en cualquier momento sin previo aviso.

Antes de crear los datos de la solicitud de autenticación, es necesario añadir cualquier extensión necesaria para esa solicitud específica. Las extensiones compatibles actualmente son SubjectAlternativeName, BasicConstrains, KeyUsage y ExtendedKeyUsage.

// Generate key
QOpcUaKeyPair key;
key.generateRsaKey(QOpcUaKeyPair::RsaKeyStrength::Bits1024);

QOpcUaX509CertificateSigningRequest csr;

QOpcUaX509DistinguishedName dn;
dn.setEntry(QOpcUaX509DistinguishedName::Type::CommonName, "QtOpcUaViewer");
dn.setEntry(QOpcUaX509DistinguishedName::Type::CountryName, "DE");
dn.setEntry(QOpcUaX509DistinguishedName::Type::LocalityName, "Berlin");
dn.setEntry(QOpcUaX509DistinguishedName::Type::StateOrProvinceName, "Berlin");
dn.setEntry(QOpcUaX509DistinguishedName::Type::OrganizationName, "The Qt Company");
csr.setSubject(dn);

QOpcUaX509ExtensionSubjectAlternativeName *san = new QOpcUaX509ExtensionSubjectAlternativeName;
san->addData(QOpcUaX509ExtensionSubjectAlternativeName::Type::DNS, "foo.com");
san->addData(QOpcUaX509ExtensionSubjectAlternativeName::Type::DNS, "foo.com");
san->addData(QOpcUaX509ExtensionSubjectAlternativeName::Type::URI, "urn:foo.com:The%20Qt%20Company:QtOpcUaViewer");
san->setCritical(true);
csr.addExtension(san);

QOpcUaX509ExtensionBasicConstraints *bc = new QOpcUaX509ExtensionBasicConstraints;
bc->setCa(false);
bc->setCritical(true);
csr.addExtension(bc);

QOpcUaX509ExtensionKeyUsage *ku = new QOpcUaX509ExtensionKeyUsage;
ku->setCritical(true);
ku->setKeyUsage(QOpcUaX509ExtensionKeyUsage::KeyUsage::DigitalSignature);
ku->setKeyUsage(QOpcUaX509ExtensionKeyUsage::KeyUsage::NonRepudiation);
ku->setKeyUsage(QOpcUaX509ExtensionKeyUsage::KeyUsage::KeyEncipherment);
ku->setKeyUsage(QOpcUaX509ExtensionKeyUsage::KeyUsage::DataEncipherment);
ku->setKeyUsage(QOpcUaX509ExtensionKeyUsage::KeyUsage::CertificateSigning);
csr.addExtension(ku);

QOpcUaX509ExtensionExtendedKeyUsage *eku = new QOpcUaX509ExtensionExtendedKeyUsage;
eku->setCritical(true);
eku->setKeyUsage(QOpcUaX509ExtensionExtendedKeyUsage::KeyUsage::EmailProtection);
csr.addExtension(eku);

QByteArray csrData = csr.createRequest(key);

Véase también QOpcUaX509ExtensionSubjectAlternativeName, QOpcUaX509ExtensionBasicConstraints y QOpcUaX509ExtensionKeyUsage.

Documentación sobre los tipos de miembro

enum class QOpcUaX509CertificateSigningRequest::Encoding

Este tipo de enumeración especifica la codificación de la solicitud de firma del certificado generado.

ConstanteValorDescripción
QOpcUaX509CertificateSigningRequest::Encoding::PEM0Utilizando la codificación PEM
QOpcUaX509CertificateSigningRequest::Encoding::DER1Utilización de la codificación DER

enum class QOpcUaX509CertificateSigningRequest::MessageDigest

Este tipo de enumeración especifica el resumen del mensaje que se va a utilizar.

ConstanteValorDescripción
QOpcUaX509CertificateSigningRequest::MessageDigest::SHA2560Uso del resumen de mensaje SHA256

Documentación de las funciones de miembro

QOpcUaX509CertificateSigningRequest::QOpcUaX509CertificateSigningRequest()

Crea una solicitud de firma de certificado vacía.

[noexcept] QOpcUaX509CertificateSigningRequest::~QOpcUaX509CertificateSigningRequest()

Elimina la solicitud y libera todas las extensiones.

void QOpcUaX509CertificateSigningRequest::addExtension(QOpcUaX509Extension *extension)

Añade una extensión de certificado a la solicitud.

La propiedad del objeto ` extension ` se transferirá a esta clase.

Véase también QOpcUaX509ExtensionSubjectAlternativeName, QOpcUaX509ExtensionBasicConstraints y QOpcUaX509ExtensionKeyUsage.

QByteArray QOpcUaX509CertificateSigningRequest::createRequest(const QOpcUaKeyPair &privateKey)

Crea una solicitud de firma de certificado para enviarla a una CA (autoridad de certificación) para su firma. La clave privada de privateKey se utiliza para firmar la solicitud. Los datos de la solicitud se devuelven como una matriz de bytes con la codificación establecida por setEncoding().

QByteArray QOpcUaX509CertificateSigningRequest::createSelfSignedCertificate(const QOpcUaKeyPair &privateKey, int validityInDays = 365)

Crea un certificado autofirmado a partir de esta solicitud para su uso inmediato. La clave privada de privateKey se utiliza para firmar la solicitud. Se puede especificar una validez en días en validityInDays. Los datos de la solicitud se devuelven como una matriz de bytes con la codificación establecida por setEncoding().

QOpcUaX509CertificateSigningRequest::Encoding QOpcUaX509CertificateSigningRequest::encoding() const

Devuelve la codificación utilizada en la solicitud.

Véase también setEncoding().

QOpcUaX509CertificateSigningRequest::MessageDigest QOpcUaX509CertificateSigningRequest::messageDigest() const

Devuelve el resumen del mensaje utilizado.

Véase también setMessageDigest().

void QOpcUaX509CertificateSigningRequest::setEncoding(QOpcUaX509CertificateSigningRequest::Encoding encoding)

Establece la codificación de la solicitud utilizada en « encoding ». La codificación predeterminada de la solicitud es PEM.

Véase también encoding().

void QOpcUaX509CertificateSigningRequest::setMessageDigest(QOpcUaX509CertificateSigningRequest::MessageDigest digest)

Establece el resumen de mensaje utilizado en digest. El resumen de mensaje predeterminado es SHA256.

Véase también messageDigest().

void QOpcUaX509CertificateSigningRequest::setSubject(const QOpcUaX509DistinguishedName &subject)

Establece el « subject » para esta solicitud. Sin un «subject», no es posible generar la solicitud.

Véase también subject().

const QOpcUaX509DistinguishedName &QOpcUaX509CertificateSigningRequest::subject() const

Devuelve el objeto de esta solicitud.

Véase también setSubject().

© 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.