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