summaryrefslogtreecommitdiffstats
path: root/third_party/libwebrtc/rtc_base/rtc_certificate_generator.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-19 00:47:55 +0000
commit26a029d407be480d791972afb5975cf62c9360a6 (patch)
treef435a8308119effd964b339f76abb83a57c29483 /third_party/libwebrtc/rtc_base/rtc_certificate_generator.h
parentInitial commit. (diff)
downloadfirefox-26a029d407be480d791972afb5975cf62c9360a6.tar.xz
firefox-26a029d407be480d791972afb5975cf62c9360a6.zip
Adding upstream version 124.0.1.upstream/124.0.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'third_party/libwebrtc/rtc_base/rtc_certificate_generator.h')
-rw-r--r--third_party/libwebrtc/rtc_base/rtc_certificate_generator.h82
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_