Henrik Boström | da3a1da | 2016-04-15 17:55:21 +0200 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2016 The WebRTC project authors. All Rights Reserved. |
| 3 | * |
| 4 | * Use of this source code is governed by a BSD-style license |
| 5 | * that can be found in the LICENSE file in the root of the source |
| 6 | * tree. An additional intellectual property rights grant can be found |
| 7 | * in the file PATENTS. All contributing project authors may |
| 8 | * be found in the AUTHORS file in the root of the source tree. |
| 9 | */ |
| 10 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 11 | #ifndef RTC_BASE_RTCCERTIFICATEGENERATOR_H_ |
| 12 | #define RTC_BASE_RTCCERTIFICATEGENERATOR_H_ |
Henrik Boström | da3a1da | 2016-04-15 17:55:21 +0200 | [diff] [blame] | 13 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 14 | #include "api/optional.h" |
| 15 | #include "rtc_base/refcount.h" |
| 16 | #include "rtc_base/rtccertificate.h" |
| 17 | #include "rtc_base/scoped_ref_ptr.h" |
| 18 | #include "rtc_base/sslidentity.h" |
| 19 | #include "rtc_base/thread.h" |
Henrik Boström | da3a1da | 2016-04-15 17:55:21 +0200 | [diff] [blame] | 20 | |
Henrik Kjellander | ec78f1c | 2017-06-29 07:52:50 +0200 | [diff] [blame] | 21 | namespace rtc { |
| 22 | |
| 23 | // See |RTCCertificateGeneratorInterface::GenerateCertificateAsync|. |
| 24 | class RTCCertificateGeneratorCallback : public RefCountInterface { |
| 25 | public: |
| 26 | virtual void OnSuccess( |
| 27 | const scoped_refptr<RTCCertificate>& certificate) = 0; |
| 28 | virtual void OnFailure() = 0; |
| 29 | |
| 30 | protected: |
| 31 | ~RTCCertificateGeneratorCallback() override {} |
| 32 | }; |
| 33 | |
| 34 | // Generates |RTCCertificate|s. |
| 35 | // See |RTCCertificateGenerator| for the WebRTC repo's implementation. |
| 36 | class RTCCertificateGeneratorInterface { |
| 37 | public: |
| 38 | virtual ~RTCCertificateGeneratorInterface() {} |
| 39 | |
| 40 | // Generates a certificate asynchronously on the worker thread. |
| 41 | // Must be called on the signaling thread. The |callback| is invoked with the |
| 42 | // result on the signaling thread. |exipres_ms| optionally specifies for how |
| 43 | // long we want the certificate to be valid, but the implementation may choose |
| 44 | // its own restrictions on the expiration time. |
| 45 | virtual void GenerateCertificateAsync( |
| 46 | const KeyParams& key_params, |
| 47 | const Optional<uint64_t>& expires_ms, |
| 48 | const scoped_refptr<RTCCertificateGeneratorCallback>& callback) = 0; |
| 49 | }; |
| 50 | |
| 51 | // Standard implementation of |RTCCertificateGeneratorInterface|. |
| 52 | // The static function |GenerateCertificate| generates a certificate on the |
| 53 | // current thread. The |RTCCertificateGenerator| instance generates certificates |
| 54 | // asynchronously on the worker thread with |GenerateCertificateAsync|. |
| 55 | class RTCCertificateGenerator : public RTCCertificateGeneratorInterface { |
| 56 | public: |
| 57 | // Generates a certificate on the current thread. Returns null on failure. |
| 58 | // If |expires_ms| is specified, the certificate will expire in approximately |
| 59 | // that many milliseconds from now. |expires_ms| is limited to a year, a |
| 60 | // larger value than that is clamped down to a year. If |expires_ms| is not |
| 61 | // specified, a default expiration time is used. |
| 62 | static scoped_refptr<RTCCertificate> GenerateCertificate( |
| 63 | const KeyParams& key_params, |
| 64 | const Optional<uint64_t>& expires_ms); |
| 65 | |
| 66 | RTCCertificateGenerator(Thread* signaling_thread, Thread* worker_thread); |
| 67 | ~RTCCertificateGenerator() override {} |
| 68 | |
| 69 | // |RTCCertificateGeneratorInterface| overrides. |
| 70 | // If |expires_ms| is specified, the certificate will expire in approximately |
| 71 | // that many milliseconds from now. |expires_ms| is limited to a year, a |
| 72 | // larger value than that is clamped down to a year. If |expires_ms| is not |
| 73 | // specified, a default expiration time is used. |
| 74 | void GenerateCertificateAsync( |
| 75 | const KeyParams& key_params, |
| 76 | const Optional<uint64_t>& expires_ms, |
| 77 | const scoped_refptr<RTCCertificateGeneratorCallback>& callback) override; |
| 78 | |
| 79 | private: |
| 80 | Thread* const signaling_thread_; |
| 81 | Thread* const worker_thread_; |
| 82 | }; |
| 83 | |
| 84 | } // namespace rtc |
Henrik Boström | da3a1da | 2016-04-15 17:55:21 +0200 | [diff] [blame] | 85 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 86 | #endif // RTC_BASE_RTCCERTIFICATEGENERATOR_H_ |