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
|
// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef EXTENSIONS_COMMON_MANIFEST_HANDLERS_EXTERNALLY_CONNECTABLE_H_
#define EXTENSIONS_COMMON_MANIFEST_HANDLERS_EXTERNALLY_CONNECTABLE_H_
#include <memory>
#include <string>
#include <vector>
#include "extensions/common/extension.h"
#include "extensions/common/extension_id.h"
#include "extensions/common/install_warning.h"
#include "extensions/common/manifest_handler.h"
#include "extensions/common/url_pattern_set.h"
namespace base {
class Value;
}
namespace extensions {
// Error constants used when parsing the externally_connectable manifest entry.
namespace externally_connectable_errors {
extern const char kErrorInvalid[];
extern const char kErrorInvalidMatchPattern[];
extern const char kErrorInvalidId[];
extern const char kErrorNothingSpecified[];
extern const char kErrorUnusedAcceptsTlsChannelId[];
} // namespace externally_connectable_errors
// Parses the externally_connectable manifest entry.
class ExternallyConnectableHandler : public ManifestHandler {
public:
ExternallyConnectableHandler();
ExternallyConnectableHandler(const ExternallyConnectableHandler&) = delete;
ExternallyConnectableHandler& operator=(const ExternallyConnectableHandler&) =
delete;
~ExternallyConnectableHandler() override;
bool Parse(Extension* extension, std::u16string* error) override;
private:
base::span<const char* const> Keys() const override;
};
// The parsed form of the externally_connectable manifest entry.
struct ExternallyConnectableInfo : public Extension::ManifestData {
public:
// Gets the ExternallyConnectableInfo for `extension`, or NULL if none was
// specified.
static ExternallyConnectableInfo* Get(const Extension* extension);
// Tries to construct the info based on `value`, as it would have appeared in
// the manifest. Sets `error` and returns an empty scoped_ptr on failure.
static std::unique_ptr<ExternallyConnectableInfo> FromValue(
const base::Value& value,
std::vector<InstallWarning>* install_warnings,
std::u16string* error);
ExternallyConnectableInfo(const ExternallyConnectableInfo&) = delete;
ExternallyConnectableInfo& operator=(const ExternallyConnectableInfo&) =
delete;
~ExternallyConnectableInfo() override;
// The URL patterns that are allowed to connect/sendMessage.
const URLPatternSet matches;
// The extension IDs that are allowed to connect/sendMessage. Sorted.
const std::vector<ExtensionId> ids;
// True if any extension is allowed to connect. This would have corresponded
// to an ID of "*" in `ids`.
const bool all_ids;
// True if extension accepts the TLS channel ID, when requested by the
// connecting origin.
const bool accepts_tls_channel_id;
// Returns true if `ids` contains `id` or if `all_ids` is true.
//
// More convenient for callers than checking each individually, and it makes
// use of the sortedness of `ids`.
bool IdCanConnect(const ExtensionId& id);
// Public only for testing. Use FromValue in production.
ExternallyConnectableInfo(URLPatternSet matches,
const std::vector<ExtensionId>& ids,
bool all_ids,
bool accepts_tls_channel_id);
};
} // namespace extensions
#endif // EXTENSIONS_COMMON_MANIFEST_HANDLERS_EXTERNALLY_CONNECTABLE_H_
|
