zeroc-ice 3.7.11 → 3.8.1

data/dist/ice/cpp/include/IceSSL/Plugin.h

@@ -1,712 +0,0 @@
-//
-// Copyright (c) ZeroC, Inc. All rights reserved.
-//
-
-#ifndef ICESSL_PLUGIN_H
-#define ICESSL_PLUGIN_H
-
-#include <Ice/Plugin.h>
-#include <IceSSL/Config.h>
-#include <IceSSL/ConnectionInfoF.h>
-
-#ifdef ICE_CPP11_MAPPING
-#   include <chrono>
-#else
-#   include <IceUtil/Time.h>
-#endif
-
-#include <vector>
-#include <list>
-
-#ifndef ICESSL_API
-#   if defined(ICE_STATIC_LIBS)
-#       define ICESSL_API /**/
-#   elif defined(ICESSL_API_EXPORTS)
-#       define ICESSL_API ICE_DECLSPEC_EXPORT
-#   else
-#       define ICESSL_API ICE_DECLSPEC_IMPORT
-#   endif
-#endif
-
-namespace IceSSL
-{
-
-/**
- * The reason for an IceSSL certificate verification failure.
- */
-#ifdef ICE_CPP11_MAPPING
-enum class TrustError : unsigned char
-#else
-enum TrustError
-#endif
-{
-    /** The certification verification succeed  */
-    NoError = 0,
-    /** The certificate chain length is greater than the specified maximum depth **/
-    ChainTooLong,
-    /** The X509 chain is invalid because a certificate has excluded a name constraint **/
-    HasExcludedNameConstraint,
-    /** The certificate has an undefined name constraint **/
-    HasNonDefinedNameConstraint,
-    /** The certificate has a non permitted name constraint **/
-    HasNonPermittedNameConstraint,
-    /** The certificate does not support a critical extension **/
-    HasNonSupportedCriticalExtension,
-    /** The certificate does not have a supported name constraint or has a name constraint that is unsupported **/
-    HasNonSupportedNameConstraint,
-    /** A host name mismatch has occurred **/
-    HostNameMismatch,
-    /** The X509 chain is invalid due to invalid basic constraints **/
-    InvalidBasicConstraints,
-    /** The X509 chain is invalid due to an invalid extension **/
-    InvalidExtension,
-    /** The X509 chain is invalid due to invalid name constraints **/
-    InvalidNameConstraints,
-    /** The X509 chain is invalid due to invalid policy constraints **/
-    InvalidPolicyConstraints,
-    /** The supplied certificate cannot be used for the specified purpose **/
-    InvalidPurpose,
-    /** The X509 chain is invalid due to an invalid certificate signature **/
-    InvalidSignature,
-    /** The X509 chain is not valid due to an invalid time value, such as a value that indicates an expired
-        certificate **/
-    InvalidTime,
-    /** The certificate is explicitly not trusted **/
-    NotTrusted,
-    /** The X509 chain could not be built up to the root certificate **/
-    PartialChain,
-    /** It is not possible to determine whether the certificate has been revoked **/
-    RevocationStatusUnknown,
-    /** The X509 chain is invalid due to a revoked certificate **/
-    Revoked,
-    /** The X509 chain is invalid due to an untrusted root certificate **/
-    UntrustedRoot,
-    /** The X509 chain is invalid due to other unknown failure **/
-    UnknownTrustFailure,
-};
-
-ICESSL_API TrustError getTrustError(const IceSSL::ConnectionInfoPtr&);
-ICESSL_API std::string getTrustErrorDescription(TrustError);
-ICESSL_API std::string getHost(const IceSSL::ConnectionInfoPtr&);
-
-/**
- * The key usage "digitalSignature" bit is set
- */
-const unsigned int KEY_USAGE_DIGITAL_SIGNATURE = 1u << 0;
-/**
- * The key usage "nonRepudiation" bit is set
- */
-const unsigned int KEY_USAGE_NON_REPUDIATION = 1u << 1;
-/**
- * The key usage "keyEncipherment" bit is set
- */
-const unsigned int KEY_USAGE_KEY_ENCIPHERMENT = 1u << 2;
-/**
- * The key usage "dataEncipherment" bit is set
- */
-const unsigned int KEY_USAGE_DATA_ENCIPHERMENT = 1u << 3;
-/**
- * The key usage "keyAgreement" bit is set
- */
-const unsigned int KEY_USAGE_KEY_AGREEMENT = 1u << 4;
-/**
- * The key usage "keyCertSign" bit is set
- */
-const unsigned int KEY_USAGE_KEY_CERT_SIGN = 1u << 5;
-/**
- * The key usage "cRLSign" bit is set
- */
-const unsigned int KEY_USAGE_CRL_SIGN = 1u << 6;
-/**
- * The key usage "encipherOnly" bit is set
- */
-const unsigned int KEY_USAGE_ENCIPHER_ONLY = 1u << 7;
-/**
- * The key usage "decipherOnly" bit is set
- */
-const unsigned int KEY_USAGE_DECIPHER_ONLY = 1u << 8;
-
-/**
- * The extended key usage "anyKeyUsage" bit is set
- */
-const unsigned int EXTENDED_KEY_USAGE_ANY_KEY_USAGE = 1u << 0;
-/**
- * The extended key usage "serverAuth" bit is set
- */
-const unsigned int EXTENDED_KEY_USAGE_SERVER_AUTH = 1u << 1;
-/**
- * The extended key usage "clientAuth" bit is set
- */
-const unsigned int EXTENDED_KEY_USAGE_CLIENT_AUTH = 1u << 2;
-/**
- * The extended key usage "codeSigning" bit is set
- */
-const unsigned int EXTENDED_KEY_USAGE_CODE_SIGNING = 1u << 3;
-/**
- * The extended key usage "emailProtection" bit is set
- */
-const unsigned int EXTENDED_KEY_USAGE_EMAIL_PROTECTION = 1u << 4;
-/**
- * The extended key usage "timeStamping" bit is set
- */
-const unsigned int EXTENDED_KEY_USAGE_TIME_STAMPING = 1u << 5;
-/**
- * The extended key usage "OCSPSigning" bit is set
- */
-const unsigned int EXTENDED_KEY_USAGE_OCSP_SIGNING = 1u << 6;
-
-/**
- * Thrown if the certificate cannot be read.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API CertificateReadException : public IceUtil::ExceptionHelper<CertificateReadException>
-{
-public:
-
-    CertificateReadException(const char*, int, const std::string&);
-
-#ifndef ICE_CPP11_COMPILER
-    virtual ~CertificateReadException() throw();
-#endif
-
-    virtual std::string ice_id() const;
-
-#ifndef ICE_CPP11_MAPPING
-    /**
-     * Creates a shallow copy of this exception.
-     * @return The new exception instance.
-     */
-    virtual CertificateReadException* ice_clone() const;
-#endif
-
-    /** The reason for the exception. */
-    std::string reason;
-
-private:
-
-    static const char* _name;
-};
-
-/**
- * Thrown if the certificate cannot be encoded.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API CertificateEncodingException : public IceUtil::ExceptionHelper<CertificateEncodingException>
-{
-public:
-
-    CertificateEncodingException(const char*, int, const std::string&);
-
-#ifndef ICE_CPP11_COMPILER
-    virtual ~CertificateEncodingException() throw();
-#endif
-
-    virtual std::string ice_id() const;
-
-#ifndef ICE_CPP11_MAPPING
-    /**
-     * Creates a shallow copy of this exception.
-     * @return The new exception instance.
-     */
-    virtual CertificateEncodingException* ice_clone() const;
-#endif
-
-    /** The reason for the exception. */
-    std::string reason;
-
-private:
-
-    static const char* _name;
-};
-
-/**
- * This exception is thrown if a distinguished name cannot be parsed.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API ParseException : public IceUtil::ExceptionHelper<ParseException>
-{
-public:
-
-    ParseException(const char*, int, const std::string&);
-
-#ifndef ICE_CPP11_COMPILER
-    virtual ~ParseException() throw();
-#endif
-
-    virtual std::string ice_id() const;
-
-#ifndef ICE_CPP11_MAPPING
-    /**
-     * Creates a shallow copy of this exception.
-     * @return The new exception instance.
-     */
-    virtual ParseException* ice_clone() const;
-#endif
-
-    /** The reason for the exception. */
-    std::string reason;
-
-private:
-
-    static const char* _name;
-};
-
-/**
- * This class represents a DistinguishedName, similar to the Java
- * type X500Principal and the .NET type X500DistinguishedName.
- *
- * For comparison purposes, the value of a relative distinguished
- * name (RDN) component is always unescaped before matching,
- * therefore "ZeroC, Inc." will match ZeroC\, Inc.
- *
- * toString() always returns exactly the same information as was
- * provided in the constructor (i.e., "ZeroC, Inc." will not turn
- * into ZeroC\, Inc.).
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API DistinguishedName
-{
-public:
-
-    /**
-     * Creates a DistinguishedName from a string encoded using the rules in RFC2253.
-     * @param name The encoded distinguished name.
-     * @throws ParseException if parsing fails.
-     */
-    explicit DistinguishedName(const std::string& name);
-
-    /**
-     * Creates a DistinguishedName from a list of RDN pairs,
-     * where each pair consists of the RDN's type and value.
-     * For example, the RDN "O=ZeroC" is represented by the
-     * pair ("O", "ZeroC").
-     * @throws ParseException if parsing fails.
-     */
-    explicit DistinguishedName(const std::list<std::pair<std::string, std::string> >&);
-
-    /**
-     * Performs an exact match. The order of the RDN components is important.
-     */
-    friend ICESSL_API bool operator==(const DistinguishedName&, const DistinguishedName&);
-
-    /**
-     * Performs an exact match. The order of the RDN components is important.
-     */
-    friend ICESSL_API bool operator<(const DistinguishedName&, const DistinguishedName&);
-
-    /**
-     * Performs a partial match with another DistinguishedName.
-     * @param dn The name to be matched.
-     * @return True if all of the RDNs in the argument are present in this
-     * DistinguishedName and they have the same values.
-     */
-    bool match(const DistinguishedName& dn) const;
-
-    /**
-     * Performs a partial match with another DistinguishedName.
-     * @param dn The name to be matched.
-     * @return True if all of the RDNs in the argument are present in this
-     * DistinguishedName and they have the same values.
-     */
-    bool match(const std::string& dn) const;
-
-    /**
-     * Encodes the DN in RFC2253 format.
-     * @return An encoded string.
-     */
-    operator std::string() const;
-
-protected:
-
-    /// \cond INTERNAL
-    void unescape();
-    /// \endcond
-
-private:
-
-    std::list<std::pair<std::string, std::string> > _rdns;
-    std::list<std::pair<std::string, std::string> > _unescaped;
-};
-
-/**
- * Performs an exact match. The order of the RDN components is important.
- */
-inline bool
-operator>(const DistinguishedName& lhs, const DistinguishedName& rhs)
-{
-    return rhs < lhs;
-}
-
-/**
- * Performs an exact match. The order of the RDN components is important.
- */
-inline bool
-operator<=(const DistinguishedName& lhs, const DistinguishedName& rhs)
-{
-    return !(lhs > rhs);
-}
-
-/**
- * Performs an exact match. The order of the RDN components is important.
- */
-inline bool
-operator>=(const DistinguishedName& lhs, const DistinguishedName& rhs)
-{
-    return !(lhs < rhs);
-}
-
-/**
- * Performs an exact match. The order of the RDN components is important.
- */
-inline bool
-operator!=(const DistinguishedName& lhs, const DistinguishedName& rhs)
-{
-    return !(lhs == rhs);
-}
-
-/**
- * Represents an X509 Certificate extension.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API X509Extension
-#ifndef ICE_CPP11_MAPPING
-    : public virtual IceUtil::Shared
-#endif
-{
-public:
-
-    /**
-     * Determines whether the information in this extension is important.
-     * @return True if if information is important, false otherwise.
-     */
-    virtual bool isCritical() const = 0;
-
-    /**
-     * Obtains the object ID of this extension.
-     * @return The object ID.
-     */
-    virtual std::string getOID() const = 0;
-
-    /**
-     * Obtains the data associated with this extension.
-     * @return The extension data.
-     */
-    virtual std::vector<Ice::Byte> getData() const = 0;
-};
-ICE_DEFINE_PTR(X509ExtensionPtr, X509Extension);
-
-class Certificate;
-ICE_DEFINE_PTR(CertificatePtr, Certificate);
-
-/**
- * This convenience class is a wrapper around a native certificate.
- * The interface is inspired by java.security.cert.X509Certificate.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API Certificate :
-#ifdef ICE_CPP11_MAPPING
-    public std::enable_shared_from_this<Certificate>
-#else
-    public virtual IceUtil::Shared
-#endif
-{
-public:
-
-    /**
-     * Compares the certificates for equality using the native certificate comparison method.
-     */
-    virtual bool operator==(const Certificate&) const = 0;
-
-    /**
-     * Compares the certificates for equality using the native certificate comparison method.
-     */
-    virtual bool operator!=(const Certificate&) const = 0;
-
-    /**
-     * Obtains the authority key identifier.
-     * @return The identifier.
-     */
-    virtual std::vector<Ice::Byte> getAuthorityKeyIdentifier() const = 0;
-
-    /**
-     * Obtains the subject key identifier.
-     * @return The identifier.
-     */
-    virtual std::vector<Ice::Byte> getSubjectKeyIdentifier() const = 0;
-
-    /**
-     * Verifies that this certificate was signed by the given certificate
-     * public key.
-     * @param cert A certificate containing the public key.
-     * @return True if signed, false otherwise.
-     */
-    virtual bool verify(const CertificatePtr& cert) const = 0;
-
-    /**
-     * Obtains a string encoding of the certificate in PEM format.
-     * @return The encoded certificate.
-     * @throws CertificateEncodingException if an error occurs.
-     */
-    virtual std::string encode() const = 0;
-
-    /**
-     * Checks that the certificate is currently valid, that is, the current
-     * date falls between the validity period given in the certificate.
-     * @return True if the certificate is valid, false otherwise.
-     */
-    virtual bool checkValidity() const = 0;
-
-    /**
-     * Checks that the certificate is valid at the given time.
-     * @param t The target time.
-     * @return True if the certificate is valid, false otherwise.
-     */
-#ifdef ICE_CPP11_MAPPING
-    virtual bool checkValidity(const std::chrono::system_clock::time_point& t) const = 0;
-#else
-    virtual bool checkValidity(const IceUtil::Time& t) const = 0;
-#endif
-
-    /**
-     * Returns the value of the key usage extension. The flags <b>KEY_USAGE_DIGITAL_SIGNATURE</b>,
-     * <b>KEY_USAGE_NON_REPUDIATION</b>, <b>KEY_USAGE_KEY_ENCIPHERMENT</b>, <b>KEY_USAGE_DATA_ENCIPHERMENT</b>
-     * <b>KEY_USAGE_KEY_AGREEMENT</b>, <b>KEY_USAGE_KEY_CERT_SIGN</b>, <b>KEY_USAGE_CRL_SIGN</b>,
-     * <b>KEY_USAGE_ENCIPHER_ONLY</b> and <b>KEY_USAGE_DECIPHER_ONLY</b> can be used to check what
-     * key usage bits are set.
-     */
-    unsigned int getKeyUsage() const;
-
-    /**
-     * Returns the value of the extended key usage extension. The flags <b>EXTENDED_KEY_USAGE_ANY_KEY_USAGE</b>,
-     * <b>EXTENDED_KEY_USAGE_SERVER_AUTH</b>, <b>EXTENDED_KEY_USAGE_CLIENT_AUTH</b>,
-     * <b>EXTENDED_KEY_USAGE_CODE_SIGNING</b>, <b>EXTENDED_KEY_USAGE_EMAIL_PROTECTION</b>,
-     * <b>EXTENDED_KEY_USAGE_TIME_STAMPING</b> and <b>EXTENDED_KEY_USAGE_OCSP_SIGNING</b> can be used to check what
-     * extended key usage bits are set.
-     */
-    unsigned int getExtendedKeyUsage() const;
-
-    /**
-     * Obtains the not-after validity time.
-     * @return The time after which this certificate is invalid.
-     */
-#ifdef ICE_CPP11_MAPPING
-    virtual std::chrono::system_clock::time_point getNotAfter() const = 0;
-#else
-    virtual IceUtil::Time getNotAfter() const = 0;
-#endif
-
-    /**
-     * Obtains the not-before validity time.
-     * @return The time at which this certificate is valid.
-     */
-#ifdef ICE_CPP11_MAPPING
-    virtual std::chrono::system_clock::time_point getNotBefore() const = 0;
-#else
-    virtual IceUtil::Time getNotBefore() const = 0;
-#endif
-
-    /**
-     * Obtains the serial number. This is an arbitrarily large number.
-     * @return The certificate's serial number.
-     */
-    virtual std::string getSerialNumber() const = 0;
-
-    /**
-     * Obtains the issuer's distinguished name (DN).
-     * @return The distinguished name.
-     */
-    virtual DistinguishedName getIssuerDN() const = 0;
-
-    /**
-     * Obtains the values in the issuer's alternative names extension.
-     *
-     * The returned list contains a pair of int, string.
-     *
-     * otherName                       [0]     OtherName
-     * rfc822Name                      [1]     IA5String
-     * dNSName                         [2]     IA5String
-     * x400Address                     [3]     ORAddress
-     * directoryName                   [4]     Name
-     * ediPartyName                    [5]     EDIPartyName
-     * uniformResourceIdentifier       [6]     IA5String
-     * iPAddress                       [7]     OCTET STRING
-     * registeredID                    [8]     OBJECT IDENTIFIER
-     *
-     * rfc822Name, dNSName, directoryName and
-     * uniformResourceIdentifier data is returned as a string.
-     *
-     * iPAddress is returned in dotted quad notation. IPv6 is not
-     * currently supported.
-     *
-     * All distinguished names are encoded in RFC2253 format.
-     *
-     * The remainder of the data will result in an empty string. Use the raw
-     * X509* certificate to obtain these values.
-     *
-     * @return The issuer's alternative names.
-     */
-    virtual std::vector<std::pair<int, std::string> > getIssuerAlternativeNames() const = 0;
-
-    /**
-     * Obtains the subject's distinguished name (DN).
-     * @return The distinguished name.
-     */
-    virtual DistinguishedName getSubjectDN() const = 0;
-
-    /**
-     * See the comment for Plugin::getIssuerAlternativeNames.
-     * @return The subject's alternative names.
-     */
-    virtual std::vector<std::pair<int, std::string> > getSubjectAlternativeNames() const = 0;
-
-    /**
-     * Obtains the certificate version number.
-     * @return The version number.
-     */
-    virtual int getVersion() const = 0;
-
-    /**
-     * Stringifies the certificate. This is a human readable version of
-     * the certificate, not a DER or PEM encoding.
-     * @return A string version of the certificate.
-     */
-    virtual std::string toString() const = 0;
-
-    /**
-     * Obtains a list of the X509v3 extensions contained in the certificate.
-     * @return The extensions.
-     */
-    virtual std::vector<X509ExtensionPtr> getX509Extensions() const = 0;
-
-    /**
-     * Obtains the extension with the given OID.
-     * @return The extension, or null if the certificate
-     * does not contain a extension with the given OID.
-     */
-    virtual X509ExtensionPtr getX509Extension(const std::string& oid) const = 0;
-
-    /**
-     * Loads the certificate from a file. The certificate must use the
-     * PEM encoding format.
-     * @param file The certificate file.
-     * @return The new certificate instance.
-     * @throws CertificateReadException if the file cannot be read.
-     */
-    static CertificatePtr load(const std::string& file);
-
-    /**
-     * Decodes a certificate from a string that uses the PEM encoding format.
-     * @param str A string containing the encoded certificate.
-     * @throws CertificateEncodingException if an error occurs.
-     */
-    static CertificatePtr decode(const std::string& str);
-};
-
-#ifndef ICE_CPP11_MAPPING // C++98 mapping
-
-/**
- * An application can customize the certificate verification process
- * by implementing the CertificateVerifier interface.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API CertificateVerifier : public IceUtil::Shared
-{
-public:
-
-    virtual ~CertificateVerifier();
-
-    /**
-     * Determines whether to accept a certificate.
-     * @param info Information about the connection.
-     * @return False if the connection should be rejected, or true to allow it.
-     */
-    virtual bool verify(const ConnectionInfoPtr& info) = 0;
-};
-typedef IceUtil::Handle<CertificateVerifier> CertificateVerifierPtr;
-
-/**
- * In order to read an encrypted file, such as one containing a
- * private key, OpenSSL requests a password from IceSSL. The password
- * can be defined using an IceSSL configuration property, but a
- * plain-text password is a security risk. If a password is not
- * supplied via configuration, IceSSL allows OpenSSL to prompt the
- * user interactively. This may not be desirable (or even possible),
- * so the application can supply an implementation of PasswordPrompt
- * to take responsibility for obtaining the password.
- *
- * Note that the password is needed during plug-in initialization, so
- * in general you will need to delay initialization (by defining
- * IceSSL.DelayInit=1), configure the PasswordPrompt, then manually
- * initialize the plug-in.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API PasswordPrompt : public IceUtil::Shared
-{
-public:
-
-    virtual ~PasswordPrompt();
-
-    /**
-     * Obtains the password. This method may be invoked repeatedly, such as when
-     * several encrypted files are opened, or when multiple password
-     * attempts are allowed.
-     * @return The clear-text password.
-     */
-    virtual std::string getPassword() = 0;
-};
-typedef IceUtil::Handle<PasswordPrompt> PasswordPromptPtr;
-#endif
-
-/**
- * Represents the IceSSL plug-in object.
- * \headerfile IceSSL/IceSSL.h
- */
-class ICESSL_API Plugin : public Ice::Plugin
-{
-public:
-
-    virtual ~Plugin();
-
-    /**
-     * Establish the certificate verifier object. This should be done
-     * before any connections are established.
-     * @param v The verifier.
-     */
-#ifdef ICE_CPP11_MAPPING
-    virtual void setCertificateVerifier(std::function<bool(const std::shared_ptr<ConnectionInfo>&)> v) = 0;
-#else
-    virtual void setCertificateVerifier(const CertificateVerifierPtr& v) = 0;
-#endif
-
-    /**
-     * Establish the password prompt object. This must be done before
-     * the plug-in is initialized.
-     * @param p The password prompt.
-     */
-#ifdef ICE_CPP11_MAPPING
-    virtual void setPasswordPrompt(std::function<std::string()> p) = 0;
-#else
-    virtual void setPasswordPrompt(const PasswordPromptPtr& p) = 0;
-#endif
-
-    /**
-     * Load the certificate from a file. The certificate must use the
-     * PEM encoding format.
-     * @param file The certificate file.
-     * @throws CertificateReadException if the file cannot be read.
-     */
-    virtual CertificatePtr load(const std::string& file) const = 0;
-
-    /**
-     * Decode a certificate from a string that uses the PEM encoding
-     * format.
-     * @param str A string containing the encoded certificate.
-     * @throws CertificateEncodingException if an error occurs.
-     */
-    virtual CertificatePtr decode(const std::string& str) const = 0;
-};
-ICE_DEFINE_PTR(PluginPtr, Plugin);
-
-}
-
-#endif