File: install_approval.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (116 lines) | stat: -rw-r--r-- 4,230 bytes parent folder | download | duplicates (5)
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
// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_EXTENSIONS_INSTALL_APPROVAL_H_
#define CHROME_BROWSER_EXTENSIONS_INSTALL_APPROVAL_H_

#include <memory>
#include <string>

#include "base/memory/raw_ptr.h"
#include "base/memory/scoped_refptr.h"
#include "base/supports_user_data.h"
#include "base/values.h"
#include "chrome/browser/extensions/extension_install_prompt.h"
#include "chrome/browser/extensions/manifest_check_level.h"
#include "extensions/buildflags/buildflags.h"
#include "extensions/common/extension_id.h"
#include "ui/gfx/image/image_skia.h"

static_assert(BUILDFLAG(ENABLE_EXTENSIONS_CORE));

class Profile;

namespace base {
class Version;
}

namespace extensions {

class Manifest;

// Contains information about what parts of the extension install process can be
// skipped or modified. Captures the information about the extension install
// that the user approved, so that we can compare that information against the
// extension downloaded in case there was a gap in time between when the install
// was approved and the CRX was downloaded.
struct InstallApproval : public base::SupportsUserData::Data {
  static std::unique_ptr<InstallApproval> CreateWithInstallPrompt(
      Profile* profile);

  // Creates an InstallApproval for installing a shared module.
  static std::unique_ptr<InstallApproval> CreateForSharedModule(
      Profile* profile);

  // Creates an InstallApproval that will skip putting up an install
  // confirmation prompt if the actual manifest from the extension to be
  // installed matches `parsed_manifest`. The `strict_manifest_check` controls
  // whether we want to require an exact manifest match, or are willing to
  // tolerate a looser check just that the effective permissions are the same.
  static std::unique_ptr<InstallApproval> CreateWithNoInstallPrompt(
      Profile* profile,
      const ExtensionId& extension_id,
      base::Value::Dict parsed_manifest,
      bool strict_manifest_check);

  ~InstallApproval() override;

  // The extension id that was approved for installation.
  ExtensionId extension_id;

  // The profile the extension should be installed into.
  raw_ptr<Profile> profile = nullptr;

  // The expected manifest, before localization.
  std::unique_ptr<Manifest> manifest;

  // Whether to use a bubble notification when an app is installed, instead of
  // the default behavior of transitioning to the new tab page.
  bool use_app_installed_bubble = false;

  // Whether to skip the post install UI like the extension installed bubble.
  bool skip_post_install_ui = false;

  // Whether to skip the install dialog once the extension has been downloaded
  // and unpacked. One reason this can be true is that in the normal webstore
  // installation, the dialog is shown earlier, before any download is done,
  // so there's no need to show it again.
  bool skip_install_dialog = false;

  // Manifest check level for checking actual manifest against expected
  // manifest.
  ManifestCheckLevel manifest_check_level = ManifestCheckLevel::kStrict;

  // Used to show the install dialog.
  ExtensionInstallPrompt::ShowDialogCallback show_dialog_callback;

  // The icon to use to display the extension while it is installing.
  gfx::ImageSkia installing_icon;

  // A dummy extension created from `manifest`;
  scoped_refptr<Extension> dummy_extension;

  // Required minimum version.
  std::unique_ptr<base::Version> minimum_version;

  // The authuser index required to download the item being installed. May be
  // the empty string, in which case no authuser parameter is used.
  std::string authuser;

  // Whether the user clicked through the install friction dialog when the
  // extension is not included in the Enhanced Safe Browsing CRX allowlist and
  // the user has enabled Enhanced Protection.
  bool bypassed_safebrowsing_friction = false;

  // Whether to withhold permissions at installation. By default, permissions
  // are granted at installation.
  bool withhold_permissions = false;

 private:
  InstallApproval();
};

}  // namespace extensions

#endif  // CHROME_BROWSER_EXTENSIONS_INSTALL_APPROVAL_H_