1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91
|
// Copyright 2015 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef NET_SSL_THREADED_SSL_PRIVATE_KEY_H_
#define NET_SSL_THREADED_SSL_PRIVATE_KEY_H_
#include <stddef.h>
#include <stdint.h>
#include <memory>
#include <vector>
#include "base/containers/span.h"
#include "base/memory/scoped_refptr.h"
#include "base/memory/weak_ptr.h"
#include "net/base/net_export.h"
#include "net/ssl/ssl_private_key.h"
namespace base {
class SingleThreadTaskRunner;
}
namespace net {
// An SSLPrivateKey implementation which offloads key operations to a background
// task runner.
class NET_EXPORT ThreadedSSLPrivateKey : public SSLPrivateKey {
public:
// Interface for consumers to implement to perform the actual signing
// operation.
class Delegate {
public:
Delegate() = default;
Delegate(const Delegate&) = delete;
Delegate& operator=(const Delegate&) = delete;
virtual ~Delegate() = default;
// Returns a human-readable name of the provider that backs this
// SSLPrivateKey, for debugging. If not applicable or available, return the
// empty string.
//
// This method must be efficiently callable on any thread.
virtual std::string GetProviderName() = 0;
// Returns the algorithms that are supported by the key in decreasing
// preference for TLS 1.2 and later.
//
// This method must be efficiently callable on any thread.
virtual std::vector<uint16_t> GetAlgorithmPreferences() = 0;
// Signs an |input| with the specified TLS signing algorithm. |input| is the
// unhashed message to be signed. On success it returns OK and sets
// |signature| to the resulting signature. Otherwise it returns a net error
// code.
//
// This method will only be called on the task runner passed to the owning
// ThreadedSSLPrivateKey.
virtual Error Sign(uint16_t algorithm,
base::span<const uint8_t> input,
std::vector<uint8_t>* signature) = 0;
};
ThreadedSSLPrivateKey(
std::unique_ptr<Delegate> delegate,
scoped_refptr<base::SingleThreadTaskRunner> task_runner);
ThreadedSSLPrivateKey(const ThreadedSSLPrivateKey&) = delete;
ThreadedSSLPrivateKey& operator=(const ThreadedSSLPrivateKey&) = delete;
// SSLPrivateKey implementation.
std::string GetProviderName() override;
std::vector<uint16_t> GetAlgorithmPreferences() override;
void Sign(uint16_t algorithm,
base::span<const uint8_t> input,
SignCallback callback) override;
private:
~ThreadedSSLPrivateKey() override;
class Core;
scoped_refptr<Core> core_;
scoped_refptr<base::SingleThreadTaskRunner> task_runner_;
base::WeakPtrFactory<ThreadedSSLPrivateKey> weak_factory_{this};
};
} // namespace net
#endif // NET_SSL_THREADED_SSL_PRIVATE_KEY_H_
|