Déclarer des autorisations d’API dans le manifeste

Article
06/23/2023

Pour utiliser la chrome.* plupart des API, votre extension doit déclarer son intention dans les permissions champs du manifeste. Une extension peut déclarer des autorisations à l’aide d’une chaîne d’autorisation de la table qui suit, ou utiliser un modèle pour faire correspondre des chaînes similaires. Les autorisations permettent de limiter votre extension si elle est compromise par un programme malveillant. Certaines autorisations sont affichées aux utilisateurs pour leur consentement avant l’installation de l’extension, ou au moment de l’exécution, si nécessaire ; il s’agit d’avertissements d’autorisation.

Si une API vous oblige à déclarer des autorisations dans le manifeste, consultez la documentation de cette API pour comprendre les autorisations nécessaires. Par exemple, la page API de stockage décrit comment déclarer l’autorisation storage .

Voici un exemple de la partie autorisations d’un fichier manifeste :

Manifeste V3
Manifeste V2

"permissions": [
  "tabs",
  "bookmarks",
  "storage"
],
"optional_permissions": [
  "unlimitedStorage"
],
"host_permissions": [
  "http://www.blogger.com/",
  "http://*.google.com/"
],

"permissions": [
  "tabs",
  "bookmarks",
  "storage",
  "http://www.blogger.com/",
  "http://*.google.com/"
],
"optional_permissions": [
  "unlimitedStorage"
]

Le tableau suivant répertorie les chaînes d’autorisation actuellement disponibles à utiliser dans votre manifeste, ainsi que les descriptions.

