Declaración de permisos de API en el manifiesto

Para usar la mayoría de las API, la chrome.* extensión debe declarar su intención en los permissions campos del manifiesto. Una extensión puede declarar permisos mediante una cadena de permisos de la tabla siguiente o usar un patrón para que coincida con cadenas similares. Los permisos ayudan a restringir la extensión si se ve comprometida por malware. Algunos permisos se muestran a los usuarios para su consentimiento antes de la instalación de la extensión, o en tiempo de ejecución, según sea necesario; estas son advertencias de permisos.

Si una API requiere que declare permisos en el manifiesto, consulte la documentación de esa API para comprender los permisos necesarios. Por ejemplo, en la página API de Storage se describe cómo declarar el storage permiso.

Este es un ejemplo de la parte de permisos de un archivo de manifiesto:

Manifiesto V3

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

Manifiesto V2

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

En la tabla siguiente se enumeran las cadenas de permisos disponibles actualmente para usar en el manifiesto y las descripciones.

Cadena de permiso	Detalles
activeTab	Solicita que se concedan permisos a la extensión según la activeTab especificación.
alarms	Proporciona a la extensión acceso a la chrome.alarms API.
background	Hace que Microsoft Edge se inicie pronto y se cierre tarde, de modo que las extensiones puedan tener una vida más larga. Cuando cualquier extensión instalada tiene background permiso, Microsoft Edge se ejecuta de forma invisible en cuanto el usuario inicia sesión en el equipo del usuario y antes de que el usuario inicie Microsoft Edge. El background permiso también hace que Microsoft Edge continúe ejecutándose, incluso después de cerrar su última ventana, hasta que el usuario salga explícitamente de Microsoft Edge. Nota: Las extensiones deshabilitadas se tratan como si no estuvieran instaladas. Debe usar el background permiso con scripts en segundo plano.
bookmarks	Proporciona a la extensión acceso a la chrome.bookmarks API.
browsingData	Proporciona a la extensión acceso a la chrome.browsingData API.
certificateProvider	Proporciona a la extensión acceso a la chrome.certificateProvider API.
clipboardRead	Obligatorio si la extensión usa document.execCommand('paste').
clipboardWrite	Indica que la extensión usa document.execCommand('copy') o document.execCommand('cut').
contentSettings	Proporciona a la extensión acceso a la chrome.contentSettings API.
contextMenus	Proporciona a la extensión acceso a la chrome.contextMenus API.
cookies	Proporciona a la extensión acceso a la chrome.cookies API.
debugger	Proporciona a la extensión acceso a la chrome.debugger API.
declarativeContent	Proporciona a la extensión acceso a la chrome.declarativeContent API.
declarativeNetRequest	Proporciona a la extensión acceso a la chrome.declarativeNetRequest API. Permite que la extensión bloquee y actualice las solicitudes sin necesidad de permisos de host, pero requiere permisos de host para redirigir solicitudes o modificar encabezados.
declarativeNetRequestWithHostAccess	Proporciona a la extensión acceso a la chrome.declarativeNetRequest API. Siempre requiere permisos de host en la dirección URL de la solicitud y en el iniciador para actuar sobre la solicitud.
declarativeNetRequestFeedback	Concede a la extensión acceso a eventos y métodos dentro de la chrome.declarativeNetRequest API, que devuelve información sobre las reglas declarativas coincidentes.
declarativeWebRequest	Proporciona a la extensión acceso a la chrome.declarativeWebRequest API.
desktopCapture	Proporciona a la extensión acceso a la chrome.desktopCapture API.
documentScan	Proporciona a la extensión acceso a la chrome.documentScan API.
downloads	Proporciona a la extensión acceso a la chrome.downloads API.
enterprise.deviceAttributes	Proporciona a la extensión acceso a la chrome.enterprise.deviceAttributes API.
enterprise.hardwarePlatform	Proporciona a la extensión acceso a la chrome.enterprise.hardwarePlatform API.
enterprise.networkingAttributes	Proporciona a la extensión acceso a la chrome.enterprise.networkingAttributes API.
enterprise.platformKeys	Proporciona a la extensión acceso a la chrome.enterprise.platformKeys API.
experimental	Obligatorio si la extensión usa alguna chrome.experimental.* API.
fileBrowserHandler	Proporciona a la extensión acceso a la chrome.fileBrowserHandler API.
fileSystemProvider	Proporciona a la extensión acceso a la chrome.fileSystemProvider API.
fontSettings	Proporciona a la extensión acceso a la chrome.fontSettings API.
geolocation	Permite que la extensión use la API de geolocalización sin pedir permiso al usuario.
history	Proporciona a la extensión acceso a la chrome.history API.
identity	Proporciona a la extensión acceso a la chrome.identity API.
idle	Proporciona a la extensión acceso a la chrome.idle API.
loginState	Proporciona a la extensión acceso a la chrome.loginState API.
management	Proporciona a la extensión acceso a la chrome.management API.
nativeMessaging	Proporciona a la extensión acceso a la API de mensajería nativa.
notifications	Proporciona a la extensión acceso a la chrome.notifications API.
pageCapture	Proporciona a la extensión acceso a la chrome.pageCapture API.
platformKeys	Proporciona a la extensión acceso a la chrome.platformKeys API.
power	Proporciona a la extensión acceso a la chrome.power API.
printerProvider	Proporciona a la extensión acceso a la chrome.printerProvider API.
printing	Proporciona a la extensión acceso a la chrome.printing API.
printingMetrics	Proporciona a la extensión acceso a la chrome.printingMetrics API.
privacy	Proporciona a la extensión acceso a la chrome.privacy API.
processes	Proporciona a la extensión acceso a la chrome.processes API.
proxy	Proporciona a la extensión acceso a la chrome.proxy API.
scripting	Proporciona a la extensión acceso a la chrome.scripting API.
search	Proporciona a la extensión acceso a la chrome.search API.
sessions	Proporciona a la extensión acceso a la chrome.sessions API.
sidePanel	Proporciona a la extensión acceso a la chrome.sidePanel API. Consulte Desarrollo de una extensión para la barra lateral de Microsoft Edge.
signedInDevices	Proporciona a la extensión acceso a la chrome.signedInDevices API.
storage	Proporciona a la extensión acceso a la chrome.storage API.
system.cpu	Proporciona a la extensión acceso a la chrome.system.cpu API.
system.display	Proporciona a la extensión acceso a la chrome.system.display API.
system.memory	Proporciona a la extensión acceso a la chrome.system.memory API.
system.storage	Proporciona a la extensión acceso a la chrome.system.storage API.
tabCapture	Proporciona a la extensión acceso a la chrome.tabCapture API.
tabGroups	Proporciona a la extensión acceso a la chrome.tabGroups API.
tabs	Proporciona a la extensión acceso a campos con privilegios de los objetos Tab que pueden usar varias API, como chrome.tabs y chrome.windows. En muchas circunstancias, la extensión no necesita declarar el tabs permiso para usar estas API.
topSites	Proporciona a la extensión acceso a la chrome.topSites API.
tts	Proporciona a la extensión acceso a la chrome.tts API.
ttsEngine	Proporciona a la extensión acceso a la chrome.ttsEngine API.
unlimitedStorage	Proporciona una cuota ilimitada para almacenar datos del lado cliente, como bases de datos y archivos de almacenamiento local. Sin este permiso, la extensión se limita a 5 MB de almacenamiento local. Este permiso solo se aplica a la SQL Database web y a la caché de aplicaciones (consulte El problema 58985: El permiso almacenamiento ilimitado debe aplicarse al almacenamiento local). Actualmente, este permiso no funciona con subdominios comodín como http://*.contoso.com.
vpnProvider	Proporciona a la extensión acceso a la chrome.vpnProvider API.
wallpaper	Proporciona a la extensión acceso a la chrome.wallpaper API.
webNavigation	Proporciona a la extensión acceso a la chrome.webNavigation API.
webRequest	Proporciona a la extensión acceso a la chrome.webRequest API.
webRequestBlocking	Obligatorio si la extensión usa la chrome.webRequest API para bloquear las solicitudes.

Nota:

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por Google y usadas según los términos descritos en la licencia internacional creative Commons Attribution 4.0. La página original se encuentra aquí.

Esta obra está licenciada bajo una Licencia Internacional Creative Commons Attribution 4.0.

Vea también

• Introducción a las extensiones de Microsoft Edge