| Index: base/crypto/rsa_private_key.h
|
| ===================================================================
|
| --- base/crypto/rsa_private_key.h (revision 81350)
|
| +++ base/crypto/rsa_private_key.h (working copy)
|
| @@ -1,274 +0,0 @@
|
| -// Copyright (c) 2011 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 BASE_CRYPTO_RSA_PRIVATE_KEY_H_
|
| -#define BASE_CRYPTO_RSA_PRIVATE_KEY_H_
|
| -#pragma once
|
| -
|
| -#include "build/build_config.h"
|
| -
|
| -#if defined(USE_OPENSSL)
|
| -// Forward declaration for openssl/*.h
|
| -typedef struct evp_pkey_st EVP_PKEY;
|
| -#elif defined(USE_NSS)
|
| -// Forward declaration.
|
| -struct SECKEYPrivateKeyStr;
|
| -struct SECKEYPublicKeyStr;
|
| -#elif defined(OS_MACOSX)
|
| -#include <Security/cssm.h>
|
| -#endif
|
| -
|
| -#include <list>
|
| -#include <vector>
|
| -
|
| -#include "base/base_api.h"
|
| -#include "base/basictypes.h"
|
| -
|
| -#if defined(OS_WIN)
|
| -#include "base/crypto/scoped_capi_types.h"
|
| -#endif
|
| -#if defined(USE_NSS)
|
| -#include "base/gtest_prod_util.h"
|
| -#endif
|
| -
|
| -namespace base {
|
| -
|
| -// Used internally by RSAPrivateKey for serializing and deserializing
|
| -// PKCS #8 PrivateKeyInfo and PublicKeyInfo.
|
| -class BASE_API PrivateKeyInfoCodec {
|
| - public:
|
| -
|
| - // ASN.1 encoding of the AlgorithmIdentifier from PKCS #8.
|
| - static const uint8 kRsaAlgorithmIdentifier[];
|
| -
|
| - // ASN.1 tags for some types we use.
|
| - static const uint8 kBitStringTag = 0x03;
|
| - static const uint8 kIntegerTag = 0x02;
|
| - static const uint8 kNullTag = 0x05;
|
| - static const uint8 kOctetStringTag = 0x04;
|
| - static const uint8 kSequenceTag = 0x30;
|
| -
|
| - // |big_endian| here specifies the byte-significance of the integer components
|
| - // that will be parsed & serialized (modulus(), etc...) during Import(),
|
| - // Export() and ExportPublicKeyInfo() -- not the ASN.1 DER encoding of the
|
| - // PrivateKeyInfo/PublicKeyInfo (which is always big-endian).
|
| - explicit PrivateKeyInfoCodec(bool big_endian);
|
| -
|
| - ~PrivateKeyInfoCodec();
|
| -
|
| - // Exports the contents of the integer components to the ASN.1 DER encoding
|
| - // of the PrivateKeyInfo structure to |output|.
|
| - bool Export(std::vector<uint8>* output);
|
| -
|
| - // Exports the contents of the integer components to the ASN.1 DER encoding
|
| - // of the PublicKeyInfo structure to |output|.
|
| - bool ExportPublicKeyInfo(std::vector<uint8>* output);
|
| -
|
| - // Exports the contents of the integer components to the ASN.1 DER encoding
|
| - // of the RSAPublicKey structure to |output|.
|
| - bool ExportPublicKey(std::vector<uint8>* output);
|
| -
|
| - // Parses the ASN.1 DER encoding of the PrivateKeyInfo structure in |input|
|
| - // and populates the integer components with |big_endian_| byte-significance.
|
| - // IMPORTANT NOTE: This is currently *not* security-approved for importing
|
| - // keys from unstrusted sources.
|
| - bool Import(const std::vector<uint8>& input);
|
| -
|
| - // Accessors to the contents of the integer components of the PrivateKeyInfo
|
| - // structure.
|
| - std::vector<uint8>* modulus() { return &modulus_; };
|
| - std::vector<uint8>* public_exponent() { return &public_exponent_; };
|
| - std::vector<uint8>* private_exponent() { return &private_exponent_; };
|
| - std::vector<uint8>* prime1() { return &prime1_; };
|
| - std::vector<uint8>* prime2() { return &prime2_; };
|
| - std::vector<uint8>* exponent1() { return &exponent1_; };
|
| - std::vector<uint8>* exponent2() { return &exponent2_; };
|
| - std::vector<uint8>* coefficient() { return &coefficient_; };
|
| -
|
| - private:
|
| - // Utility wrappers for PrependIntegerImpl that use the class's |big_endian_|
|
| - // value.
|
| - void PrependInteger(const std::vector<uint8>& in, std::list<uint8>* out);
|
| - void PrependInteger(uint8* val, int num_bytes, std::list<uint8>* data);
|
| -
|
| - // Prepends the integer stored in |val| - |val + num_bytes| with |big_endian|
|
| - // byte-significance into |data| as an ASN.1 integer.
|
| - void PrependIntegerImpl(uint8* val,
|
| - int num_bytes,
|
| - std::list<uint8>* data,
|
| - bool big_endian);
|
| -
|
| - // Utility wrappers for ReadIntegerImpl that use the class's |big_endian_|
|
| - // value.
|
| - bool ReadInteger(uint8** pos, uint8* end, std::vector<uint8>* out);
|
| - bool ReadIntegerWithExpectedSize(uint8** pos,
|
| - uint8* end,
|
| - size_t expected_size,
|
| - std::vector<uint8>* out);
|
| -
|
| - // Reads an ASN.1 integer from |pos|, and stores the result into |out| with
|
| - // |big_endian| byte-significance.
|
| - bool ReadIntegerImpl(uint8** pos,
|
| - uint8* end,
|
| - std::vector<uint8>* out,
|
| - bool big_endian);
|
| -
|
| - // Prepends the integer stored in |val|, starting a index |start|, for
|
| - // |num_bytes| bytes onto |data|.
|
| - void PrependBytes(uint8* val,
|
| - int start,
|
| - int num_bytes,
|
| - std::list<uint8>* data);
|
| -
|
| - // Helper to prepend an ASN.1 length field.
|
| - void PrependLength(size_t size, std::list<uint8>* data);
|
| -
|
| - // Helper to prepend an ASN.1 type header.
|
| - void PrependTypeHeaderAndLength(uint8 type,
|
| - uint32 length,
|
| - std::list<uint8>* output);
|
| -
|
| - // Helper to prepend an ASN.1 bit string
|
| - void PrependBitString(uint8* val, int num_bytes, std::list<uint8>* output);
|
| -
|
| - // Read an ASN.1 length field. This also checks that the length does not
|
| - // extend beyond |end|.
|
| - bool ReadLength(uint8** pos, uint8* end, uint32* result);
|
| -
|
| - // Read an ASN.1 type header and its length.
|
| - bool ReadTypeHeaderAndLength(uint8** pos,
|
| - uint8* end,
|
| - uint8 expected_tag,
|
| - uint32* length);
|
| -
|
| - // Read an ASN.1 sequence declaration. This consumes the type header and
|
| - // length field, but not the contents of the sequence.
|
| - bool ReadSequence(uint8** pos, uint8* end);
|
| -
|
| - // Read the RSA AlgorithmIdentifier.
|
| - bool ReadAlgorithmIdentifier(uint8** pos, uint8* end);
|
| -
|
| - // Read one of the two version fields in PrivateKeyInfo.
|
| - bool ReadVersion(uint8** pos, uint8* end);
|
| -
|
| - // The byte-significance of the stored components (modulus, etc..).
|
| - bool big_endian_;
|
| -
|
| - // Component integers of the PrivateKeyInfo
|
| - std::vector<uint8> modulus_;
|
| - std::vector<uint8> public_exponent_;
|
| - std::vector<uint8> private_exponent_;
|
| - std::vector<uint8> prime1_;
|
| - std::vector<uint8> prime2_;
|
| - std::vector<uint8> exponent1_;
|
| - std::vector<uint8> exponent2_;
|
| - std::vector<uint8> coefficient_;
|
| -
|
| - DISALLOW_COPY_AND_ASSIGN(PrivateKeyInfoCodec);
|
| -};
|
| -
|
| -// Encapsulates an RSA private key. Can be used to generate new keys, export
|
| -// keys to other formats, or to extract a public key.
|
| -// TODO(hclam): This class should be ref-counted so it can be reused easily.
|
| -class BASE_API RSAPrivateKey {
|
| - public:
|
| - ~RSAPrivateKey();
|
| -
|
| - // Create a new random instance. Can return NULL if initialization fails.
|
| - static RSAPrivateKey* Create(uint16 num_bits);
|
| -
|
| - // Create a new random instance. Can return NULL if initialization fails.
|
| - // The created key is permanent and is not exportable in plaintext form.
|
| - //
|
| - // NOTE: Currently only available if USE_NSS is defined.
|
| - static RSAPrivateKey* CreateSensitive(uint16 num_bits);
|
| -
|
| - // Create a new instance by importing an existing private key. The format is
|
| - // an ASN.1-encoded PrivateKeyInfo block from PKCS #8. This can return NULL if
|
| - // initialization fails.
|
| - static RSAPrivateKey* CreateFromPrivateKeyInfo(
|
| - const std::vector<uint8>& input);
|
| -
|
| - // Create a new instance by importing an existing private key. The format is
|
| - // an ASN.1-encoded PrivateKeyInfo block from PKCS #8. This can return NULL if
|
| - // initialization fails.
|
| - // The created key is permanent and is not exportable in plaintext form.
|
| - //
|
| - // NOTE: Currently only available if USE_NSS is defined.
|
| - static RSAPrivateKey* CreateSensitiveFromPrivateKeyInfo(
|
| - const std::vector<uint8>& input);
|
| -
|
| - // Import an existing public key, and then search for the private
|
| - // half in the key database. The format of the public key blob is is
|
| - // an X509 SubjectPublicKeyInfo block. This can return NULL if
|
| - // initialization fails or the private key cannot be found. The
|
| - // caller takes ownership of the returned object, but nothing new is
|
| - // created in the key database.
|
| - //
|
| - // NOTE: Currently only available if USE_NSS is defined.
|
| - static RSAPrivateKey* FindFromPublicKeyInfo(
|
| - const std::vector<uint8>& input);
|
| -
|
| -#if defined(USE_OPENSSL)
|
| - EVP_PKEY* key() { return key_; }
|
| -#elif defined(USE_NSS)
|
| - SECKEYPrivateKeyStr* key() { return key_; }
|
| - SECKEYPublicKeyStr* public_key() { return public_key_; }
|
| -#elif defined(OS_WIN)
|
| - HCRYPTPROV provider() { return provider_; }
|
| - HCRYPTKEY key() { return key_; }
|
| -#elif defined(OS_MACOSX)
|
| - CSSM_KEY_PTR key() { return &key_; }
|
| - CSSM_KEY_PTR public_key() { return &public_key_; }
|
| -#endif
|
| -
|
| - // Exports the private key to a PKCS #1 PrivateKey block.
|
| - bool ExportPrivateKey(std::vector<uint8>* output);
|
| -
|
| - // Exports the public key to an X509 SubjectPublicKeyInfo block.
|
| - bool ExportPublicKey(std::vector<uint8>* output);
|
| -
|
| - private:
|
| -#if defined(USE_NSS)
|
| - FRIEND_TEST_ALL_PREFIXES(RSAPrivateKeyNSSTest, FindFromPublicKey);
|
| - FRIEND_TEST_ALL_PREFIXES(RSAPrivateKeyNSSTest, FailedFindFromPublicKey);
|
| -#endif
|
| -
|
| - // Constructor is private. Use one of the Create*() or Find*()
|
| - // methods above instead.
|
| - RSAPrivateKey();
|
| -
|
| - // Shared helper for Create() and CreateSensitive().
|
| - // TODO(cmasone): consider replacing |permanent| and |sensitive| with a
|
| - // flags arg created by ORing together some enumerated values.
|
| - static RSAPrivateKey* CreateWithParams(uint16 num_bits,
|
| - bool permanent,
|
| - bool sensitive);
|
| -
|
| - // Shared helper for CreateFromPrivateKeyInfo() and
|
| - // CreateSensitiveFromPrivateKeyInfo().
|
| - static RSAPrivateKey* CreateFromPrivateKeyInfoWithParams(
|
| - const std::vector<uint8>& input, bool permanent, bool sensitive);
|
| -
|
| -#if defined(USE_OPENSSL)
|
| - EVP_PKEY* key_;
|
| -#elif defined(USE_NSS)
|
| - SECKEYPrivateKeyStr* key_;
|
| - SECKEYPublicKeyStr* public_key_;
|
| -#elif defined(OS_WIN)
|
| - bool InitProvider();
|
| -
|
| - ScopedHCRYPTPROV provider_;
|
| - ScopedHCRYPTKEY key_;
|
| -#elif defined(OS_MACOSX)
|
| - CSSM_KEY key_;
|
| - CSSM_KEY public_key_;
|
| -#endif
|
| -
|
| - DISALLOW_COPY_AND_ASSIGN(RSAPrivateKey);
|
| -};
|
| -
|
| -} // namespace base
|
| -
|
| -#endif // BASE_CRYPTO_RSA_PRIVATE_KEY_H_
|
|
|