Chaîne d’autorisation	Détails
`activeTab`	Demande que l’extension dispose d’autorisations conformément à la `activeTab` spécification.
`alarms`	Donne à votre extension l’accès à l’API `chrome.alarms` .
`background`	Permet à Microsoft Edge de démarrer tôt et de s’arrêter tard, afin que les extensions puissent avoir une durée de vie plus longue. Lorsqu’une extension installée dispose `background` d’une autorisation, Microsoft Edge s’exécute de manière invisible dès que l’utilisateur se connecte à l’ordinateur de l’utilisateur et avant que l’utilisateur lance Microsoft Edge. L’autorisation `background` permet également à Microsoft Edge de continuer à s’exécuter, même après la fermeture de sa dernière fenêtre, jusqu’à ce que l’utilisateur quitte explicitement Microsoft Edge. Note: Les extensions désactivées sont traitées comme si elles n’ont pas été installées. Vous devez utiliser l’autorisation `background` avec des scripts en arrière-plan.
`bookmarks`	Donne à votre extension l’accès à l’API `chrome.bookmarks` .
`browsingData`	Donne à votre extension l’accès à l’API `chrome.browsingData` .
`certificateProvider`	Donne à votre extension l’accès à l’API `chrome.certificateProvider` .
`clipboardRead`	Obligatoire si l’extension utilise `document.execCommand('paste')`.
`clipboardWrite`	Indique que l’extension utilise `document.execCommand('copy')` ou `document.execCommand('cut')`.
`contentSettings`	Donne à votre extension l’accès à l’API `chrome.contentSettings` .
`contextMenus`	Donne à votre extension l’accès à l’API `chrome.contextMenus` .
`cookies`	Donne à votre extension l’accès à l’API `chrome.cookies` .
`debugger`	Donne à votre extension l’accès à l’API `chrome.debugger` .
`declarativeContent`	Donne à votre extension l’accès à l’API `chrome.declarativeContent` .
`declarativeNetRequest`	Donne à votre extension l’accès à l’API `chrome.declarativeNetRequest` . Permet à l’extension de bloquer et de mettre à niveau les demandes sans nécessiter d’autorisations d’hôte, mais nécessite des autorisations d’hôte pour rediriger les demandes ou modifier les en-têtes.
`declarativeNetRequestWithHostAccess`	Donne à votre extension l’accès à l’API `chrome.declarativeNetRequest` . Nécessite toujours des autorisations d’hôte sur l’URL de la demande et sur l’initiateur pour agir sur la demande.
`declarativeNetRequestFeedback`	Accorde à l’extension l’accès aux événements et aux méthodes au sein de l’API `chrome.declarativeNetRequest` , qui retourne des informations sur les règles déclaratives mises en correspondance.
`declarativeWebRequest`	Donne à votre extension l’accès à l’API `chrome.declarativeWebRequest` .
`desktopCapture`	Donne à votre extension l’accès à l’API `chrome.desktopCapture` .
`documentScan`	Donne à votre extension l’accès à l’API `chrome.documentScan` .
`downloads`	Donne à votre extension l’accès à l’API `chrome.downloads` .
`enterprise.deviceAttributes`	Donne à votre extension l’accès à l’API `chrome.enterprise.deviceAttributes` .
`enterprise.hardwarePlatform`	Donne à votre extension l’accès à l’API `chrome.enterprise.hardwarePlatform` .
`enterprise.networkingAttributes`	Donne à votre extension l’accès à l’API `chrome.enterprise.networkingAttributes` .
`enterprise.platformKeys`	Donne à votre extension l’accès à l’API `chrome.enterprise.platformKeys` .
`experimental`	Obligatoire si l’extension utilise une `chrome.experimental.*` API.
`fileBrowserHandler`	Donne à votre extension l’accès à l’API `chrome.fileBrowserHandler` .
`fileSystemProvider`	Donne à votre extension l’accès à l’API `chrome.fileSystemProvider` .
`fontSettings`	Donne à votre extension l’accès à l’API `chrome.fontSettings` .
`geolocation`	Permet à l’extension d’utiliser l’API de géolocalisation sans demander l’autorisation à l’utilisateur.
`history`	Donne à votre extension l’accès à l’API `chrome.history` .
`identity`	Donne à votre extension l’accès à l’API `chrome.identity` .
`idle`	Donne à votre extension l’accès à l’API `chrome.idle` .
`loginState`	Donne à votre extension l’accès à l’API `chrome.loginState` .
`management`	Donne à votre extension l’accès à l’API `chrome.management` .
`nativeMessaging`	Donne à votre extension l’accès à l’API de messagerie native.
`notifications`	Donne à votre extension l’accès à l’API `chrome.notifications` .
`pageCapture`	Donne à votre extension l’accès à l’API `chrome.pageCapture` .
`platformKeys`	Donne à votre extension l’accès à l’API `chrome.platformKeys` .
`power`	Donne à votre extension l’accès à l’API `chrome.power` .
`printerProvider`	Donne à votre extension l’accès à l’API `chrome.printerProvider` .
`printing`	Donne à votre extension l’accès à l’API `chrome.printing` .
`printingMetrics`	Donne à votre extension l’accès à l’API `chrome.printingMetrics` .
`privacy`	Donne à votre extension l’accès à l’API `chrome.privacy` .
`processes`	Donne à votre extension l’accès à l’API `chrome.processes` .
`proxy`	Donne à votre extension l’accès à l’API `chrome.proxy` .
`scripting`	Donne à votre extension l’accès à l’API `chrome.scripting` .
`search`	Donne à votre extension l’accès à l’API `chrome.search` .
`sessions`	Donne à votre extension l’accès à l’API `chrome.sessions` .
`sidePanel`	Donne à votre extension l’accès à l’API `chrome.sidePanel` . Consultez Développer une extension pour la barre latérale Microsoft Edge.
`signedInDevices`	Donne à votre extension l’accès à l’API `chrome.signedInDevices` .
`storage`	Donne à votre extension l’accès à l’API `chrome.storage` .
`system.cpu`	Donne à votre extension l’accès à l’API `chrome.system.cpu` .
`system.display`	Donne à votre extension l’accès à l’API `chrome.system.display` .
`system.memory`	Donne à votre extension l’accès à l’API `chrome.system.memory` .
`system.storage`	Donne à votre extension l’accès à l’API `chrome.system.storage` .
`tabCapture`	Donne à votre extension l’accès à l’API `chrome.tabCapture` .
`tabGroups`	Donne à votre extension l’accès à l’API `chrome.tabGroups` .
`tabs`	Donne à votre extension l’accès aux champs privilégiés des objets Tab qui peuvent être utilisés par plusieurs API, notamment `chrome.tabs` et `chrome.windows`. Dans de nombreux cas, votre extension n’a pas besoin de déclarer l’autorisation `tabs` pour utiliser ces API.
`topSites`	Donne à votre extension l’accès à l’API `chrome.topSites` .
`tts`	Donne à votre extension l’accès à l’API `chrome.tts` .
`ttsEngine`	Donne à votre extension l’accès à l’API `chrome.ttsEngine` .
`unlimitedStorage`	Fournit un quota illimité pour le stockage des données côté client, telles que des bases de données et des fichiers de stockage locaux. Sans cette autorisation, l’extension est limitée à 5 Mo de stockage local. Cette autorisation s’applique uniquement aux SQL Database web et au cache d’application (voir Problème 58985 : L’autorisation de stockage illimité doit s’appliquer au stockage local). Cette autorisation ne fonctionne actuellement pas avec les sous-domaines génériques tels que `http://*.contoso.com`.
`vpnProvider`	Donne à votre extension l’accès à l’API `chrome.vpnProvider` .
`wallpaper`	Donne à votre extension l’accès à l’API `chrome.wallpaper` .
`webNavigation`	Donne à votre extension l’accès à l’API `chrome.webNavigation` .
`webRequest`	Donne à votre extension l’accès à l’API `chrome.webRequest` .
`webRequestBlocking`	Obligatoire si l’extension utilise l’API `chrome.webRequest` pour bloquer les demandes.

Remarque

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Google et utilisées conformément aux termes décrits dans la licence internationale Creative Commons Attribution 4.0. La page d’origine se trouve ici.

Cette œuvre est concédée sous licence creative commons attribution 4.0 international.

Voir aussi

Vue d’ensemble des extensions Microsoft Edge

Partager via

Déclarer des autorisations d’API dans le manifeste

Voir aussi

Commentaires

Ressources supplémentaires