1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef CRYPTO_EC_SIGNATURE_CREATOR_H_
6 #define CRYPTO_EC_SIGNATURE_CREATOR_H_
14 #include "crypto/crypto_export.h"
19 class ECSignatureCreator;
21 class CRYPTO_EXPORT ECSignatureCreatorFactory {
23 virtual ~ECSignatureCreatorFactory() {}
25 virtual std::unique_ptr<ECSignatureCreator> Create(ECPrivateKey* key) = 0;
28 // Signs data using a bare private key (as opposed to a full certificate).
29 // We need this class because SignatureCreator is hardcoded to use
31 class CRYPTO_EXPORT ECSignatureCreator {
33 virtual ~ECSignatureCreator() {}
35 // Create an instance. The caller must ensure that the provided PrivateKey
36 // instance outlives the created ECSignatureCreator.
37 // TODO(rch): This is currently hard coded to use SHA256. Ideally, we should
38 // pass in the hash algorithm identifier.
39 static std::unique_ptr<ECSignatureCreator> Create(ECPrivateKey* key);
41 // Set a factory to make the Create function return non-standard
42 // ECSignatureCreator objects. Because the ECDSA algorithm involves
43 // randomness, this is useful for higher-level tests that want to have
44 // deterministic mocked output to compare.
45 static void SetFactoryForTesting(ECSignatureCreatorFactory* factory);
47 // Signs |data_len| bytes from |data| and writes the results into
48 // |signature| as a DER encoded ECDSA-Sig-Value from RFC 3279.
50 // ECDSA-Sig-Value ::= SEQUENCE {
53 virtual bool Sign(const uint8_t* data,
55 std::vector<uint8_t>* signature) = 0;
57 // DecodeSignature converts from a DER encoded ECDSA-Sig-Value (as produced
58 // by Sign) to a `raw' ECDSA signature which consists of a pair of
59 // big-endian, zero-padded, 256-bit integers, r and s. On success it returns
60 // true and puts the raw signature into |out_raw_sig|.
61 // (Only P-256 signatures are supported.)
62 virtual bool DecodeSignature(const std::vector<uint8_t>& signature,
63 std::vector<uint8_t>* out_raw_sig) = 0;
68 #endif // CRYPTO_EC_SIGNATURE_CREATOR_H_