15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef CRYPTO_RSA_PRIVATE_KEY_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CRYPTO_RSA_PRIVATE_KEY_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "build/build_config.h" 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <list> 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector> 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "crypto/crypto_export.h" 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#if defined(USE_NSS) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/gtest_prod_util.h" 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 20eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#if defined(USE_OPENSSL) 21eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// Forward declaration for openssl/*.h 22eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdochtypedef struct evp_pkey_st EVP_PKEY; 23f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#else 24eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch// Forward declaration. 25f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)typedef struct PK11SlotInfoStr PK11SlotInfo; 26eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdochtypedef struct SECKEYPrivateKeyStr SECKEYPrivateKey; 27eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdochtypedef struct SECKEYPublicKeyStr SECKEYPublicKey; 28eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#endif 29eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 30eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace crypto { 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Used internally by RSAPrivateKey for serializing and deserializing 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// PKCS #8 PrivateKeyInfo and PublicKeyInfo. 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class PrivateKeyInfoCodec { 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ASN.1 encoding of the AlgorithmIdentifier from PKCS #8. 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const uint8 kRsaAlgorithmIdentifier[]; 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // ASN.1 tags for some types we use. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const uint8 kBitStringTag = 0x03; 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const uint8 kIntegerTag = 0x02; 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const uint8 kNullTag = 0x05; 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const uint8 kOctetStringTag = 0x04; 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static const uint8 kSequenceTag = 0x30; 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |big_endian| here specifies the byte-significance of the integer components 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // that will be parsed & serialized (modulus(), etc...) during Import(), 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Export() and ExportPublicKeyInfo() -- not the ASN.1 DER encoding of the 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // PrivateKeyInfo/PublicKeyInfo (which is always big-endian). 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit PrivateKeyInfoCodec(bool big_endian); 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~PrivateKeyInfoCodec(); 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Exports the contents of the integer components to the ASN.1 DER encoding 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // of the PrivateKeyInfo structure to |output|. 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool Export(std::vector<uint8>* output); 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Exports the contents of the integer components to the ASN.1 DER encoding 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // of the PublicKeyInfo structure to |output|. 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ExportPublicKeyInfo(std::vector<uint8>* output); 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Exports the contents of the integer components to the ASN.1 DER encoding 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // of the RSAPublicKey structure to |output|. 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ExportPublicKey(std::vector<uint8>* output); 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Parses the ASN.1 DER encoding of the PrivateKeyInfo structure in |input| 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and populates the integer components with |big_endian_| byte-significance. 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // IMPORTANT NOTE: This is currently *not* security-approved for importing 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // keys from unstrusted sources. 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool Import(const std::vector<uint8>& input); 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Accessors to the contents of the integer components of the PrivateKeyInfo 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // structure. 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* modulus() { return &modulus_; }; 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* public_exponent() { return &public_exponent_; }; 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* private_exponent() { return &private_exponent_; }; 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* prime1() { return &prime1_; }; 805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* prime2() { return &prime2_; }; 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* exponent1() { return &exponent1_; }; 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* exponent2() { return &exponent2_; }; 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* coefficient() { return &coefficient_; }; 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Utility wrappers for PrependIntegerImpl that use the class's |big_endian_| 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // value. 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void PrependInteger(const std::vector<uint8>& in, std::list<uint8>* out); 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void PrependInteger(uint8* val, int num_bytes, std::list<uint8>* data); 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Prepends the integer stored in |val| - |val + num_bytes| with |big_endian| 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // byte-significance into |data| as an ASN.1 integer. 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void PrependIntegerImpl(uint8* val, 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_bytes, 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::list<uint8>* data, 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool big_endian); 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Utility wrappers for ReadIntegerImpl that use the class's |big_endian_| 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // value. 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadInteger(uint8** pos, uint8* end, std::vector<uint8>* out); 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadIntegerWithExpectedSize(uint8** pos, 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8* end, 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t expected_size, 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* out); 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reads an ASN.1 integer from |pos|, and stores the result into |out| with 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |big_endian| byte-significance. 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadIntegerImpl(uint8** pos, 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8* end, 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8>* out, 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool big_endian); 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Prepends the integer stored in |val|, starting a index |start|, for 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |num_bytes| bytes onto |data|. 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void PrependBytes(uint8* val, 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int start, 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int num_bytes, 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::list<uint8>* data); 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Helper to prepend an ASN.1 length field. 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void PrependLength(size_t size, std::list<uint8>* data); 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Helper to prepend an ASN.1 type header. 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void PrependTypeHeaderAndLength(uint8 type, 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32 length, 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::list<uint8>* output); 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Helper to prepend an ASN.1 bit string 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void PrependBitString(uint8* val, int num_bytes, std::list<uint8>* output); 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Read an ASN.1 length field. This also checks that the length does not 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // extend beyond |end|. 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadLength(uint8** pos, uint8* end, uint32* result); 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Read an ASN.1 type header and its length. 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadTypeHeaderAndLength(uint8** pos, 1375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8* end, 1385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint8 expected_tag, 1395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32* length); 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Read an ASN.1 sequence declaration. This consumes the type header and 1425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // length field, but not the contents of the sequence. 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadSequence(uint8** pos, uint8* end); 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Read the RSA AlgorithmIdentifier. 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadAlgorithmIdentifier(uint8** pos, uint8* end); 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Read one of the two version fields in PrivateKeyInfo. 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ReadVersion(uint8** pos, uint8* end); 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The byte-significance of the stored components (modulus, etc..). 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool big_endian_; 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Component integers of the PrivateKeyInfo 1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> modulus_; 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> public_exponent_; 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> private_exponent_; 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> prime1_; 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> prime2_; 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> exponent1_; 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> exponent2_; 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<uint8> coefficient_; 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(PrivateKeyInfoCodec); 1655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Encapsulates an RSA private key. Can be used to generate new keys, export 1685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// keys to other formats, or to extract a public key. 1695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(hclam): This class should be ref-counted so it can be reused easily. 1705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class CRYPTO_EXPORT RSAPrivateKey { 1715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 1725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~RSAPrivateKey(); 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Create a new random instance. Can return NULL if initialization fails. 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static RSAPrivateKey* Create(uint16 num_bits); 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Create a new instance by importing an existing private key. The format is 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // an ASN.1-encoded PrivateKeyInfo block from PKCS #8. This can return NULL if 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // initialization fails. 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static RSAPrivateKey* CreateFromPrivateKeyInfo( 1815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::vector<uint8>& input); 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 183eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#if defined(USE_NSS) 184f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Create a new random instance in |slot|. Can return NULL if initialization 185f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // fails. The created key is permanent and is not exportable in plaintext 186f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // form. 187f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) static RSAPrivateKey* CreateSensitive(PK11SlotInfo* slot, uint16 num_bits); 188f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 189f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Create a new instance in |slot| by importing an existing private key. The 190f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // format is an ASN.1-encoded PrivateKeyInfo block from PKCS #8. This can 191f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // return NULL if initialization fails. 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The created key is permanent and is not exportable in plaintext form. 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static RSAPrivateKey* CreateSensitiveFromPrivateKeyInfo( 194f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) PK11SlotInfo* slot, 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::vector<uint8>& input); 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 197b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // Create a new instance by referencing an existing private key 198b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) // structure. Does not import the key. 199b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) static RSAPrivateKey* CreateFromKey(SECKEYPrivateKey* key); 200b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Import an existing public key, and then search for the private 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // half in the key database. The format of the public key blob is is 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // an X509 SubjectPublicKeyInfo block. This can return NULL if 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // initialization fails or the private key cannot be found. The 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // caller takes ownership of the returned object, but nothing new is 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // created in the key database. 2075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static RSAPrivateKey* FindFromPublicKeyInfo( 2085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::vector<uint8>& input); 209cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) 210cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // Import an existing public key, and then search for the private 211cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // half in the slot specified by |slot|. The format of the public 212cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // key blob is is an X509 SubjectPublicKeyInfo block. This can return 213cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // NULL if initialization fails or the private key cannot be found. 214cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // The caller takes ownership of the returned object, but nothing new 215cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // is created in the slot. 216cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) static RSAPrivateKey* FindFromPublicKeyInfoInSlot( 217cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) const std::vector<uint8>& input, 218cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) PK11SlotInfo* slot); 2191320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci#elif defined(USE_OPENSSL) 2201320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci // Create a new instance from an existing EVP_PKEY, taking a 2211320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci // reference to it. |key| must be an RSA key. Returns NULL on 2221320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci // failure. 2231320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci static RSAPrivateKey* CreateFromKey(EVP_PKEY* key); 2241320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci 225eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#endif 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#if defined(USE_OPENSSL) 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) EVP_PKEY* key() { return key_; } 229f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#else 230b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) SECKEYPrivateKey* key() { return key_; } 231b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) SECKEYPublicKey* public_key() { return public_key_; } 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Creates a copy of the object. 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RSAPrivateKey* Copy() const; 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Exports the private key to a PKCS #1 PrivateKey block. 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ExportPrivateKey(std::vector<uint8>* output) const; 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Exports the public key to an X509 SubjectPublicKeyInfo block. 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ExportPublicKey(std::vector<uint8>* output) const; 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#if defined(USE_NSS) 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FRIEND_TEST_ALL_PREFIXES(RSAPrivateKeyNSSTest, FindFromPublicKey); 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FRIEND_TEST_ALL_PREFIXES(RSAPrivateKeyNSSTest, FailedFindFromPublicKey); 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 2485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Constructor is private. Use one of the Create*() or Find*() 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // methods above instead. 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RSAPrivateKey(); 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 253f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#if !defined(USE_OPENSSL) 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Shared helper for Create() and CreateSensitive(). 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // TODO(cmasone): consider replacing |permanent| and |sensitive| with a 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // flags arg created by ORing together some enumerated values. 257eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch // Note: |permanent| is only supported when USE_NSS is defined. 258f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) static RSAPrivateKey* CreateWithParams(PK11SlotInfo* slot, 259f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) uint16 num_bits, 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool permanent, 2615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool sensitive); 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Shared helper for CreateFromPrivateKeyInfo() and 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // CreateSensitiveFromPrivateKeyInfo(). 265eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch // Note: |permanent| is only supported when USE_NSS is defined. 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static RSAPrivateKey* CreateFromPrivateKeyInfoWithParams( 267f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) PK11SlotInfo* slot, 268eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch const std::vector<uint8>& input, 269eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch bool permanent, 270eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch bool sensitive); 271f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#endif 2725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 273cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles)#if defined(USE_NSS) 274cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // Import an existing public key. The format of the public key blob 275cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // is an X509 SubjectPublicKeyInfo block. This can return NULL if 276cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // initialization fails. The caller takes ownership of the returned 277cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) // object. Note that this method doesn't initialize the |key_| member. 278cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) static RSAPrivateKey* InitPublicPart(const std::vector<uint8>& input); 279cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles)#endif 280cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles) 2815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#if defined(USE_OPENSSL) 2825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) EVP_PKEY* key_; 283f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)#else 284b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) SECKEYPrivateKey* key_; 285b2df76ea8fec9e32f6f3718986dba0d95315b29cTorne (Richard Coles) SECKEYPublicKey* public_key_; 2865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif 2875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(RSAPrivateKey); 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 2905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace crypto 2925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // CRYPTO_RSA_PRIVATE_KEY_H_ 294