QSslCertificate Class

Documentación de la función de miembro

[explicit] QSslCertificate::QSslCertificate(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)

Construye un QSslCertificate leyendo format datos codificados de device y usando el primer certificado encontrado. Posteriormente puede llamar a isNull() para ver si device contenía un certificado, y si este certificado se cargó correctamente.

[explicit] QSslCertificate::QSslCertificate(const QByteArray &data = QByteArray(), QSsl::EncodingFormat format = QSsl::Pem)

Construye un QSslCertificate analizando el format codificado data y utilizando el primer certificado disponible encontrado. Más tarde puede llamar a isNull() para ver si data contenía un certificado, y si este certificado se cargó correctamente.

QSslCertificate::QSslCertificate(const QSslCertificate &other)

Construye una copia idéntica de other.

[constexpr noexcept, since 6.8] QSslCertificate::QSslCertificate(QSslCertificate &&other)

Move-construye un nuevo QSslCertificate a partir de other.

Esta función se introdujo en Qt 6.8.

[noexcept] QSslCertificate::~QSslCertificate()

Destruye el QSslCertificate.

void QSslCertificate::clear()

Borra el contenido de este certificado, convirtiéndolo en un certificado nulo.

Véase también isNull().

QByteArray QSslCertificate::digest(QCryptographicHash::Algorithm algorithm = QCryptographicHash::Md5) const

Devuelve un resumen criptográfico de este certificado. Por defecto, se generará un compendio MD5, pero también puede especificar un algorithm personalizado.

QDateTime QSslCertificate::effectiveDate() const

Devuelve la fecha-hora en que el certificado pasa a ser válido, o un QDateTime vacío si se trata de un certificado nulo.

Véase también expiryDate().

QDateTime QSslCertificate::expiryDate() const

Devuelve la fecha-hora en que caduca el certificado, o un QDateTime vacío si se trata de un certificado nulo.

Véase también effectiveDate().

QList<QSslCertificateExtension> QSslCertificate::extensions() const

Devuelve una lista con las extensiones X509 de este certificado.

[static] QList<QSslCertificate> QSslCertificate::fromData(const QByteArray &data, QSsl::EncodingFormat format = QSsl::Pem)

Busca y analiza todos los certificados en data que están codificados en el format especificado y los devuelve en una lista de certificados.

Véase también fromDevice().

[static] QList<QSslCertificate> QSslCertificate::fromDevice(QIODevice *device, QSsl::EncodingFormat format = QSsl::Pem)

Busca y analiza todos los certificados en device que están codificados en el format especificado y los devuelve en una lista de certificados.

Véase también fromData().

[static, since 6.10] QList<QSslCertificate> QSslCertificate::fromFile(const QString &filePath, QSsl::EncodingFormat format = QSsl::Pem)

Lee los datos del archivo filePath y analiza todos los certificados que están codificados en el format especificado y devuelve una lista de objetos QSslCertificate.

Si filePath no es un archivo normal, este método devolverá una lista vacía.

Esta función se introdujo en Qt 6.10.

Véase también fromData() y fromPath().

[static] QList<QSslCertificate> QSslCertificate::fromPath(const QString &path, QSsl::EncodingFormat format = QSsl::Pem, QSslCertificate::PatternSyntax syntax = PatternSyntax::FixedString)

Busca en todos los archivos de path certificados codificados en el formato especificado format y los devuelve en una lista. path debe ser un archivo o un patrón que coincida con uno o más archivos, tal como se especifica en syntax.

Ejemplo:

const auto certs = QSslCertificate::fromPath("C:/ssl/certificado.*.pem", QSsl::Pem, QSslCertificate::Wildcard);for(const QSslCertificate &cert: certs) {    qDebug() << cert.issuerInfo(QSslCertificate::Organization);
}

Véase también fromData().

Qt::HANDLE QSslCertificate::handle() const

Devuelve un puntero al manejador nativo del certificado, si existe, en caso contrario nullptr.

Puede utilizar este manejador, junto con la API nativa, para acceder a información ampliada sobre el certificado.

[static] bool QSslCertificate::importPkcs12(QIODevice *device, QSslKey *key, QSslCertificate *certificate, QList<QSslCertificate> *caCertificates = nullptr, const QByteArray &passPhrase = QByteArray())

Importa un archivo PKCS#12 (pfx) de la dirección device especificada. Un archivo PKCS#12 es un paquete que puede contener varios certificados y claves. Este método lee un único key, su certificate y cualquier caCertificates asociado del paquete. Si se especifica passPhrase, se utilizará para descifrar el paquete. Devuelve true si el archivo PKCS#12 se ha cargado correctamente.

bool QSslCertificate::isBlacklisted() const

Devuelve true si este certificado está en la lista negra; en caso contrario devuelve false.

Véase también isNull().

bool QSslCertificate::isNull() const

Devuelve true si se trata de un certificado nulo (es decir, un certificado sin contenido); en caso contrario, devuelve false.

Por defecto, QSslCertificate construye un certificado nulo.

Véase también clear().

bool QSslCertificate::isSelfSigned() const

