/* * 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_OPENSSL_IDENTITY_H_ #define RTC_BASE_OPENSSL_IDENTITY_H_ #include #include #include #include #include "rtc_base/checks.h" #include "rtc_base/constructor_magic.h" #include "rtc_base/openssl_certificate.h" #include "rtc_base/ssl_certificate.h" #include "rtc_base/ssl_identity.h" namespace rtc { // OpenSSLKeyPair encapsulates an OpenSSL EVP_PKEY* keypair object, // which is reference counted inside the OpenSSL library. class OpenSSLKeyPair final { 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); }; // Holds a keypair and certificate together, and a method to generate // them consistently. class OpenSSLIdentity final : public SSLIdentity { public: static std::unique_ptr CreateWithExpiration( const std::string& common_name, const KeyParams& key_params, time_t certificate_lifetime); static std::unique_ptr CreateForTest( const SSLIdentityParams& params); static std::unique_ptr CreateFromPEMStrings( const std::string& private_key, const std::string& certificate); static std::unique_ptr CreateFromPEMChainStrings( const std::string& private_key, const std::string& certificate_chain); ~OpenSSLIdentity() override; const OpenSSLCertificate& certificate() const override; const SSLCertChain& cert_chain() 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); std::unique_ptr CloneInternal() const override; static std::unique_ptr CreateInternal( const SSLIdentityParams& params); std::unique_ptr key_pair_; std::unique_ptr cert_chain_; RTC_DISALLOW_COPY_AND_ASSIGN(OpenSSLIdentity); }; } // namespace rtc #endif // RTC_BASE_OPENSSL_IDENTITY_H_