Per utilizzare la maggior parte di Chrome.* API, l'estensione o l'app deve dichiarare il proprio intent nelle "autorizzazioni" campo del manifest. Ogni autorizzazione può far parte di un elenco di stringhe note (come "geolocalizzazione") o un pattern di corrispondenza che concede accesso a uno o più host. Le autorizzazioni aiutano a limita i danni se la tua estensione o app viene compromessa da malware. Alcune autorizzazioni sono mostrate agli utenti prima dell'installazione, come descritto in dettaglio nella sezione Avvisi relativi alle autorizzazioni.
Se un'API richiede la dichiarazione di un'autorizzazione nel file manifest, la relativa documentazione indica come per farlo. Ad esempio, la pagina Spazio di archiviazione mostra come dichiarare il valore autorizzazione.
Ecco un esempio della parte relativa alle autorizzazioni di un file manifest:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
Nella tabella seguente sono elencate le autorizzazioni attualmente disponibili:
| Autorizzazione | Descrizione |
|---|---|
"activeTab" |
Richiede la concessione delle autorizzazioni all'estensione in base a activeTab e la specifica del prodotto. |
"alarms" |
Concede alla tua estensione l'accesso all'API chrome.alarms. |
"background" |
Consente di avviare e arrestare Chrome in anticipo, in modo che app ed estensioni possano avere un vita privata. Quando un'app ospitata, un'app in pacchetto o un'estensione installate hanno un utilizzo in background autorizzazione, Chrome esegue (in modo invisibile) non appena l'utente accede al proprio computer, prima che l'utente avvii Chrome. Lo "sfondo" consente inoltre di continuare a eseguire Chrome (anche dopo la chiusura dell'ultima finestra) finché l'utente non esplicitamente chiude Chrome. Nota: le app e le estensioni disattivate vengono trattate come se non lo fossero
installato.
In genere utilizzi lo sfondo un'autorizzazione con una pagina in background, una pagina di evento o (per le app ospitate) una finestra in background. |
"bookmarks" |
Concede alla tua estensione l'accesso all'API chrome.bookmarks. |
"browsingData" |
Concede alla tua estensione l'accesso all'API chrome.browsingData. |
"certificateProvider" |
Concede alla tua estensione l'accesso all'API chrome.certificateProvider. |
"clipboardRead" |
Obbligatorio se l'estensione o l'app utilizza document.execCommand('paste'). |
"clipboardWrite" |
Indica che l'estensione o l'app utilizza document.execCommand('copy') oppure
document.execCommand('cut'). Questa autorizzazione è richiesta per le app in hosting. è consigliato
per le estensioni e le app in pacchetto. |
"contentSettings" |
Concede alla tua estensione l'accesso all'API chrome.contentSettings. |
"contextMenus" |
Concede alla tua estensione l'accesso all'API chrome.contextMenus. |
"cookies" |
Concede alla tua estensione l'accesso all'API chrome.cookies. |
"debugger" |
Concede alla tua estensione l'accesso all'API chrome.debugger. |
"declarativeContent" |
Concede alla tua estensione l'accesso all'API chrome.declarativeContent. |
"declarativeNetRequest" |
Concede alla tua estensione l'accesso all'API chrome.declarativeNetRequest. |
"declarativeNetRequestFeedback" |
Concede all'estensione l'accesso a eventi e metodi all'interno dell'API chrome.declarativeNetRequest che restituiscono informazioni sui regole corrispondenti. |
"declarativeWebRequest" |
Concede alla tua estensione l'accesso all'API chrome.declarativeWebRequest. |
"desktopCapture" |
Concede alla tua estensione l'accesso all'API chrome.desktopCapture. |
"documentScan" |
Concede alla tua estensione l'accesso all'API chrome.documentScan. |
"downloads" |
Concede alla tua estensione l'accesso all'API chrome.downloads. |
"enterprise.deviceAttributes" |
Concede alla tua estensione l'accesso all'API chrome.enterprise.deviceAttributes. |
"enterprise.hardwarePlatform" |
Concede alla tua estensione l'accesso all'API chrome.enterprise.hardwarePlatform. |
"enterprise.networkingAttributes" |
Concede alla tua estensione l'accesso all'API chrome.enterprise.networkingAttributes. |
"enterprise.platformKeys" |
Concede alla tua estensione l'accesso all'API chrome.enterprise.platformKeys. |
"experimental" |
Obbligatorio se l'estensione o l'app utilizza chrome.experimental.* di terze parti. |
"fileBrowserHandler" |
Concede alla tua estensione l'accesso all'API chrome.fileBrowserHandler. |
"fileSystemProvider" |
Concede alla tua estensione l'accesso all'API chrome.fileSystemProvider. |
"fontSettings" |
Concede alla tua estensione l'accesso all'API chrome.fontSettings. |
"gcm" |
Concede alla tua estensione l'accesso all'API chrome.gcm. |
"geolocation" |
Consente all'estensione o all'applicazione di utilizzare l'API di geolocalizzazione senza richiedere all'utente autorizzazione. |
"history" |
Concede alla tua estensione l'accesso all'API chrome.history. |
"identity" |
Concede alla tua estensione l'accesso all'API chrome.identity. |
"idle" |
Concede alla tua estensione l'accesso all'API chrome.idle. |
"loginState" |
Concede alla tua estensione l'accesso all'API chrome.loginState. |
"management" |
Concede alla tua estensione l'accesso all'API chrome.management. |
"nativeMessaging" |
Concede alla tua estensione l'accesso all'API Native Messaging. |
"notifications" |
Concede alla tua estensione l'accesso all'API chrome.notifications. |
"pageCapture" |
Concede alla tua estensione l'accesso all'API chrome.pageCapture. |
"platformKeys" |
Concede alla tua estensione l'accesso all'API chrome.platformKeys. |
"power" |
Concede alla tua estensione l'accesso all'API chrome.power. |
"printerProvider" |
Concede alla tua estensione l'accesso all'API chrome.printerProvider. |
"printing" |
Concede alla tua estensione l'accesso all'API chrome.printing. |
"printingMetrics" |
Concede alla tua estensione l'accesso all'API chrome.printingMetrics. |
"privacy" |
Concede alla tua estensione l'accesso all'API chrome.privacy. |
"processes" |
Concede alla tua estensione l'accesso all'API chrome.processes. |
"proxy" |
Concede alla tua estensione l'accesso all'API chrome.proxy. |
"scripting" |
Concede alla tua estensione l'accesso all'API chrome.scripting. |
"search" |
Concede alla tua estensione l'accesso all'API chrome.search. |
"sessions" |
Concede alla tua estensione l'accesso all'API chrome.sessions. |
"signedInDevices" |
Concede alla tua estensione l'accesso all'API chrome.signedInDevices. |
"storage" |
Concede alla tua estensione l'accesso all'API chrome.storage. |
"system.cpu" |
Concede alla tua estensione l'accesso all'API chrome.system.cpu. |
"system.display" |
Concede alla tua estensione l'accesso all'API chrome.system.display. |
"system.memory" |
Concede alla tua estensione l'accesso all'API chrome.system.memory. |
"system.storage" |
Concede alla tua estensione l'accesso all'API chrome.system.storage. |
"tabCapture" |
Concede alla tua estensione l'accesso all'API chrome.tabCapture. |
"tabGroups" |
Concede alla tua estensione l'accesso all'API chrome.tabGroups. |
"tabs" |
Concede all'estensione l'accesso ai campi con privilegi degli oggetti Tab utilizzati da diverse API
inclusi chrome.tabs e chrome.windows. Nella
In molte circostanze la tua estensione non dovrà dichiarare l'autorizzazione "tabs" per l'utilizzo
queste API. |
"topSites" |
Concede alla tua estensione l'accesso all'API chrome.topSites. |
"tts" |
Concede alla tua estensione l'accesso all'API chrome.tts. |
"ttsEngine" |
Concede alla tua estensione l'accesso all'API chrome.ttsEngine. |
"unlimitedStorage" |
Offre una quota illimitata per l'archiviazione dei dati lato client, ad esempio database e file di archiviazione locale.
Senza questa autorizzazione, l'estensione o l'app ha un limite di 5 MB di spazio di archiviazione locale. Nota: questa autorizzazione si applica solo al database SQL web e alla cache dell'applicazione
(vedi il problema 58985). Inoltre, al momento non funziona con i caratteri jolly
come
http://*.example.com. |
"vpnProvider" |
Concede alla tua estensione l'accesso all'API chrome.vpnProvider. |
"wallpaper" |
Concede alla tua estensione l'accesso all'API chrome.wallpaper. |
"webNavigation" |
Concede alla tua estensione l'accesso all'API chrome.webNavigation. |
"webRequest" |
Concede alla tua estensione l'accesso all'API chrome.webRequest. |
"webRequestBlocking" |
Obbligatorio se l'estensione utilizza l'API chrome.webRequest in modalità di blocco. |