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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
// Copyright (c) 2012 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_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_
#define CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_
#include <stdint.h>
#include <memory>
#include <string>
#include <vector>
#include "base/macros.h"
namespace base {
class FilePath;
}
namespace crypto {
class RSAPrivateKey;
}
namespace extensions {
// 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:
ExtensionCreator();
// Settings to specify treatment of special or ignorable error conditions.
enum RunFlags {
kNoRunFlags = 0x0,
kOverwriteCRX = 0x1,
kRequireModernManifestVersion = 0x2,
};
// Categories of error that may need special handling on the UI end.
enum ErrorType { kOtherError, kCRXExists };
bool Run(const base::FilePath& extension_dir,
const base::FilePath& crx_path,
const base::FilePath& private_key_path,
const base::FilePath& private_key_output_path,
int run_flags);
// Returns the error message that will be present if Run(...) returned false.
std::string error_message() { return error_message_; }
ErrorType error_type() { return error_type_; }
private:
// Verifies input directory's existence. |extension_dir| is the source
// directory that should contain all the extension resources. |crx_path| is
// the path to which final crx will be written.
// |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).
// |flags| is a bitset of RunFlags values.
bool InitializeInput(const base::FilePath& extension_dir,
const base::FilePath& crx_path,
const base::FilePath& private_key_path,
const base::FilePath& private_key_output_path,
int run_flags);
// Validates the manifest by trying to load the extension.
bool ValidateManifest(const base::FilePath& extension_dir,
crypto::RSAPrivateKey* key_pair,
int run_flags);
// Reads private key from |private_key_path|.
std::unique_ptr<crypto::RSAPrivateKey> ReadInputKey(
const base::FilePath& private_key_path);
// Generates a key pair and writes the private key to |private_key_path|
// if provided.
std::unique_ptr<crypto::RSAPrivateKey> GenerateKey(
const base::FilePath& private_key_path);
// Creates temporary zip file for the extension.
bool CreateZip(const base::FilePath& extension_dir, const base::FilePath& temp_path,
base::FilePath* zip_path);
// Signs the temporary zip and returns the signature.
bool SignZip(const base::FilePath& zip_path,
crypto::RSAPrivateKey* private_key,
std::vector<uint8_t>* signature);
// Export installable .crx to |crx_path|.
bool WriteCRX(const base::FilePath& zip_path,
crypto::RSAPrivateKey* private_key,
const std::vector<uint8_t>& signature,
const base::FilePath& crx_path);
// Holds a message for any error that is raised during Run(...).
std::string error_message_;
// Type of error that was raised, if any.
ErrorType error_type_;
DISALLOW_COPY_AND_ASSIGN(ExtensionCreator);
};
} // namespace extensions
#endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_CREATOR_H_
|
