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
|
// Copyright (c) 2009 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 CHROME_COMMON_EXTENSIONS_EXTENSION_CREATOR_H_
#define CHROME_COMMON_EXTENSIONS_EXTENSION_CREATOR_H_
#include "base/command_line.h"
#include "base/crypto/rsa_private_key.h"
#include "base/file_path.h"
#include "base/values.h"
// This class create an installable extension (.crx file) given an input
// directory that contains a valid manifest.json and the extension's resources
// contained within that directory. The output .crx file is always signed with a
// private key that is either provided in |private_key_path| or is internal
// generated randomly (and optionally written to |output_private_key_path|.
class ExtensionCreator {
public:
// The size of the magic character sequence at the beginning of each crx file,
// in bytes. This should be a multiple of 4.
static const size_t kExtensionHeaderMagicSize = 4;
// The magic character sequence at the beginning of each crx file.
static const char kExtensionHeaderMagic[];
// The current version of the crx format.
static const uint32 kCurrentVersion = 2;
// This header is the first data at the beginning of an extension. Its
// contents are purposely 32-bit aligned so that it can just be slurped into
// a struct without manual parsing.
struct ExtensionHeader {
char magic[kExtensionHeaderMagicSize];
uint32 version;
size_t key_size; // The size of the public key, in bytes.
size_t signature_size; // The size of the signature, in bytes.
// An ASN.1-encoded PublicKeyInfo structure follows.
// The signature follows.
};
ExtensionCreator() {}
bool Run(const FilePath& extension_dir,
const FilePath& crx_path,
const FilePath& private_key_path,
const FilePath& private_key_output_path);
// Returns the error message that will be present if Run(...) returned false.
std::string error_message() { return error_message_; }
private:
// Verifies input directory's existance. |extension_dir| is the source
// directory that should contain all the extension resources.
// |private_key_path| is the optional path to an existing private key to sign
// the extension. If not provided, a random key will be created (in which case
// it is written to |private_key_output_path| -- if provided).
bool InitializeInput(const FilePath& extension_dir,
const FilePath& private_key_path,
const FilePath& private_key_output_path);
// Reads private key from |private_key_path|.
base::RSAPrivateKey* ReadInputKey(const FilePath& private_key_path);
// Generates a key pair and writes the private key to |private_key_path|
// if provided.
base::RSAPrivateKey* GenerateKey(const FilePath& private_key_path);
// Creates temporary zip file for the extension.
bool CreateZip(const FilePath& extension_dir, FilePath* zip_path);
// Signs the temporary zip and returns the signature.
bool SignZip(const FilePath& zip_path,
base::RSAPrivateKey* private_key,
std::vector<uint8>* signature);
// Export installable .crx to |crx_path|.
bool WriteCRX(const FilePath& zip_path,
base::RSAPrivateKey* private_key,
const std::vector<uint8>& signature,
const FilePath& crx_path);
// Holds a message for any error that is raised during Run(...).
std::string error_message_;
DISALLOW_COPY_AND_ASSIGN(ExtensionCreator);
};
#endif // CHROME_COMMON_EXTENSIONS_EXTENSION_CREATOR_H_
|
