qgsauthcertutils.h

Go to the documentation of this file.

/***************************************************************************
    qgsauthcertutils.h
    ---------------------
    begin                : May 1, 2015
    copyright            : (C) 2015 by Boundless Spatial, Inc. USA
    author               : Larry Shaffer
    email                : lshaffer at boundlessgeo dot com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
 
#ifndef QGSAUTHCERTUTILS_H
#define QGSAUTHCERTUTILS_H
 
#include "qgsconfig.h"
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgsauthconfig.h"
 
#include <QFile>
#include <QSslCertificate>
#include <QSslError>
 
#ifdef HAVE_AUTH
#include <QtCrypto>
#endif
 
class QgsAuthConfigSslServer;
 
#define SSL_ISSUER_INFO( var, prop ) var.issuerInfo( prop ).value(0)
 
#define SSL_SUBJECT_INFO( var, prop ) var.subjectInfo( prop ).value(0)

class CORE_EXPORT QgsAuthCertUtils
{
  public:
    enum CaCertSource
    {
      SystemRoot = 0,
      FromFile = 1,
      InDatabase = 2,
      Connection = 3
    };

    enum CertTrustPolicy
    {
      DefaultTrust = 0,
      Trusted = 1,
      Untrusted = 2,
      NoPolicy = 3
    };

    enum CertUsageType
    {
      UndeterminedUsage = 0,
      AnyOrUnspecifiedUsage,
      CertAuthorityUsage,
      CertIssuerUsage,
      TlsServerUsage,
      TlsServerEvUsage,
      TlsClientUsage,
      CodeSigningUsage,
      EmailProtectionUsage,
      TimeStampingUsage,
      CRLSigningUsage
    };

    enum ConstraintGroup
    {
      KeyUsage = 0,
      ExtendedKeyUsage = 1
    };
 
#ifdef HAVE_AUTH

    static QString getSslProtocolName( QSsl::SslProtocol protocol );

    static QMap<QString, QSslCertificate> mapDigestToCerts( const QList<QSslCertificate> &certs );

    static QMap< QString, QList<QSslCertificate> > certsGroupedByOrg( const QList<QSslCertificate> &certs ) SIP_SKIP;

    static QMap<QString, QgsAuthConfigSslServer> mapDigestToSslConfigs( const QList<QgsAuthConfigSslServer> &configs );

    static QMap< QString, QList<QgsAuthConfigSslServer> > sslConfigsGroupedByOrg( const QList<QgsAuthConfigSslServer> &configs ) SIP_SKIP;

    static QByteArray fileData( const QString &path );

    static QList<QSslCertificate> certsFromFile( const QString &certspath );

    static QList<QSslCertificate> casFromFile( const QString &certspath );

    static QSslCertificate certFromFile( const QString &certpath );

    static QList<QSslCertificate> casMerge( const QList<QSslCertificate> &bundle1,
                                            const QList<QSslCertificate> &bundle2 );

    static QSslKey keyFromFile( const QString &keypath,
                                const QString &keypass = QString(),
                                QString *algtype = nullptr );

    static QList<QSslCertificate> certsFromString( const QString &pemtext );
 

    static QList<QSslCertificate> casRemoveSelfSigned( const QList<QSslCertificate> &caList );

    static QStringList certKeyBundleToPem( const QString &certpath,
                                           const QString &keypath,
                                           const QString &keypass = QString(),
                                           bool reencrypt = true );

    static bool pemIsPkcs8( const QString &keyPemTxt );
 
#ifdef Q_OS_MAC

    static QByteArray pkcs8PrivateKey( QByteArray &pkcs8Der ) SIP_SKIP;
#endif

    static QStringList pkcs12BundleToPem( const QString &bundlepath,
                                          const QString &bundlepass = QString(),
                                          bool reencrypt = true );

    static QList<QSslCertificate> pkcs12BundleCas( const QString &bundlepath,
        const QString &bundlepass = QString() );
 

    static QByteArray certsToPemText( const QList<QSslCertificate> &certs );

    static QString pemTextToTempFile( const QString &name, const QByteArray &pemtext );

    static QString getCaSourceName( QgsAuthCertUtils::CaCertSource source, bool single = false );

    static QString resolvedCertName( const QSslCertificate &cert, bool issuer = false );

    static QString getCertDistinguishedName( const QSslCertificate &qcert,
        const QCA::Certificate &acert = QCA::Certificate(),
        bool issuer = false ) SIP_SKIP;

    static QString getCertTrustName( QgsAuthCertUtils::CertTrustPolicy trust );

    static QString getColonDelimited( const QString &txt );

    static QString shaHexForCert( const QSslCertificate &cert, bool formatted = false );

    static QCA::Certificate qtCertToQcaCert( const QSslCertificate &cert ) SIP_SKIP;

    static QCA::CertificateCollection qtCertsToQcaCollection( const QList<QSslCertificate> &certs ) SIP_SKIP;

    static QCA::KeyBundle qcaKeyBundle( const QString &path, const QString &pass ) SIP_SKIP;

    static QString qcaValidityMessage( QCA::Validity validity ) SIP_SKIP;

    static QString qcaSignatureAlgorithm( QCA::SignatureAlgorithm algorithm ) SIP_SKIP;

    static QString qcaKnownConstraint( QCA::ConstraintTypeKnown constraint ) SIP_SKIP;

    static QString certificateUsageTypeString( QgsAuthCertUtils::CertUsageType usagetype ) SIP_SKIP;
 
#ifndef QT_NO_SSL
    static QList<QgsAuthCertUtils::CertUsageType> certificateUsageTypes( const QSslCertificate &cert );

    static bool certificateIsAuthority( const QSslCertificate &cert );

    static bool certificateIsIssuer( const QSslCertificate &cert );

    static bool certificateIsAuthorityOrIssuer( const QSslCertificate &cert );

    static bool certificateIsSslServer( const QSslCertificate &cert );

    static bool certificateIsSslClient( const QSslCertificate &cert );

    static QString sslErrorEnumString( QSslError::SslError errenum );

    static QList<QPair<QSslError::SslError, QString> > sslErrorEnumStrings() SIP_SKIP;

    static bool certIsCurrent( const QSslCertificate &cert );

    static QList<QSslError> certViabilityErrors( const QSslCertificate &cert );

    static bool certIsViable( const QSslCertificate &cert );

    static QList<QSslError> validateCertChain( const QList<QSslCertificate> &certificateChain,
        const QString &hostName = QString(),
        bool trustRootCa = false ) ;
 
#endif

    static QStringList validatePKIBundle( QgsPkiBundle &bundle, bool useIntermediates = true, bool trustRootCa = false );
 
  private:
    static void appendDirSegment_( QStringList &dirname, const QString &segment, QString value );
 
    static QSsl::EncodingFormat sniffEncoding( const QByteArray &payload );
#endif
};
 
#endif // QGSAUTHCERTUTILS_H