mirror of
https://github.com/klzgrad/naiveproxy.git
synced 2024-11-24 14:26:09 +03:00
72 lines
2.7 KiB
C
72 lines
2.7 KiB
C
|
// Copyright 2015 The Chromium Authors. All rights reserved.
|
||
|
|
// Use of this source code is governed by a BSD-style license that can be
|
||
|
|
// found in the LICENSE file.
|
||
|
|
|
||
|
|
#ifndef NET_SSL_SSL_PRIVATE_KEY_H_
|
||
|
|
#define NET_SSL_SSL_PRIVATE_KEY_H_
|
||
|
|
|
||
|
|
#include <stdint.h>
|
||
|
|
|
||
|
|
#include <vector>
|
||
|
|
|
||
|
|
#include "base/callback_forward.h"
|
||
|
|
#include "base/containers/span.h"
|
||
|
|
#include "base/macros.h"
|
||
|
|
#include "base/memory/ref_counted.h"
|
||
|
|
#include "net/base/net_errors.h"
|
||
|
|
#include "net/base/net_export.h"
|
||
|
|
|
||
|
|
namespace net {
|
||
|
|
|
||
|
|
// An interface for a private key for use with SSL client authentication. A
|
||
|
|
// private key may be used with multiple signature algorithms, so methods use
|
||
|
|
// |SSL_SIGN_*| constants from BoringSSL, which correspond to TLS 1.3
|
||
|
|
// SignatureScheme values.
|
||
|
|
//
|
||
|
|
// Note that although ECDSA constants are named like
|
||
|
|
// |SSL_SIGN_ECDSA_SECP256R1_SHA256|, they may be used with any curve for
|
||
|
|
// purposes of this API. This descrepancy is due to differences between TLS 1.2
|
||
|
|
// and TLS 1.3.
|
||
|
|
class NET_EXPORT SSLPrivateKey
|
||
|
|
: public base::RefCountedThreadSafe<SSLPrivateKey> {
|
||
|
|
public:
|
||
|
|
using SignCallback = base::Callback<void(Error, const std::vector<uint8_t>&)>;
|
||
|
|
|
||
|
|
SSLPrivateKey() {}
|
||
|
|
|
||
|
|
// Returns the algorithms that are supported by the key in decreasing
|
||
|
|
// preference for TLS 1.2 and later. Note that |SSL_SIGN_RSA_PKCS1_MD5_SHA1|
|
||
|
|
// is only used by TLS 1.1 and earlier and should not be in this list.
|
||
|
|
virtual std::vector<uint16_t> GetAlgorithmPreferences() = 0;
|
||
|
|
|
||
|
|
// Asynchronously signs an |input| with the specified TLS signing algorithm.
|
||
|
|
// |input| is an unhashed message to be signed. On completion, it calls
|
||
|
|
// |callback| with the signature or an error code if the operation failed.
|
||
|
|
virtual void Sign(uint16_t algorithm,
|
||
|
|
base::span<const uint8_t> input,
|
||
|
|
const SignCallback& callback) = 0;
|
||
|
|
|
||
|
|
// Returns the default signature algorithm preferences for the specified key
|
||
|
|
// type, which should be a BoringSSL |EVP_PKEY_*| constant. RSA keys which use
|
||
|
|
// this must support PKCS #1 v1.5 signatures with SHA-1, SHA-256, SHA-384, and
|
||
|
|
// SHA-512. If |supports_pss| is true, they must additionally support PSS
|
||
|
|
// signatures with SHA-256, SHA-384, and SHA-512. ECDSA keys must support
|
||
|
|
// SHA-256, SHA-384, SHA-512.
|
||
|
|
//
|
||
|
|
// Keys with more specific capabilities or preferences should return a custom
|
||
|
|
// list.
|
||
|
|
static std::vector<uint16_t> DefaultAlgorithmPreferences(int type,
|
||
|
|
bool supports_pss);
|
||
|
|
|
||
|
|
protected:
|
||
|
|
virtual ~SSLPrivateKey() {}
|
||
|
|
|
||
|
|
private:
|
||
|
|
friend class base::RefCountedThreadSafe<SSLPrivateKey>;
|
||
|
|
DISALLOW_COPY_AND_ASSIGN(SSLPrivateKey);
|
||
|
|
};
|
||
|
|
|
||
|
|
} // namespace net
|
||
|
|
|
||
|
|
#endif // NET_SSL_SSL_PRIVATE_KEY_H_
|