src/chrome/common/extensions/permissions/chrome_api_permissions.cc

   1 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #include "chrome/common/extensions/permissions/chrome_api_permissions.h"
   6
   7 #include "chrome/common/extensions/permissions/bluetooth_permission.h"
   8 #include "chrome/common/extensions/permissions/media_galleries_permission.h"
   9 #include "chrome/common/extensions/permissions/socket_permission.h"
  10 #include "chrome/common/extensions/permissions/usb_device_permission.h"
  11 #include "extensions/common/permissions/api_permission.h"
  12 #include "extensions/common/permissions/api_permission_set.h"
  13 #include "extensions/common/permissions/permission_message.h"
  14 #include "extensions/common/permissions/permissions_info.h"
  15 #include "grit/generated_resources.h"
  16
  17 namespace extensions {
  18
  19 namespace {
  20
  21 const char kOldUnlimitedStoragePermission[] = "unlimited_storage";
  22 const char kWindowsPermission[] = "windows";
  23
  24 template<typename T> APIPermission* CreateAPIPermission(
  25     const APIPermissionInfo* permission) {
  26   return new T(permission);
  27 }
  28
  29 }  // namespace
  30
  31 std::vector<APIPermissionInfo*> ChromeAPIPermissions::GetAllPermissions()
  32     const {
  33   struct PermissionRegistration {
  34     APIPermission::ID id;
  35     const char* name;
  36     int flags;
  37     int l10n_message_id;
  38     PermissionMessage::ID message_id;
  39     APIPermissionInfo::APIPermissionConstructor constructor;
  40   } PermissionsToRegister[] = {
  41     // Register permissions for all extension types.
  42     { APIPermission::kBackground, "background" },
  43     { APIPermission::kClipboardRead, "clipboardRead",
  44       APIPermissionInfo::kFlagNone,
  45       IDS_EXTENSION_PROMPT_WARNING_CLIPBOARD,
  46       PermissionMessage::kClipboard },
  47     { APIPermission::kClipboardWrite, "clipboardWrite" },
  48     { APIPermission::kDeclarativeContent, "declarativeContent" },
  49     { APIPermission::kDeclarativeWebRequest, "declarativeWebRequest",
  50       APIPermissionInfo::kFlagNone,
  51       IDS_EXTENSION_PROMPT_WARNING_DECLARATIVE_WEB_REQUEST,
  52       PermissionMessage::kDeclarativeWebRequest },
  53     { APIPermission::kDesktopCapture, "desktopCapture",
  54       APIPermissionInfo::kFlagNone,
  55       IDS_EXTENSION_PROMPT_WARNING_DESKTOP_CAPTURE,
  56       PermissionMessage::kDesktopCapture },
  57     { APIPermission::kDns, "dns" },
  58     { APIPermission::kDownloads, "downloads", APIPermissionInfo::kFlagNone,
  59       IDS_EXTENSION_PROMPT_WARNING_DOWNLOADS,
  60       PermissionMessage::kDownloads },
  61     { APIPermission::kDownloadsOpen, "downloads.open",
  62       APIPermissionInfo::kFlagNone,
  63       IDS_EXTENSION_PROMPT_WARNING_DOWNLOADS_OPEN,
  64       PermissionMessage::kDownloadsOpen },
  65     { APIPermission::kDownloadsShelf, "downloads.shelf" },
  66     { APIPermission::kIdentity, "identity" },
  67     { APIPermission::kExperimental, "experimental",
  68       APIPermissionInfo::kFlagCannotBeOptional },
  69       // NOTE(kalman): this is provided by a manifest property but needs to
  70       // appear in the install permission dialogue, so we need a fake
  71       // permission for it. See http://crbug.com/247857.
  72     { APIPermission::kWebConnectable, "webConnectable",
  73       APIPermissionInfo::kFlagCannotBeOptional |
  74       APIPermissionInfo::kFlagInternal,
  75       IDS_EXTENSION_PROMPT_WARNING_WEB_CONNECTABLE,
  76       PermissionMessage::kWebConnectable},
  77     { APIPermission::kGeolocation, "geolocation",
  78       APIPermissionInfo::kFlagCannotBeOptional,
  79       IDS_EXTENSION_PROMPT_WARNING_GEOLOCATION,
  80       PermissionMessage::kGeolocation },
  81     { APIPermission::kNotification, "notifications" },
  82     { APIPermission::kUnlimitedStorage, "unlimitedStorage",
  83       APIPermissionInfo::kFlagCannotBeOptional },
  84
  85     // Register extension permissions.
  86     { APIPermission::kActiveTab, "activeTab" },
  87     { APIPermission::kAdView, "adview" },
  88     { APIPermission::kAlarms, "alarms" },
  89     { APIPermission::kBookmark, "bookmarks", APIPermissionInfo::kFlagNone,
  90       IDS_EXTENSION_PROMPT_WARNING_BOOKMARKS,
  91       PermissionMessage::kBookmarks },
  92     { APIPermission::kBrailleDisplayPrivate, "brailleDisplayPrivate",
  93       APIPermissionInfo::kFlagCannotBeOptional },
  94     { APIPermission::kBrowsingData, "browsingData" },
  95     { APIPermission::kContentSettings, "contentSettings",
  96       APIPermissionInfo::kFlagNone,
  97       IDS_EXTENSION_PROMPT_WARNING_CONTENT_SETTINGS,
  98       PermissionMessage::kContentSettings },
  99     { APIPermission::kContextMenus, "contextMenus" },
 100     { APIPermission::kCookie, "cookies" },
 101     { APIPermission::kFileBrowserHandler, "fileBrowserHandler",
 102       APIPermissionInfo::kFlagCannotBeOptional },
 103     { APIPermission::kFontSettings, "fontSettings",
 104       APIPermissionInfo::kFlagCannotBeOptional },
 105     { APIPermission::kHistory, "history", APIPermissionInfo::kFlagNone,
 106       IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY,
 107       PermissionMessage::kBrowsingHistory },
 108     { APIPermission::kIdltest, "idltest" },
 109     { APIPermission::kIdle, "idle" },
 110     { APIPermission::kInfobars, "infobars" },
 111     { APIPermission::kInput, "input", APIPermissionInfo::kFlagNone,
 112       IDS_EXTENSION_PROMPT_WARNING_INPUT,
 113       PermissionMessage::kInput },
 114     { APIPermission::kLocation, "location",
 115       APIPermissionInfo::kFlagCannotBeOptional,
 116       IDS_EXTENSION_PROMPT_WARNING_GEOLOCATION,
 117       PermissionMessage::kGeolocation },
 118     { APIPermission::kManagement, "management", APIPermissionInfo::kFlagNone,
 119       IDS_EXTENSION_PROMPT_WARNING_MANAGEMENT,
 120       PermissionMessage::kManagement },
 121     { APIPermission::kNativeMessaging, "nativeMessaging",
 122       APIPermissionInfo::kFlagNone,
 123       IDS_EXTENSION_PROMPT_WARNING_NATIVE_MESSAGING,
 124       PermissionMessage::kNativeMessaging },
 125     { APIPermission::kPower, "power", },
 126     { APIPermission::kPrivacy, "privacy", APIPermissionInfo::kFlagNone,
 127       IDS_EXTENSION_PROMPT_WARNING_PRIVACY,
 128       PermissionMessage::kPrivacy },
 129     { APIPermission::kProcesses, "processes", APIPermissionInfo::kFlagNone,
 130       IDS_EXTENSION_PROMPT_WARNING_TABS,
 131       PermissionMessage::kTabs },
 132     { APIPermission::kSessions, "sessions" },
 133     { APIPermission::kSignedInDevices, "signedInDevices",
 134       APIPermissionInfo::kFlagNone,
 135       IDS_EXTENSION_PROMPT_WARNING_SIGNED_IN_DEVICES,
 136       PermissionMessage::kSignedInDevices },
 137     { APIPermission::kStorage, "storage" },
 138     { APIPermission::kSyncFileSystem, "syncFileSystem",
 139       APIPermissionInfo::kFlagNone,
 140       IDS_EXTENSION_PROMPT_WARNING_SYNCFILESYSTEM,
 141       PermissionMessage::kSyncFileSystem },
 142     { APIPermission::kTab, "tabs", APIPermissionInfo::kFlagNone,
 143       IDS_EXTENSION_PROMPT_WARNING_TABS,
 144       PermissionMessage::kTabs },
 145     { APIPermission::kTopSites, "topSites", APIPermissionInfo::kFlagNone,
 146       IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY,
 147       PermissionMessage::kBrowsingHistory },
 148     { APIPermission::kTts, "tts", 0, APIPermissionInfo::kFlagCannotBeOptional },
 149     { APIPermission::kTtsEngine, "ttsEngine",
 150       APIPermissionInfo::kFlagCannotBeOptional,
 151       IDS_EXTENSION_PROMPT_WARNING_TTS_ENGINE,
 152       PermissionMessage::kTtsEngine },
 153     { APIPermission::kWallpaper, "wallpaper",
 154       APIPermissionInfo::kFlagCannotBeOptional,
 155       IDS_EXTENSION_PROMPT_WARNING_WALLPAPER,
 156       PermissionMessage::kWallpaper },
 157     { APIPermission::kWebNavigation, "webNavigation",
 158       APIPermissionInfo::kFlagNone,
 159       IDS_EXTENSION_PROMPT_WARNING_TABS, PermissionMessage::kTabs },
 160     { APIPermission::kWebRequest, "webRequest" },
 161     { APIPermission::kWebRequestBlocking, "webRequestBlocking" },
 162     { APIPermission::kWebView, "webview",
 163       APIPermissionInfo::kFlagCannotBeOptional },
 164
 165     // Register private permissions.
 166     { APIPermission::kActivityLogPrivate, "activityLogPrivate",
 167       APIPermissionInfo::kFlagCannotBeOptional,
 168       IDS_EXTENSION_PROMPT_WARNING_ACTIVITY_LOG_PRIVATE,
 169       PermissionMessage::kActivityLogPrivate },
 170     { APIPermission::kAutoTestPrivate, "autotestPrivate",
 171       APIPermissionInfo::kFlagCannotBeOptional },
 172     { APIPermission::kBookmarkManagerPrivate, "bookmarkManagerPrivate",
 173       APIPermissionInfo::kFlagCannotBeOptional },
 174     { APIPermission::kCast, "cast",
 175       APIPermissionInfo::kFlagCannotBeOptional },
 176     { APIPermission::kChromeosInfoPrivate, "chromeosInfoPrivate",
 177       APIPermissionInfo::kFlagCannotBeOptional },
 178     { APIPermission::kCommandLinePrivate, "commandLinePrivate",
 179       APIPermissionInfo::kFlagCannotBeOptional },
 180     { APIPermission::kDeveloperPrivate, "developerPrivate",
 181       APIPermissionInfo::kFlagCannotBeOptional },
 182     { APIPermission::kDiagnostics, "diagnostics",
 183       APIPermissionInfo::kFlagCannotBeOptional },
 184     { APIPermission::kDial, "dial", APIPermissionInfo::kFlagCannotBeOptional },
 185     { APIPermission::kDownloadsInternal, "downloadsInternal" },
 186     { APIPermission::kFileBrowserHandlerInternal, "fileBrowserHandlerInternal",
 187       APIPermissionInfo::kFlagCannotBeOptional },
 188     { APIPermission::kFileBrowserPrivate, "fileBrowserPrivate",
 189       APIPermissionInfo::kFlagCannotBeOptional },
 190     { APIPermission::kIdentityPrivate, "identityPrivate",
 191       APIPermissionInfo::kFlagCannotBeOptional },
 192     { APIPermission::kLogPrivate, "logPrivate"},
 193     { APIPermission::kNetworkingPrivate, "networkingPrivate",
 194       APIPermissionInfo::kFlagCannotBeOptional,
 195       IDS_EXTENSION_PROMPT_WARNING_NETWORKING_PRIVATE,
 196       PermissionMessage::kNetworkingPrivate },
 197     { APIPermission::kMediaPlayerPrivate, "mediaPlayerPrivate",
 198       APIPermissionInfo::kFlagCannotBeOptional },
 199     { APIPermission::kMetricsPrivate, "metricsPrivate",
 200       APIPermissionInfo::kFlagCannotBeOptional },
 201     { APIPermission::kMDns, "mdns", APIPermissionInfo::kFlagCannotBeOptional },
 202     { APIPermission::kMusicManagerPrivate, "musicManagerPrivate",
 203       APIPermissionInfo::kFlagCannotBeOptional,
 204       IDS_EXTENSION_PROMPT_WARNING_MUSIC_MANAGER_PRIVATE,
 205       PermissionMessage::kMusicManagerPrivate },
 206     { APIPermission::kPreferencesPrivate, "preferencesPrivate",
 207       APIPermissionInfo::kFlagCannotBeOptional },
 208     { APIPermission::kSystemPrivate, "systemPrivate",
 209       APIPermissionInfo::kFlagCannotBeOptional },
 210     { APIPermission::kCloudPrintPrivate, "cloudPrintPrivate",
 211       APIPermissionInfo::kFlagCannotBeOptional },
 212     { APIPermission::kInputMethodPrivate, "inputMethodPrivate",
 213       APIPermissionInfo::kFlagCannotBeOptional },
 214     { APIPermission::kEchoPrivate, "echoPrivate",
 215       APIPermissionInfo::kFlagCannotBeOptional },
 216     { APIPermission::kFeedbackPrivate, "feedbackPrivate",
 217       APIPermissionInfo::kFlagCannotBeOptional },
 218     { APIPermission::kImageWriterPrivate, "imageWriterPrivate",
 219       APIPermissionInfo::kFlagCannotBeOptional },
 220     { APIPermission::kRtcPrivate, "rtcPrivate",
 221       APIPermissionInfo::kFlagCannotBeOptional },
 222     { APIPermission::kTerminalPrivate, "terminalPrivate",
 223       APIPermissionInfo::kFlagCannotBeOptional },
 224     { APIPermission::kVirtualKeyboardPrivate, "virtualKeyboardPrivate",
 225       APIPermissionInfo::kFlagCannotBeOptional },
 226     { APIPermission::kWallpaperPrivate, "wallpaperPrivate",
 227       APIPermissionInfo::kFlagCannotBeOptional },
 228     { APIPermission::kWebRequestInternal, "webRequestInternal" },
 229     { APIPermission::kWebstorePrivate, "webstorePrivate",
 230       APIPermissionInfo::kFlagCannotBeOptional },
 231     { APIPermission::kMediaGalleriesPrivate, "mediaGalleriesPrivate",
 232       APIPermissionInfo::kFlagCannotBeOptional },
 233     { APIPermission::kStreamsPrivate, "streamsPrivate",
 234       APIPermissionInfo::kFlagCannotBeOptional },
 235     { APIPermission::kEnterprisePlatformKeysPrivate,
 236       "enterprise.platformKeysPrivate",
 237       APIPermissionInfo::kFlagCannotBeOptional },
 238     { APIPermission::kWebrtcAudioPrivate, "webrtcAudioPrivate",
 239       APIPermissionInfo::kFlagCannotBeOptional },
 240     { APIPermission::kWebrtcLoggingPrivate, "webrtcLoggingPrivate",
 241       APIPermissionInfo::kFlagCannotBeOptional },
 242     { APIPermission::kPrincipalsPrivate, "principalsPrivate",
 243       APIPermissionInfo::kFlagCannotBeOptional },
 244
 245     // Full url access permissions.
 246     { APIPermission::kDebugger, "debugger",
 247       APIPermissionInfo::kFlagImpliesFullURLAccess |
 248           APIPermissionInfo::kFlagCannotBeOptional,
 249       IDS_EXTENSION_PROMPT_WARNING_DEBUGGER,
 250       PermissionMessage::kDebugger },
 251     { APIPermission::kDevtools, "devtools",
 252       APIPermissionInfo::kFlagImpliesFullURLAccess |
 253       APIPermissionInfo::kFlagCannotBeOptional |
 254       APIPermissionInfo::kFlagInternal },
 255     { APIPermission::kPageCapture, "pageCapture",
 256       APIPermissionInfo::kFlagImpliesFullURLAccess },
 257     { APIPermission::kTabCapture, "tabCapture",
 258       APIPermissionInfo::kFlagImpliesFullURLAccess },
 259     { APIPermission::kTabCaptureForTab, "tabCaptureForTab",
 260       APIPermissionInfo::kFlagInternal },
 261     { APIPermission::kPlugin, "plugin",
 262       APIPermissionInfo::kFlagImpliesFullURLAccess |
 263       APIPermissionInfo::kFlagImpliesFullAccess |
 264       APIPermissionInfo::kFlagCannotBeOptional |
 265       APIPermissionInfo::kFlagInternal,
 266       IDS_EXTENSION_PROMPT_WARNING_FULL_ACCESS,
 267       PermissionMessage::kFullAccess },
 268     { APIPermission::kProxy, "proxy",
 269       APIPermissionInfo::kFlagImpliesFullURLAccess |
 270           APIPermissionInfo::kFlagCannotBeOptional },
 271
 272     // Platform-app permissions.
 273     { APIPermission::kSerial, "serial", APIPermissionInfo::kFlagNone,
 274       IDS_EXTENSION_PROMPT_WARNING_SERIAL,
 275       PermissionMessage::kSerial },
 276     // Because warning messages for the "socket" permission vary based on the
 277     // permissions parameters, no message ID or message text is specified here.
 278     // The message ID and text used will be determined at run-time in the
 279     // |SocketPermission| class.
 280     { APIPermission::kSocket, "socket",
 281       APIPermissionInfo::kFlagCannotBeOptional, 0,
 282       PermissionMessage::kNone, &CreateAPIPermission<SocketPermission> },
 283     { APIPermission::kSocketsUdp, "sockets.udp" },
 284     { APIPermission::kAppCurrentWindowInternal, "app.currentWindowInternal" },
 285     { APIPermission::kAppRuntime, "app.runtime" },
 286     { APIPermission::kAppWindow, "app.window" },
 287     { APIPermission::kAudioCapture, "audioCapture",
 288       APIPermissionInfo::kFlagNone,
 289       IDS_EXTENSION_PROMPT_WARNING_AUDIO_CAPTURE,
 290       PermissionMessage::kAudioCapture },
 291     { APIPermission::kVideoCapture, "videoCapture",
 292       APIPermissionInfo::kFlagNone,
 293       IDS_EXTENSION_PROMPT_WARNING_VIDEO_CAPTURE,
 294       PermissionMessage::kVideoCapture },
 295     // The permission string for "fileSystem" is only shown when "write" or
 296     // "directory" is present. Read-only access is only granted after the user
 297     // has been shown a file or directory  chooser dialog and selected a file or
 298     // directory . Selecting the file or directory  is considered consent to
 299     // read it.
 300     { APIPermission::kFileSystem, "fileSystem" },
 301     { APIPermission::kFileSystemDirectory, "fileSystem.directory",
 302       APIPermissionInfo::kFlagNone,
 303       IDS_EXTENSION_PROMPT_WARNING_FILE_SYSTEM_DIRECTORY,
 304       PermissionMessage::kFileSystemDirectory },
 305     { APIPermission::kFileSystemRetainEntries, "fileSystem.retainEntries" },
 306     { APIPermission::kFileSystemWrite, "fileSystem.write",
 307       APIPermissionInfo::kFlagNone,
 308       IDS_EXTENSION_PROMPT_WARNING_FILE_SYSTEM_WRITE,
 309       PermissionMessage::kFileSystemWrite },
 310     { APIPermission::kFileSystemWriteDirectory, "fileSystem.writeDirectory",
 311       APIPermissionInfo::kFlagNone,
 312       IDS_EXTENSION_PROMPT_WARNING_FILE_SYSTEM_WRITE_DIRECTORY,
 313       PermissionMessage::kFileSystemWriteDirectory },
 314     // Because warning messages for the "mediaGalleries" permission vary based
 315     // on the permissions parameters, no message ID or message text is
 316     // specified here.
 317     // The message ID and text used will be determined at run-time in the
 318     // |MediaGalleriesPermission| class.
 319     { APIPermission::kMediaGalleries, "mediaGalleries",
 320       APIPermissionInfo::kFlagNone, 0,
 321       PermissionMessage::kNone,
 322       &CreateAPIPermission<MediaGalleriesPermission> },
 323     { APIPermission::kPushMessaging, "pushMessaging",
 324       APIPermissionInfo::kFlagCannotBeOptional },
 325     // Because warning messages for the "bluetooth" permission vary based on
 326     // the permissions parameters, no message ID or message text is specified
 327     // here. The message ID and text used will be determined at run-time in the
 328     // |BluetoothPermission| class.
 329     { APIPermission::kBluetooth, "bluetooth", APIPermissionInfo::kFlagNone,
 330       0, PermissionMessage::kNone,
 331       &CreateAPIPermission<BluetoothPermission> },
 332     { APIPermission::kUsb, "usb", APIPermissionInfo::kFlagNone,
 333       IDS_EXTENSION_PROMPT_WARNING_USB,
 334       PermissionMessage::kUsb },
 335     { APIPermission::kUsbDevice, "usbDevices",
 336       APIPermissionInfo::kFlagNone, 0, PermissionMessage::kNone,
 337       &CreateAPIPermission<UsbDevicePermission> },
 338     { APIPermission::kSystemIndicator, "systemIndicator",
 339       APIPermissionInfo::kFlagNone,
 340       IDS_EXTENSION_PROMPT_WARNING_SYSTEM_INDICATOR,
 341       PermissionMessage::kSystemIndicator },
 342     { APIPermission::kSystemCpu, "system.cpu" },
 343     { APIPermission::kSystemMemory, "system.memory" },
 344     { APIPermission::kSystemDisplay, "system.display" },
 345     { APIPermission::kSystemStorage, "system.storage" },
 346     { APIPermission::kPointerLock, "pointerLock" },
 347     { APIPermission::kFullscreen, "fullscreen" },
 348     { APIPermission::kAudio, "audio" },
 349     { APIPermission::kWebRtc, "webrtc" },
 350
 351     // Settings override permissions.
 352     { APIPermission::kHomepage, "homepage",
 353       APIPermissionInfo::kFlagCannotBeOptional |
 354       APIPermissionInfo::kFlagInternal,
 355       IDS_EXTENSION_PROMPT_WARNING_HOME_PAGE_SETTING_OVERRIDE,
 356       PermissionMessage::kHomepage },
 357     { APIPermission::kSearchProvider, "searchProvider",
 358       APIPermissionInfo::kFlagCannotBeOptional |
 359       APIPermissionInfo::kFlagInternal,
 360       IDS_EXTENSION_PROMPT_WARNING_SEARCH_SETTINGS_OVERRIDE,
 361       PermissionMessage::kSearchProvider },
 362     { APIPermission::kStartupPages, "startupPages",
 363       APIPermissionInfo::kFlagCannotBeOptional |
 364       APIPermissionInfo::kFlagInternal,
 365       IDS_EXTENSION_PROMPT_WARNING_START_PAGE_SETTING_OVERRIDE,
 366       PermissionMessage::kStartupPages },
 367   };
 368
 369   std::vector<APIPermissionInfo*> permissions;
 370
 371   for (size_t i = 0; i < ARRAYSIZE_UNSAFE(PermissionsToRegister); ++i) {
 372     const PermissionRegistration& pr = PermissionsToRegister[i];
 373     permissions.push_back(new APIPermissionInfo(
 374         pr.id, pr.name, pr.l10n_message_id,
 375         pr.message_id ? pr.message_id : PermissionMessage::kNone,
 376         pr.flags,
 377         pr.constructor));
 378   }
 379   return permissions;
 380 }
 381
 382 std::vector<PermissionsProvider::AliasInfo>
 383 ChromeAPIPermissions::GetAllAliases() const {
 384   // Register aliases.
 385   std::vector<PermissionsProvider::AliasInfo> aliases;
 386   aliases.push_back(PermissionsProvider::AliasInfo(
 387       "unlimitedStorage", kOldUnlimitedStoragePermission));
 388   aliases.push_back(PermissionsProvider::AliasInfo(
 389       "tabs", kWindowsPermission));
 390   return aliases;
 391 }
 392
 393 }  // namespace extensions