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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
// 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 EXTENSIONS_BROWSER_EXTENSION_CREATOR_H_
#define EXTENSIONS_BROWSER_EXTENSION_CREATOR_H_
#include <stdint.h>
#include <memory>
#include <string>
#include <vector>
#include "base/macros.h"
#include "third_party/abseil-cpp/absl/types/optional.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 = 0,
kOverwriteCRX = 1 << 0,
kRequireModernManifestVersion = 1 << 1,
kBookmarkApp = 1 << 2,
kSystemApp = 1 << 3,
};
// 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);
// Create a CRX3 file at |crx_path|, using the contents of the unpacked
// extension located at |extension_dir|. Creates a random signing key and sets
// |extension_id| according to it.
bool CreateCrxWithVerifiedContentsInHeaderForTesting(
const base::FilePath& extension_dir,
const base::FilePath& crx_path,
const std::string& compressed_verified_contents,
std::string* extension_id);
// 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:
friend class ExtensionCreatorTest;
// 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);
// Creates a CRX file at |crx_path|, signed with |private_key| and with the
// contents of the archive at |zip_path|. Injects
// |compressed_verified_contents| in the header if it not equal to
// absl::nullopt.
bool CreateCrx(
const base::FilePath& zip_path,
crypto::RSAPrivateKey* private_key,
const base::FilePath& crx_path,
const absl::optional<std::string>& compressed_verified_contents);
// Creates a temporary directory to store zipped extension and then creates
// CRX using the zipped extension.
bool CreateCrxAndPerformCleanup(
const base::FilePath& extension_dir,
const base::FilePath& crx_path,
crypto::RSAPrivateKey* private_key,
const absl::optional<std::string>& compressed_verified_contents);
// 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 // EXTENSIONS_BROWSER_EXTENSION_CREATOR_H_
|
