chrome_api_permissions.cc revision d0247b1b59f9c528cb6df88b4f2b9afaf80d181e
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/api_permission.h" 8#include "chrome/common/extensions/permissions/api_permission_set.h" 9#include "chrome/common/extensions/permissions/bluetooth_permission.h" 10#include "chrome/common/extensions/permissions/media_galleries_permission.h" 11#include "chrome/common/extensions/permissions/permission_message.h" 12#include "chrome/common/extensions/permissions/permissions_info.h" 13#include "chrome/common/extensions/permissions/socket_permission.h" 14#include "chrome/common/extensions/permissions/usb_device_permission.h" 15#include "grit/generated_resources.h" 16 17namespace extensions { 18 19namespace { 20 21const char kOldUnlimitedStoragePermission[] = "unlimited_storage"; 22const char kWindowsPermission[] = "windows"; 23 24template<typename T> APIPermission* CreateAPIPermission( 25 const APIPermissionInfo* permission) { 26 return new T(permission); 27} 28 29} // namespace 30 31std::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::kScreensaver, "screensaver" }, 83 { APIPermission::kUnlimitedStorage, "unlimitedStorage", 84 APIPermissionInfo::kFlagCannotBeOptional }, 85 86 // Register extension permissions. 87 { APIPermission::kActiveTab, "activeTab" }, 88 { APIPermission::kAdView, "adview" }, 89 { APIPermission::kAlarms, "alarms" }, 90 { APIPermission::kBookmark, "bookmarks", APIPermissionInfo::kFlagNone, 91 IDS_EXTENSION_PROMPT_WARNING_BOOKMARKS, 92 PermissionMessage::kBookmarks }, 93 { APIPermission::kBrailleDisplayPrivate, "brailleDisplayPrivate", 94 APIPermissionInfo::kFlagCannotBeOptional }, 95 { APIPermission::kBrowsingData, "browsingData" }, 96 { APIPermission::kContentSettings, "contentSettings", 97 APIPermissionInfo::kFlagNone, 98 IDS_EXTENSION_PROMPT_WARNING_CONTENT_SETTINGS, 99 PermissionMessage::kContentSettings }, 100 { APIPermission::kContextMenus, "contextMenus" }, 101 { APIPermission::kCookie, "cookies" }, 102 { APIPermission::kFileBrowserHandler, "fileBrowserHandler", 103 APIPermissionInfo::kFlagCannotBeOptional }, 104 { APIPermission::kFontSettings, "fontSettings", 105 APIPermissionInfo::kFlagCannotBeOptional }, 106 { APIPermission::kHistory, "history", APIPermissionInfo::kFlagNone, 107 IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY, 108 PermissionMessage::kBrowsingHistory }, 109 { APIPermission::kIdltest, "idltest" }, 110 { APIPermission::kIdle, "idle" }, 111 { APIPermission::kInfobars, "infobars" }, 112 { APIPermission::kInput, "input", APIPermissionInfo::kFlagNone, 113 IDS_EXTENSION_PROMPT_WARNING_INPUT, 114 PermissionMessage::kInput }, 115 { APIPermission::kLocation, "location", 116 APIPermissionInfo::kFlagCannotBeOptional, 117 IDS_EXTENSION_PROMPT_WARNING_GEOLOCATION, 118 PermissionMessage::kGeolocation }, 119 { APIPermission::kManagement, "management", APIPermissionInfo::kFlagNone, 120 IDS_EXTENSION_PROMPT_WARNING_MANAGEMENT, 121 PermissionMessage::kManagement }, 122 { APIPermission::kNativeMessaging, "nativeMessaging", 123 APIPermissionInfo::kFlagNone, 124 IDS_EXTENSION_PROMPT_WARNING_NATIVE_MESSAGING, 125 PermissionMessage::kNativeMessaging }, 126 { APIPermission::kPower, "power", }, 127 { APIPermission::kPrivacy, "privacy", APIPermissionInfo::kFlagNone, 128 IDS_EXTENSION_PROMPT_WARNING_PRIVACY, 129 PermissionMessage::kPrivacy }, 130 { APIPermission::kProcesses, "processes", APIPermissionInfo::kFlagNone, 131 IDS_EXTENSION_PROMPT_WARNING_TABS, 132 PermissionMessage::kTabs }, 133 { APIPermission::kSessions, "sessions" }, 134 { APIPermission::kSignedInDevices, "signedInDevices", 135 APIPermissionInfo::kFlagNone, 136 IDS_EXTENSION_PROMPT_WARNING_SIGNED_IN_DEVICES, 137 PermissionMessage::kSignedInDevices }, 138 { APIPermission::kStorage, "storage" }, 139 { APIPermission::kSyncFileSystem, "syncFileSystem", 140 APIPermissionInfo::kFlagNone, 141 IDS_EXTENSION_PROMPT_WARNING_SYNCFILESYSTEM, 142 PermissionMessage::kSyncFileSystem }, 143 { APIPermission::kTab, "tabs", APIPermissionInfo::kFlagNone, 144 IDS_EXTENSION_PROMPT_WARNING_TABS, 145 PermissionMessage::kTabs }, 146 { APIPermission::kTopSites, "topSites", APIPermissionInfo::kFlagNone, 147 IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY, 148 PermissionMessage::kBrowsingHistory }, 149 { APIPermission::kTts, "tts", 0, APIPermissionInfo::kFlagCannotBeOptional }, 150 { APIPermission::kTtsEngine, "ttsEngine", 151 APIPermissionInfo::kFlagCannotBeOptional, 152 IDS_EXTENSION_PROMPT_WARNING_TTS_ENGINE, 153 PermissionMessage::kTtsEngine }, 154 { APIPermission::kWallpaper, "wallpaper", 155 APIPermissionInfo::kFlagCannotBeOptional, 156 IDS_EXTENSION_PROMPT_WARNING_WALLPAPER, 157 PermissionMessage::kWallpaper }, 158 { APIPermission::kWebNavigation, "webNavigation", 159 APIPermissionInfo::kFlagNone, 160 IDS_EXTENSION_PROMPT_WARNING_TABS, PermissionMessage::kTabs }, 161 { APIPermission::kWebRequest, "webRequest" }, 162 { APIPermission::kWebRequestBlocking, "webRequestBlocking" }, 163 { APIPermission::kWebView, "webview", 164 APIPermissionInfo::kFlagCannotBeOptional }, 165 166 // Register private permissions. 167 { APIPermission::kActivityLogPrivate, "activityLogPrivate", 168 APIPermissionInfo::kFlagCannotBeOptional, 169 IDS_EXTENSION_PROMPT_WARNING_ACTIVITY_LOG_PRIVATE, 170 PermissionMessage::kActivityLogPrivate }, 171 { APIPermission::kAutoTestPrivate, "autotestPrivate", 172 APIPermissionInfo::kFlagCannotBeOptional }, 173 { APIPermission::kBookmarkManagerPrivate, "bookmarkManagerPrivate", 174 APIPermissionInfo::kFlagCannotBeOptional }, 175 { APIPermission::kChromeosInfoPrivate, "chromeosInfoPrivate", 176 APIPermissionInfo::kFlagCannotBeOptional }, 177 { APIPermission::kCommandLinePrivate, "commandLinePrivate", 178 APIPermissionInfo::kFlagCannotBeOptional }, 179 { APIPermission::kDeveloperPrivate, "developerPrivate", 180 APIPermissionInfo::kFlagCannotBeOptional }, 181 { APIPermission::kDiagnostics, "diagnostics", 182 APIPermissionInfo::kFlagCannotBeOptional }, 183 { APIPermission::kDial, "dial", APIPermissionInfo::kFlagCannotBeOptional }, 184 { APIPermission::kDownloadsInternal, "downloadsInternal" }, 185 { APIPermission::kFileBrowserHandlerInternal, "fileBrowserHandlerInternal", 186 APIPermissionInfo::kFlagCannotBeOptional }, 187 { APIPermission::kFileBrowserPrivate, "fileBrowserPrivate", 188 APIPermissionInfo::kFlagCannotBeOptional }, 189 { APIPermission::kIdentityPrivate, "identityPrivate", 190 APIPermissionInfo::kFlagCannotBeOptional }, 191 { APIPermission::kLogPrivate, "logPrivate"}, 192 { APIPermission::kNetworkingPrivate, "networkingPrivate", 193 APIPermissionInfo::kFlagCannotBeOptional, 194 IDS_EXTENSION_PROMPT_WARNING_NETWORKING_PRIVATE, 195 PermissionMessage::kNetworkingPrivate }, 196 { APIPermission::kMediaPlayerPrivate, "mediaPlayerPrivate", 197 APIPermissionInfo::kFlagCannotBeOptional }, 198 { APIPermission::kMetricsPrivate, "metricsPrivate", 199 APIPermissionInfo::kFlagCannotBeOptional }, 200 { APIPermission::kMDns, "mdns", APIPermissionInfo::kFlagCannotBeOptional }, 201 { APIPermission::kMusicManagerPrivate, "musicManagerPrivate", 202 APIPermissionInfo::kFlagCannotBeOptional, 203 IDS_EXTENSION_PROMPT_WARNING_MUSIC_MANAGER_PRIVATE, 204 PermissionMessage::kMusicManagerPrivate }, 205 { APIPermission::kPreferencesPrivate, "preferencesPrivate", 206 APIPermissionInfo::kFlagCannotBeOptional }, 207 { APIPermission::kSystemPrivate, "systemPrivate", 208 APIPermissionInfo::kFlagCannotBeOptional }, 209 { APIPermission::kCloudPrintPrivate, "cloudPrintPrivate", 210 APIPermissionInfo::kFlagCannotBeOptional }, 211 { APIPermission::kInputMethodPrivate, "inputMethodPrivate", 212 APIPermissionInfo::kFlagCannotBeOptional }, 213 { APIPermission::kEchoPrivate, "echoPrivate", 214 APIPermissionInfo::kFlagCannotBeOptional }, 215 { APIPermission::kFeedbackPrivate, "feedbackPrivate", 216 APIPermissionInfo::kFlagCannotBeOptional }, 217 { APIPermission::kImageWriterPrivate, "imageWriterPrivate", 218 APIPermissionInfo::kFlagCannotBeOptional }, 219 { APIPermission::kRtcPrivate, "rtcPrivate", 220 APIPermissionInfo::kFlagCannotBeOptional }, 221 { APIPermission::kTerminalPrivate, "terminalPrivate", 222 APIPermissionInfo::kFlagCannotBeOptional }, 223 { APIPermission::kVirtualKeyboardPrivate, "virtualKeyboardPrivate", 224 APIPermissionInfo::kFlagCannotBeOptional }, 225 { APIPermission::kWallpaperPrivate, "wallpaperPrivate", 226 APIPermissionInfo::kFlagCannotBeOptional }, 227 { APIPermission::kWebRequestInternal, "webRequestInternal" }, 228 { APIPermission::kWebstorePrivate, "webstorePrivate", 229 APIPermissionInfo::kFlagCannotBeOptional }, 230 { APIPermission::kMediaGalleriesPrivate, "mediaGalleriesPrivate", 231 APIPermissionInfo::kFlagCannotBeOptional }, 232 { APIPermission::kStreamsPrivate, "streamsPrivate", 233 APIPermissionInfo::kFlagCannotBeOptional }, 234 { APIPermission::kEnterprisePlatformKeysPrivate, 235 "enterprise.platformKeysPrivate", 236 APIPermissionInfo::kFlagCannotBeOptional }, 237 238 // Full url access permissions. 239 { APIPermission::kDebugger, "debugger", 240 APIPermissionInfo::kFlagImpliesFullURLAccess | 241 APIPermissionInfo::kFlagCannotBeOptional, 242 IDS_EXTENSION_PROMPT_WARNING_DEBUGGER, 243 PermissionMessage::kDebugger }, 244 { APIPermission::kDevtools, "devtools", 245 APIPermissionInfo::kFlagImpliesFullURLAccess | 246 APIPermissionInfo::kFlagCannotBeOptional | 247 APIPermissionInfo::kFlagInternal }, 248 { APIPermission::kPageCapture, "pageCapture", 249 APIPermissionInfo::kFlagImpliesFullURLAccess }, 250 { APIPermission::kTabCapture, "tabCapture", 251 APIPermissionInfo::kFlagImpliesFullURLAccess }, 252 { APIPermission::kTabCaptureForTab, "tabCaptureForTab", 253 APIPermissionInfo::kFlagInternal }, 254 { APIPermission::kPlugin, "plugin", 255 APIPermissionInfo::kFlagImpliesFullURLAccess | 256 APIPermissionInfo::kFlagImpliesFullAccess | 257 APIPermissionInfo::kFlagCannotBeOptional | 258 APIPermissionInfo::kFlagInternal, 259 IDS_EXTENSION_PROMPT_WARNING_FULL_ACCESS, 260 PermissionMessage::kFullAccess }, 261 { APIPermission::kProxy, "proxy", 262 APIPermissionInfo::kFlagImpliesFullURLAccess | 263 APIPermissionInfo::kFlagCannotBeOptional }, 264 265 // Platform-app permissions. 266 { APIPermission::kSerial, "serial", APIPermissionInfo::kFlagNone, 267 IDS_EXTENSION_PROMPT_WARNING_SERIAL, 268 PermissionMessage::kSerial }, 269 // Because warning messages for the "socket" permission vary based on the 270 // permissions parameters, no message ID or message text is specified here. 271 // The message ID and text used will be determined at run-time in the 272 // |SocketPermission| class. 273 { APIPermission::kSocket, "socket", 274 APIPermissionInfo::kFlagCannotBeOptional, 0, 275 PermissionMessage::kNone, &CreateAPIPermission<SocketPermission> }, 276 { APIPermission::kSocketsUdp, "sockets.udp" }, 277 { APIPermission::kAppCurrentWindowInternal, "app.currentWindowInternal" }, 278 { APIPermission::kAppRuntime, "app.runtime" }, 279 { APIPermission::kAppWindow, "app.window" }, 280 { APIPermission::kAudioCapture, "audioCapture", 281 APIPermissionInfo::kFlagNone, 282 IDS_EXTENSION_PROMPT_WARNING_AUDIO_CAPTURE, 283 PermissionMessage::kAudioCapture }, 284 { APIPermission::kVideoCapture, "videoCapture", 285 APIPermissionInfo::kFlagNone, 286 IDS_EXTENSION_PROMPT_WARNING_VIDEO_CAPTURE, 287 PermissionMessage::kVideoCapture }, 288 // The permission string for "fileSystem" is only shown when "write" or 289 // "directory" is present. Read-only access is only granted after the user 290 // has been shown a file or directory chooser dialog and selected a file or 291 // directory . Selecting the file or directory is considered consent to 292 // read it. 293 { APIPermission::kFileSystem, "fileSystem" }, 294 { APIPermission::kFileSystemDirectory, "fileSystem.directory", 295 APIPermissionInfo::kFlagNone, 296 IDS_EXTENSION_PROMPT_WARNING_FILE_SYSTEM_DIRECTORY, 297 PermissionMessage::kFileSystemDirectory }, 298 { APIPermission::kFileSystemRetainEntries, "fileSystem.retainEntries" }, 299 { APIPermission::kFileSystemWrite, "fileSystem.write", 300 APIPermissionInfo::kFlagNone, 301 IDS_EXTENSION_PROMPT_WARNING_FILE_SYSTEM_WRITE, 302 PermissionMessage::kFileSystemWrite }, 303 { APIPermission::kFileSystemWriteDirectory, "fileSystem.writeDirectory", 304 APIPermissionInfo::kFlagNone, 305 IDS_EXTENSION_PROMPT_WARNING_FILE_SYSTEM_WRITE_DIRECTORY, 306 PermissionMessage::kFileSystemWriteDirectory }, 307 // Because warning messages for the "mediaGalleries" permission vary based 308 // on the permissions parameters, no message ID or message text is 309 // specified here. 310 // The message ID and text used will be determined at run-time in the 311 // |MediaGalleriesPermission| class. 312 { APIPermission::kMediaGalleries, "mediaGalleries", 313 APIPermissionInfo::kFlagNone, 0, 314 PermissionMessage::kNone, 315 &CreateAPIPermission<MediaGalleriesPermission> }, 316 { APIPermission::kPushMessaging, "pushMessaging", 317 APIPermissionInfo::kFlagCannotBeOptional }, 318 // Because warning messages for the "bluetooth" permission vary based on 319 // the permissions parameters, no message ID or message text is specified 320 // here. The message ID and text used will be determined at run-time in the 321 // |BluetoothPermission| class. 322 { APIPermission::kBluetooth, "bluetooth", APIPermissionInfo::kFlagNone, 323 0, PermissionMessage::kNone, 324 &CreateAPIPermission<BluetoothPermission> }, 325 { APIPermission::kUsb, "usb", APIPermissionInfo::kFlagNone, 326 IDS_EXTENSION_PROMPT_WARNING_USB, 327 PermissionMessage::kUsb }, 328 { APIPermission::kUsbDevice, "usbDevices", 329 APIPermissionInfo::kFlagNone, 0, PermissionMessage::kNone, 330 &CreateAPIPermission<UsbDevicePermission> }, 331 { APIPermission::kSystemIndicator, "systemIndicator", 332 APIPermissionInfo::kFlagNone, 333 IDS_EXTENSION_PROMPT_WARNING_SYSTEM_INDICATOR, 334 PermissionMessage::kSystemIndicator }, 335 { APIPermission::kSystemCpu, "system.cpu" }, 336 { APIPermission::kSystemMemory, "system.memory" }, 337 { APIPermission::kSystemDisplay, "system.display" }, 338 { APIPermission::kSystemStorage, "system.storage" }, 339 { APIPermission::kPointerLock, "pointerLock" }, 340 { APIPermission::kFullscreen, "fullscreen" }, 341 { APIPermission::kAudio, "audio" }, 342 }; 343 344 std::vector<APIPermissionInfo*> permissions; 345 346 for (size_t i = 0; i < ARRAYSIZE_UNSAFE(PermissionsToRegister); ++i) { 347 const PermissionRegistration& pr = PermissionsToRegister[i]; 348 permissions.push_back(new APIPermissionInfo( 349 pr.id, pr.name, pr.l10n_message_id, 350 pr.message_id ? pr.message_id : PermissionMessage::kNone, 351 pr.flags, 352 pr.constructor)); 353 } 354 return permissions; 355} 356 357std::vector<PermissionsProvider::AliasInfo> 358ChromeAPIPermissions::GetAllAliases() const { 359 // Register aliases. 360 std::vector<PermissionsProvider::AliasInfo> aliases; 361 aliases.push_back(PermissionsProvider::AliasInfo( 362 "unlimitedStorage", kOldUnlimitedStoragePermission)); 363 aliases.push_back(PermissionsProvider::AliasInfo( 364 "tabs", kWindowsPermission)); 365 return aliases; 366} 367 368} // namespace extensions 369