/* * Copyright 2004 The WebRTC Project Authors. All rights reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ #ifndef RTC_BASE_OPENSSLIDENTITY_H_ #define RTC_BASE_OPENSSLIDENTITY_H_ #include #include #include #include #include "rtc_base/checks.h" #include "rtc_base/constructormagic.h" #include "rtc_base/sslidentity.h" typedef struct ssl_ctx_st SSL_CTX; namespace rtc { // OpenSSLKeyPair encapsulates an OpenSSL EVP_PKEY* keypair object, // which is reference counted inside the OpenSSL library. class OpenSSLKeyPair { public: explicit OpenSSLKeyPair(EVP_PKEY* pkey) : pkey_(pkey) { RTC_DCHECK(pkey_ != nullptr); } static OpenSSLKeyPair* Generate(const KeyParams& key_params); // Constructs a key pair from the private key PEM string. This must not result // in missing public key parameters. Returns null on error. static OpenSSLKeyPair* FromPrivateKeyPEMString(const std::string& pem_string); virtual ~OpenSSLKeyPair(); virtual OpenSSLKeyPair* GetReference(); EVP_PKEY* pkey() const { return pkey_; } std::string PrivateKeyToPEMString() const; std::string PublicKeyToPEMString() const; bool operator==(const OpenSSLKeyPair& other) const; bool operator!=(const OpenSSLKeyPair& other) const; private: void AddReference(); EVP_PKEY* pkey_; RTC_DISALLOW_COPY_AND_ASSIGN(OpenSSLKeyPair); }; // OpenSSLCertificate encapsulates an OpenSSL X509* certificate object, // which is also reference counted inside the OpenSSL library. class OpenSSLCertificate : public SSLCertificate { public: // Caller retains ownership of the X509 object. explicit OpenSSLCertificate(X509* x509); static OpenSSLCertificate* Generate(OpenSSLKeyPair* key_pair, const SSLIdentityParams& params); static OpenSSLCertificate* FromPEMString(const std::string& pem_string); ~OpenSSLCertificate() override; OpenSSLCertificate* GetReference() const override; X509* x509() const { return x509_; } std::string ToPEMString() const override; void ToDER(Buffer* der_buffer) const override; bool operator==(const OpenSSLCertificate& other) const; bool operator!=(const OpenSSLCertificate& other) const; // Compute the digest of the certificate given algorithm bool ComputeDigest(const std::string& algorithm, unsigned char* digest, size_t size, size_t* length) const override; // Compute the digest of a certificate as an X509 * static bool ComputeDigest(const X509* x509, const std::string& algorithm, unsigned char* digest, size_t size, size_t* length); bool GetSignatureDigestAlgorithm(std::string* algorithm) const override; std::unique_ptr GetChain() const override; int64_t CertificateExpirationTime() const override; private: void AddReference() const; X509* x509_; RTC_DISALLOW_COPY_AND_ASSIGN(OpenSSLCertificate); }; // Holds a keypair and certificate together, and a method to generate // them consistently. class OpenSSLIdentity : public SSLIdentity { public: static OpenSSLIdentity* GenerateWithExpiration(const std::string& common_name, const KeyParams& key_params, time_t certificate_lifetime); static OpenSSLIdentity* GenerateForTest(const SSLIdentityParams& params); static SSLIdentity* FromPEMStrings(const std::string& private_key, const std::string& certificate); static SSLIdentity* FromPEMChainStrings(const std::string& private_key, const std::string& certificate_chain); ~OpenSSLIdentity() override; const OpenSSLCertificate& certificate() const override; OpenSSLIdentity* GetReference() const override; // Configure an SSL context object to use our key and certificate. bool ConfigureIdentity(SSL_CTX* ctx); std::string PrivateKeyToPEMString() const override; std::string PublicKeyToPEMString() const override; bool operator==(const OpenSSLIdentity& other) const; bool operator!=(const OpenSSLIdentity& other) const; private: OpenSSLIdentity(std::unique_ptr key_pair, std::unique_ptr certificate); OpenSSLIdentity(std::unique_ptr key_pair, std::unique_ptr cert_chain); static OpenSSLIdentity* GenerateInternal(const SSLIdentityParams& params); std::unique_ptr key_pair_; std::unique_ptr cert_chain_; RTC_DISALLOW_COPY_AND_ASSIGN(OpenSSLIdentity); }; } // namespace rtc #endif // RTC_BASE_OPENSSLIDENTITY_H_