diff options
Diffstat (limited to 'third_party/libwebrtc/rtc_base/rtc_certificate_generator.h')
-rw-r--r-- | third_party/libwebrtc/rtc_base/rtc_certificate_generator.h | 82 |
1 files changed, 82 insertions, 0 deletions
diff --git a/third_party/libwebrtc/rtc_base/rtc_certificate_generator.h b/third_party/libwebrtc/rtc_base/rtc_certificate_generator.h new file mode 100644 index 0000000000..a881f1a369 --- /dev/null +++ b/third_party/libwebrtc/rtc_base/rtc_certificate_generator.h @@ -0,0 +1,82 @@ +/* + * 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 RTC_BASE_RTC_CERTIFICATE_GENERATOR_H_ +#define RTC_BASE_RTC_CERTIFICATE_GENERATOR_H_ + +#include <stdint.h> + +#include "absl/functional/any_invocable.h" +#include "absl/types/optional.h" +#include "api/scoped_refptr.h" +#include "rtc_base/rtc_certificate.h" +#include "rtc_base/ssl_identity.h" +#include "rtc_base/system/rtc_export.h" +#include "rtc_base/thread.h" + +namespace rtc { + +// Generates `RTCCertificate`s. +// See `RTCCertificateGenerator` for the WebRTC repo's implementation. +class RTCCertificateGeneratorInterface { + public: + // Functor that will be called when certificate is generated asynchroniosly. + // Called with nullptr as the parameter on failure. + using Callback = absl::AnyInvocable<void(scoped_refptr<RTCCertificate>) &&>; + + virtual ~RTCCertificateGeneratorInterface() = default; + + // 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 absl::optional<uint64_t>& expires_ms, + Callback 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 RTC_EXPORT 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<RTCCertificate> GenerateCertificate( + const KeyParams& key_params, + const absl::optional<uint64_t>& 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 absl::optional<uint64_t>& expires_ms, + Callback callback) override; + + private: + Thread* const signaling_thread_; + Thread* const worker_thread_; +}; + +} // namespace rtc + +#endif // RTC_BASE_RTC_CERTIFICATE_GENERATOR_H_ |