chrome_api_permissions.cc revision ca12bfac764ba476d6cd062bf1dde12cc64c3f40
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 { APIPermission::kDownloads, "downloads", APIPermissionInfo::kFlagNone, 51 IDS_EXTENSION_PROMPT_WARNING_DOWNLOADS, 52 PermissionMessage::kDownloads }, 53 { APIPermission::kIdentity, "identity" }, 54 { APIPermission::kExperimental, "experimental", 55 APIPermissionInfo::kFlagCannotBeOptional }, 56 // NOTE(kalman): this is provided by a manifest property but needs to 57 // appear in the install permission dialogue, so we need a fake 58 // permission for it. See http://crbug.com/247857. 59 { APIPermission::kWebConnectable, "webConnectable", 60 APIPermissionInfo::kFlagCannotBeOptional | 61 APIPermissionInfo::kFlagInternal, 62 IDS_EXTENSION_PROMPT_WARNING_WEB_CONNECTABLE, 63 PermissionMessage::kWebConnectable}, 64 { APIPermission::kGeolocation, "geolocation", 65 APIPermissionInfo::kFlagCannotBeOptional, 66 IDS_EXTENSION_PROMPT_WARNING_GEOLOCATION, 67 PermissionMessage::kGeolocation }, 68 { APIPermission::kNotification, "notifications" }, 69 { APIPermission::kScreensaver, "screensaver" }, 70 { APIPermission::kUnlimitedStorage, "unlimitedStorage", 71 APIPermissionInfo::kFlagCannotBeOptional }, 72 73 // Register extension permissions. 74 { APIPermission::kActiveTab, "activeTab" }, 75 { APIPermission::kAdView, "adview" }, 76 { APIPermission::kAlarms, "alarms" }, 77 { APIPermission::kBookmark, "bookmarks", APIPermissionInfo::kFlagNone, 78 IDS_EXTENSION_PROMPT_WARNING_BOOKMARKS, 79 PermissionMessage::kBookmarks }, 80 { APIPermission::kBrowsingData, "browsingData" }, 81 { APIPermission::kContentSettings, "contentSettings", 82 APIPermissionInfo::kFlagNone, 83 IDS_EXTENSION_PROMPT_WARNING_CONTENT_SETTINGS, 84 PermissionMessage::kContentSettings }, 85 { APIPermission::kContextMenus, "contextMenus" }, 86 { APIPermission::kCookie, "cookies" }, 87 { APIPermission::kFileBrowserHandler, "fileBrowserHandler", 88 APIPermissionInfo::kFlagCannotBeOptional }, 89 { APIPermission::kFontSettings, "fontSettings", 90 APIPermissionInfo::kFlagCannotBeOptional }, 91 { APIPermission::kHistory, "history", APIPermissionInfo::kFlagNone, 92 IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY, 93 PermissionMessage::kBrowsingHistory }, 94 { APIPermission::kIdle, "idle" }, 95 { APIPermission::kInput, "input", APIPermissionInfo::kFlagNone, 96 IDS_EXTENSION_PROMPT_WARNING_INPUT, 97 PermissionMessage::kInput }, 98 { APIPermission::kLocation, "location", 99 APIPermissionInfo::kFlagCannotBeOptional, 100 IDS_EXTENSION_PROMPT_WARNING_GEOLOCATION, 101 PermissionMessage::kGeolocation }, 102 { APIPermission::kManagement, "management", APIPermissionInfo::kFlagNone, 103 IDS_EXTENSION_PROMPT_WARNING_MANAGEMENT, 104 PermissionMessage::kManagement }, 105 { APIPermission::kNativeMessaging, "nativeMessaging", 106 APIPermissionInfo::kFlagNone, 107 IDS_EXTENSION_PROMPT_WARNING_NATIVE_MESSAGING, 108 PermissionMessage::kNativeMessaging }, 109 { APIPermission::kPower, "power", }, 110 { APIPermission::kPrivacy, "privacy", APIPermissionInfo::kFlagNone, 111 IDS_EXTENSION_PROMPT_WARNING_PRIVACY, 112 PermissionMessage::kPrivacy }, 113 { APIPermission::kSessionRestore, "sessionRestore" }, 114 { APIPermission::kStorage, "storage" }, 115 { APIPermission::kSyncFileSystem, "syncFileSystem", 116 APIPermissionInfo::kFlagNone, 117 IDS_EXTENSION_PROMPT_WARNING_SYNCFILESYSTEM, 118 PermissionMessage::kSyncFileSystem }, 119 { APIPermission::kTab, "tabs", APIPermissionInfo::kFlagNone, 120 IDS_EXTENSION_PROMPT_WARNING_TABS, 121 PermissionMessage::kTabs }, 122 { APIPermission::kTopSites, "topSites", APIPermissionInfo::kFlagNone, 123 IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY, 124 PermissionMessage::kBrowsingHistory }, 125 { APIPermission::kTts, "tts", 0, APIPermissionInfo::kFlagCannotBeOptional }, 126 { APIPermission::kTtsEngine, "ttsEngine", 127 APIPermissionInfo::kFlagCannotBeOptional, 128 IDS_EXTENSION_PROMPT_WARNING_TTS_ENGINE, 129 PermissionMessage::kTtsEngine }, 130 { APIPermission::kWebNavigation, "webNavigation", 131 APIPermissionInfo::kFlagNone, 132 IDS_EXTENSION_PROMPT_WARNING_TABS, PermissionMessage::kTabs }, 133 { APIPermission::kWebRequest, "webRequest" }, 134 { APIPermission::kWebRequestBlocking, "webRequestBlocking" }, 135 { APIPermission::kWebView, "webview", 136 APIPermissionInfo::kFlagCannotBeOptional }, 137 138 // Register private permissions. 139 { APIPermission::kActivityLogPrivate, "activityLogPrivate", 140 APIPermissionInfo::kFlagCannotBeOptional, 141 IDS_EXTENSION_PROMPT_WARNING_ACTIVITY_LOG_PRIVATE, 142 PermissionMessage::kActivityLogPrivate }, 143 { APIPermission::kAutoTestPrivate, "autotestPrivate", 144 APIPermissionInfo::kFlagCannotBeOptional }, 145 { APIPermission::kBookmarkManagerPrivate, "bookmarkManagerPrivate", 146 APIPermissionInfo::kFlagCannotBeOptional }, 147 { APIPermission::kChromeosInfoPrivate, "chromeosInfoPrivate", 148 APIPermissionInfo::kFlagCannotBeOptional }, 149 { APIPermission::kCommandLinePrivate, "commandLinePrivate", 150 APIPermissionInfo::kFlagCannotBeOptional }, 151 { APIPermission::kDeveloperPrivate, "developerPrivate", 152 APIPermissionInfo::kFlagCannotBeOptional }, 153 { APIPermission::kDiagnostics, "diagnostics", 154 APIPermissionInfo::kFlagCannotBeOptional }, 155 { APIPermission::kDial, "dial", APIPermissionInfo::kFlagCannotBeOptional }, 156 { APIPermission::kDownloadsInternal, "downloadsInternal" }, 157 { APIPermission::kFileBrowserHandlerInternal, "fileBrowserHandlerInternal", 158 APIPermissionInfo::kFlagCannotBeOptional }, 159 { APIPermission::kFileBrowserPrivate, "fileBrowserPrivate", 160 APIPermissionInfo::kFlagCannotBeOptional }, 161 { APIPermission::kIdentityPrivate, "identityPrivate", 162 APIPermissionInfo::kFlagCannotBeOptional }, 163 { APIPermission::kNetworkingPrivate, "networkingPrivate", 164 APIPermissionInfo::kFlagCannotBeOptional }, 165 { APIPermission::kMediaPlayerPrivate, "mediaPlayerPrivate", 166 APIPermissionInfo::kFlagCannotBeOptional }, 167 { APIPermission::kMetricsPrivate, "metricsPrivate", 168 APIPermissionInfo::kFlagCannotBeOptional }, 169 { APIPermission::kMusicManagerPrivate, "musicManagerPrivate", 170 APIPermissionInfo::kFlagCannotBeOptional, 171 IDS_EXTENSION_PROMPT_WARNING_MUSIC_MANAGER_PRIVATE, 172 PermissionMessage::kMusicManagerPrivate }, 173 { APIPermission::kPreferencesPrivate, "preferencesPrivate", 174 APIPermissionInfo::kFlagCannotBeOptional }, 175 { APIPermission::kSystemPrivate, "systemPrivate", 176 APIPermissionInfo::kFlagCannotBeOptional }, 177 { APIPermission::kCloudPrintPrivate, "cloudPrintPrivate", 178 APIPermissionInfo::kFlagCannotBeOptional }, 179 { APIPermission::kInputMethodPrivate, "inputMethodPrivate", 180 APIPermissionInfo::kFlagCannotBeOptional }, 181 { APIPermission::kEchoPrivate, "echoPrivate", 182 APIPermissionInfo::kFlagCannotBeOptional }, 183 { APIPermission::kFeedbackPrivate, "feedbackPrivate", 184 APIPermissionInfo::kFlagCannotBeOptional }, 185 { APIPermission::kRtcPrivate, "rtcPrivate", 186 APIPermissionInfo::kFlagCannotBeOptional }, 187 { APIPermission::kTerminalPrivate, "terminalPrivate", 188 APIPermissionInfo::kFlagCannotBeOptional }, 189 { APIPermission::kWallpaperPrivate, "wallpaperPrivate", 190 APIPermissionInfo::kFlagCannotBeOptional }, 191 { APIPermission::kWebRequestInternal, "webRequestInternal" }, 192 { APIPermission::kWebSocketProxyPrivate, "webSocketProxyPrivate", 193 APIPermissionInfo::kFlagCannotBeOptional }, 194 { APIPermission::kWebstorePrivate, "webstorePrivate", 195 APIPermissionInfo::kFlagCannotBeOptional }, 196 { APIPermission::kMediaGalleriesPrivate, "mediaGalleriesPrivate", 197 APIPermissionInfo::kFlagCannotBeOptional }, 198 { APIPermission::kStreamsPrivate, "streamsPrivate", 199 APIPermissionInfo::kFlagCannotBeOptional }, 200 { APIPermission::kEnterprisePlatformKeysPrivate, 201 "enterprise.platformKeysPrivate", 202 APIPermissionInfo::kFlagCannotBeOptional }, 203 204 // Full url access permissions. 205 { APIPermission::kDebugger, "debugger", 206 APIPermissionInfo::kFlagImpliesFullURLAccess | 207 APIPermissionInfo::kFlagCannotBeOptional, 208 IDS_EXTENSION_PROMPT_WARNING_DEBUGGER, 209 PermissionMessage::kDebugger }, 210 { APIPermission::kDevtools, "devtools", 211 APIPermissionInfo::kFlagImpliesFullURLAccess | 212 APIPermissionInfo::kFlagCannotBeOptional | 213 APIPermissionInfo::kFlagInternal }, 214 { APIPermission::kPageCapture, "pageCapture", 215 APIPermissionInfo::kFlagImpliesFullURLAccess }, 216 { APIPermission::kTabCapture, "tabCapture", 217 APIPermissionInfo::kFlagImpliesFullURLAccess }, 218 { APIPermission::kPlugin, "plugin", 219 APIPermissionInfo::kFlagImpliesFullURLAccess | 220 APIPermissionInfo::kFlagImpliesFullAccess | 221 APIPermissionInfo::kFlagCannotBeOptional | 222 APIPermissionInfo::kFlagInternal, 223 IDS_EXTENSION_PROMPT_WARNING_FULL_ACCESS, 224 PermissionMessage::kFullAccess }, 225 { APIPermission::kProxy, "proxy", 226 APIPermissionInfo::kFlagImpliesFullURLAccess | 227 APIPermissionInfo::kFlagCannotBeOptional }, 228 229 // Platform-app permissions. 230 { APIPermission::kSerial, "serial", APIPermissionInfo::kFlagNone, 231 IDS_EXTENSION_PROMPT_WARNING_SERIAL, 232 PermissionMessage::kSerial }, 233 // Because warning messages for the "socket" permission vary based on the 234 // permissions parameters, no message ID or message text is specified here. 235 // The message ID and text used will be determined at run-time in the 236 // |SocketPermission| class. 237 { APIPermission::kSocket, "socket", 238 APIPermissionInfo::kFlagCannotBeOptional, 0, 239 PermissionMessage::kNone, &CreateAPIPermission<SocketPermission> }, 240 { APIPermission::kAppCurrentWindowInternal, "app.currentWindowInternal" }, 241 { APIPermission::kAppRuntime, "app.runtime" }, 242 { APIPermission::kAppWindow, "app.window" }, 243 { APIPermission::kAudioCapture, "audioCapture", 244 APIPermissionInfo::kFlagNone, 245 IDS_EXTENSION_PROMPT_WARNING_AUDIO_CAPTURE, 246 PermissionMessage::kAudioCapture }, 247 { APIPermission::kVideoCapture, "videoCapture", 248 APIPermissionInfo::kFlagNone, 249 IDS_EXTENSION_PROMPT_WARNING_VIDEO_CAPTURE, 250 PermissionMessage::kVideoCapture }, 251 // The permission string for "fileSystem" is only shown when "write" is 252 // present. Read-only access is only granted after the user has been shown 253 // a file chooser dialog and selected a file. Selecting the file is 254 // considered consent to read it. 255 { APIPermission::kFileSystem, "fileSystem" }, 256 { APIPermission::kFileSystemRetainEntries, "fileSystem.retainEntries" }, 257 { APIPermission::kFileSystemWrite, "fileSystem.write", 258 APIPermissionInfo::kFlagNone, 259 IDS_EXTENSION_PROMPT_WARNING_FILE_SYSTEM_WRITE, 260 PermissionMessage::kFileSystemWrite }, 261 // Because warning messages for the "mediaGalleries" permission vary based 262 // on the permissions parameters, no message ID or message text is 263 // specified here. 264 // The message ID and text used will be determined at run-time in the 265 // |MediaGalleriesPermission| class. 266 { APIPermission::kMediaGalleries, "mediaGalleries", 267 APIPermissionInfo::kFlagNone, 0, 268 PermissionMessage::kNone, 269 &CreateAPIPermission<MediaGalleriesPermission> }, 270 { APIPermission::kPushMessaging, "pushMessaging", 271 APIPermissionInfo::kFlagCannotBeOptional }, 272 // Because warning messages for the "bluetooth" permission vary based on 273 // the permissions parameters, no message ID or message text is specified 274 // here. The message ID and text used will be determined at run-time in the 275 // |BluetoothPermission| class. 276 { APIPermission::kBluetooth, "bluetooth", APIPermissionInfo::kFlagNone, 277 0, PermissionMessage::kNone, 278 &CreateAPIPermission<BluetoothPermission> }, 279 { APIPermission::kUsb, "usb", APIPermissionInfo::kFlagNone, 280 IDS_EXTENSION_PROMPT_WARNING_USB, 281 PermissionMessage::kUsb }, 282 { APIPermission::kUsbDevice, "usbDevices", 283 APIPermissionInfo::kFlagNone, 0, PermissionMessage::kNone, 284 &CreateAPIPermission<UsbDevicePermission> }, 285 { APIPermission::kSystemIndicator, "systemIndicator", 286 APIPermissionInfo::kFlagNone, 287 IDS_EXTENSION_PROMPT_WARNING_SYSTEM_INDICATOR, 288 PermissionMessage::kSystemIndicator }, 289 { APIPermission::kSystemCpu, "system.cpu" }, 290 { APIPermission::kSystemInfoMemory, "systemInfo.memory" }, 291 { APIPermission::kSystemDisplay, "system.display" }, 292 { APIPermission::kPointerLock, "pointerLock" }, 293 { APIPermission::kFullscreen, "fullscreen" }, 294 { APIPermission::kAudio, "audio" }, 295 }; 296 297 std::vector<APIPermissionInfo*> permissions; 298 299 for (size_t i = 0; i < ARRAYSIZE_UNSAFE(PermissionsToRegister); ++i) { 300 const PermissionRegistration& pr = PermissionsToRegister[i]; 301 permissions.push_back(new APIPermissionInfo( 302 pr.id, pr.name, pr.l10n_message_id, 303 pr.message_id ? pr.message_id : PermissionMessage::kNone, 304 pr.flags, 305 pr.constructor)); 306 } 307 return permissions; 308} 309 310std::vector<PermissionsInfo::AliasInfo> ChromeAPIPermissions::GetAllAliases() 311 const { 312 // Register aliases. 313 std::vector<PermissionsInfo::AliasInfo> aliases; 314 aliases.push_back(PermissionsInfo::AliasInfo( 315 "unlimitedStorage", kOldUnlimitedStoragePermission)); 316 aliases.push_back(PermissionsInfo::AliasInfo( 317 "tabs", kWindowsPermission)); 318 return aliases; 319} 320 321} // namespace extensions 322