Die meisten Chrome-Geräte.* APIs muss der Intent Ihrer Erweiterung oder App im Feld "permissions" des Manifests deklariert werden. Jede Berechtigung kann entweder aus einer Liste bekannter Strings (z. B. „Geolocation“) oder einem Übereinstimmungsmuster bestehen, das Zugriff auf einen oder mehrere Hosts gewährt. Berechtigungen helfen dabei, den Schaden zu begrenzen, wenn Ihre Erweiterung oder App durch Malware manipuliert wird. Einige Berechtigungen werden den Nutzern auch vor der Installation angezeigt, wie unter Berechtigungswarnungen beschrieben.
Wenn Sie für eine API eine Berechtigung im Manifest deklarieren müssen, erfahren Sie in der zugehörigen Dokumentation, wie das geht. Auf der Seite Speicher erfahren Sie beispielsweise, wie Sie die Berechtigung „Speicher“ deklarieren.
Hier ein Beispiel für den Berechtigungsteil einer Manifestdatei:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
In der folgenden Tabelle sind die derzeit verfügbaren Berechtigungen aufgeführt:
| Berechtigung | Beschreibung |
|---|---|
"activeTab" |
Fordert an, dass der Erweiterung Berechtigungen gemäß der activeTab-Spezifikation gewährt werden. |
"alarms" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.alarms API. |
"background" |
Lässt Chrome frühzeitig starten und spät herunterfahren, sodass Apps und Erweiterungen länger nutzen können. Wenn eine installierte gehostete Anwendung, gepackte App oder Erweiterung eine Hintergrundberechtigung hat, wird Chrome (unsichtbar) ausgeführt, sobald sich der Nutzer an seinem Computer anmeldet und noch bevor der Nutzer Chrome startet. Die Berechtigung „Hintergrund“ sorgt dafür, dass Chrome auch nach dem Schließen des letzten Fensters so lange ausgeführt wird, bis der Nutzer Chrome explizit schließt. Hinweis:Deaktivierte Apps und Erweiterungen werden so behandelt, als wären sie nicht installiert.
Die Berechtigung „Hintergrund“ wird in der Regel mit einer Hintergrundseite, einer Ereignisseite oder (für gehostete Apps) mit einem Hintergrundfenster verwendet. |
"bookmarks" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.bookmarks API. |
"browsingData" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.browsingData API. |
"certificateProvider" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.certificateProvider API. |
"clipboardRead" |
Erforderlich, wenn die Erweiterung oder App document.execCommand('paste') verwendet. |
"clipboardWrite" |
Gibt an, dass die Erweiterung oder App document.execCommand('copy') oder document.execCommand('cut') verwendet. Diese Berechtigung ist für gehostete Apps erforderlich und wird für Erweiterungen und gepackte Anwendungen empfohlen. |
"contentSettings" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.contentSettings API. |
"contextMenus" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.contextMenus API. |
"cookies" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.cookies API. |
"debugger" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.debugger API. |
"declarativeContent" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.declarativeContent API. |
"declarativeNetRequest" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.declarativeNetRequest API. |
"declarativeNetRequestFeedback" |
Gewährt der Erweiterung Zugriff auf Ereignisse und Methoden innerhalb der chrome.declarativeNetRequest API, die Informationen zu übereinstimmenden deklarativen Regeln zurückgeben. |
"declarativeWebRequest" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.declarativeWebRequest API. |
"desktopCapture" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.desktopCapture API. |
"documentScan" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.documentScan API. |
"downloads" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.downloads API. |
"enterprise.deviceAttributes" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.deviceAttributes API. |
"enterprise.hardwarePlatform" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.hardwarePlatform API. |
"enterprise.networkingAttributes" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.networkingAttributes API. |
"enterprise.platformKeys" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.platformKeys API. |
"experimental" |
Erforderlich, wenn die Erweiterung oder App eine beliebige chrome.experimental.* APIs verfügbar sind. |
"fileBrowserHandler" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.fileBrowserHandler API. |
"fileSystemProvider" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.fileSystemProvider API. |
"fontSettings" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.fontSettings API. |
"gcm" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.gcm API. |
"geolocation" |
Die Erweiterung oder App darf die Geolocation API verwenden, ohne den Nutzer nach einer Berechtigung zu fragen. |
"history" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.history API. |
"identity" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.identity API. |
"idle" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.idle API. |
"loginState" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.loginState API. |
"management" |
Der Erweiterung wird Zugriff auf die chrome.management API gewährt. |
"nativeMessaging" |
Gewährt Ihrer Erweiterung Zugriff auf die native Messaging API. |
"notifications" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.notifications API. |
"pageCapture" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.pageCapture API. |
"platformKeys" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.platformKeys API. |
"power" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.power API. |
"printerProvider" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.printerProvider API. |
"printing" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.printing API. |
"printingMetrics" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.printingMetrics API. |
"privacy" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.privacy API. |
"processes" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.processes API. |
"proxy" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.proxy API. |
"scripting" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.scripting API. |
"search" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.search API. |
"sessions" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.sessions API. |
"signedInDevices" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.signedInDevices API. |
"storage" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.storage API. |
"system.cpu" |
Gewährt Ihrer Erweiterung Zugriff auf die API chrome.system.cpu. |
"system.display" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.system.display API. |
"system.memory" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.system.memory API. |
"system.storage" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.system.storage API. |
"tabCapture" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.tabCapture API. |
"tabGroups" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.tabGroups API. |
"tabs" |
Gewährt Ihrer Erweiterung Zugriff auf privilegierte Felder der Tab-Objekte, die von mehreren APIs verwendet werden, einschließlich chrome.tabs und chrome.windows. In vielen Fällen muss die Berechtigung "tabs" für die Verwendung dieser APIs nicht deklariert werden. |
"topSites" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.topSites API. |
"tts" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.tts API. |
"ttsEngine" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.ttsEngine API. |
"unlimitedStorage" |
Bietet ein unbegrenztes Kontingent zum Speichern clientseitiger Daten wie Datenbanken und lokale Speicherdateien.
Ohne diese Berechtigung ist der lokale Speicherplatz der Erweiterung oder App auf 5 MB begrenzt. Hinweis: Diese Berechtigung gilt nur für Web SQL-Datenbanken und den Anwendungscache (siehe Problem 58985). Außerdem funktioniert es derzeit nicht mit Platzhalter-Subdomains wie
http://*.example.com. |
"vpnProvider" |
Ihrer Erweiterung Zugriff auf die chrome.vpnProvider API. |
"wallpaper" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.wallpaper API. |
"webNavigation" |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.webNavigation API. |
"webRequest" |
Ermöglicht Ihrer Erweiterung den Zugriff auf die chrome.webRequest API. |
"webRequestBlocking" |
Erforderlich, wenn die Erweiterung die chrome.webRequest API blockiert. |