/* * Copyright 2016 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 WEBRTC_BASE_RTCCERTIFICATEGENERATOR_H_ #define WEBRTC_BASE_RTCCERTIFICATEGENERATOR_H_ #include "webrtc/base/optional.h" #include "webrtc/base/refcount.h" #include "webrtc/base/rtccertificate.h" #include "webrtc/base/scoped_ref_ptr.h" #include "webrtc/base/sslidentity.h" #include "webrtc/base/thread.h" namespace rtc { // See |RTCCertificateGeneratorInterface::GenerateCertificateAsync|. class RTCCertificateGeneratorCallback : public RefCountInterface { public: virtual void OnSuccess( const scoped_refptr& certificate) = 0; virtual void OnFailure() = 0; protected: ~RTCCertificateGeneratorCallback() override {} }; // Generates |RTCCertificate|s. // See |RTCCertificateGenerator| for the WebRTC repo's implementation. class RTCCertificateGeneratorInterface { public: virtual ~RTCCertificateGeneratorInterface() {} // Generates a certificate asynchronously on the worker thread. // Must be called on the signaling thread. The |callback| is invoked with the // result on the signaling thread. |exipres_ms| optionally specifies for how // long we want the certificate to be valid, but the implementation may choose // its own restrictions on the expiration time. virtual void GenerateCertificateAsync( const KeyParams& key_params, const Optional& expires_ms, const scoped_refptr& callback) = 0; }; // Standard implementation of |RTCCertificateGeneratorInterface|. // The static function |GenerateCertificate| generates a certificate on the // current thread. The |RTCCertificateGenerator| instance generates certificates // asynchronously on the worker thread with |GenerateCertificateAsync|. class RTCCertificateGenerator : public RTCCertificateGeneratorInterface { public: // Generates a certificate on the current thread. Returns null on failure. // If |expires_ms| is specified, the certificate will expire in approximately // that many milliseconds from now. |expires_ms| is limited to a year, a // larger value than that is clamped down to a year. If |expires_ms| is not // specified, a default expiration time is used. static scoped_refptr GenerateCertificate( const KeyParams& key_params, const Optional& expires_ms); RTCCertificateGenerator(Thread* signaling_thread, Thread* worker_thread); ~RTCCertificateGenerator() override {} // |RTCCertificateGeneratorInterface| overrides. // If |expires_ms| is specified, the certificate will expire in approximately // that many milliseconds from now. |expires_ms| is limited to a year, a // larger value than that is clamped down to a year. If |expires_ms| is not // specified, a default expiration time is used. void GenerateCertificateAsync( const KeyParams& key_params, const Optional& expires_ms, const scoped_refptr& callback) override; private: Thread* const signaling_thread_; Thread* const worker_thread_; }; } // namespace rtc #endif // WEBRTC_BASE_RTCCERTIFICATEGENERATOR_H_