Devuelve true si este certificado está autofirmado; en caso contrario, devuelve false.

Un certificado se considera autofirmado si el emisor y el asunto son idénticos.

QString QSslCertificate::issuerDisplayName() const

Devuelve un nombre que describe al emisor. Devuelve el QSslCertificate::CommonName si está disponible, de lo contrario vuelve al primer QSslCertificate::Organization o al primer QSslCertificate::OrganizationalUnitName.

Véase también issuerInfo().

QStringList QSslCertificate::issuerInfo(QSslCertificate::SubjectInfo subject) const

Devuelve la información del emisor para subject del certificado, o una lista vacía si no hay información para subject en el certificado. Puede haber más de una entrada de cada tipo.

Véase también subjectInfo().

QStringList QSslCertificate::issuerInfo(const QByteArray &attribute) const

Devuelve la información del emisor para attribute del certificado, o una lista vacía si no hay información para attribute en el certificado. Puede haber más de una entrada para un atributo.

Véase también subjectInfo().

QList<QByteArray> QSslCertificate::issuerInfoAttributes() const

Devuelve una lista de los atributos que tienen valores en la información del emisor de este certificado. Se puede acceder a la información asociada a un atributo determinado mediante el método issuerInfo(). Tenga en cuenta que esta lista puede incluir los OID de cualquier elemento que no conozca el backend SSL.

Véase también subjectInfo().

QSslKey QSslCertificate::publicKey() const

Devuelve la clave pública del sujeto del certificado.

QByteArray QSslCertificate::serialNumber() const

Devuelve la cadena del número de serie del certificado en formato hexadecimal.

QMultiMap<QSsl::AlternativeNameEntryType, QString> QSslCertificate::subjectAlternativeNames() const

Devuelve la lista de nombres de asunto alternativos para este certificado. Los nombres alternativos suelen contener nombres de host, opcionalmente con comodines, que son válidos para este certificado.

Estos nombres se comprueban con el nombre de host del homólogo conectado si la información de asunto de CommonName no define un nombre de host válido o si el nombre de información de asunto no coincide con el nombre de host del homólogo.

Véase también subjectInfo().

QString QSslCertificate::subjectDisplayName() const

Devuelve un nombre que describe el tema. Devuelve el QSslCertificate::CommonName si está disponible, de lo contrario vuelve al primer QSslCertificate::Organization o al primer QSslCertificate::OrganizationalUnitName.

Véase también subjectInfo().

QStringList QSslCertificate::subjectInfo(QSslCertificate::SubjectInfo subject) const

Devuelve la información para subject, o una lista vacía si no hay información para subject en el certificado. Puede haber más de una entrada de cada tipo.

Véase también issuerInfo().

QStringList QSslCertificate::subjectInfo(const QByteArray &attribute) const

Devuelve la información de asunto para attribute, o una lista vacía si no hay información para attribute en el certificado. Puede haber más de una entrada para un atributo.

Véase también issuerInfo().

QList<QByteArray> QSslCertificate::subjectInfoAttributes() const

Devuelve una lista de los atributos que tienen valores en la información de asunto de este certificado. Se puede acceder a la información asociada a un atributo determinado mediante el método subjectInfo(). Tenga en cuenta que esta lista puede incluir los OID de cualquier elemento que no conozca el backend SSL.

Véase también subjectInfo().

[noexcept] void QSslCertificate::swap(QSslCertificate &other)

Intercambia esta instancia de certificado con other. Esta operación es muy rápida y nunca falla.

QByteArray QSslCertificate::toDer() const

Devuelve este certificado convertido a una representación codificada en DER (binario).

QByteArray QSslCertificate::toPem() const

Devuelve este certificado convertido a una representación codificada PEM (Base64).

QString QSslCertificate::toText() const

Devuelve este certificado convertido a una representación de texto legible por humanos.

[static] QList<QSslError> QSslCertificate::verify(const QList<QSslCertificate> &certificateChain, const QString &hostName = QString())

Verifica una cadena de certificados. La cadena a verificar se pasa en el parámetro certificateChain. El primer certificado de la lista debe ser el certificado hoja de la cadena que se va a verificar. Si se especifica hostName, también se comprueba si el certificado es válido para el nombre de host especificado.

Tenga en cuenta que el certificado raíz (CA) no debe incluirse en la lista a verificar, éste se buscará automáticamente utilizando la lista de CA especificada en la dirección por defecto QSslConfiguration, y, además, si es posible, los certificados CA cargados bajo demanda en Unix y Windows.

QByteArray QSslCertificate::version() const

Devuelve la cadena de versión del certificado.

bool QSslCertificate::operator!=(const QSslCertificate &other) const

Devuelve true si este certificado no es el mismo que other; en caso contrario devuelve false.

QSslCertificate &QSslCertificate::operator=(const QSslCertificate &other)

Copia el contenido de other en este certificado, haciendo que los dos certificados sean idénticos.

bool QSslCertificate::operator==(const QSslCertificate &other) const

Devuelve true si este certificado es el mismo que other; en caso contrario devuelve false.