Разрешения

Разрешения хоста задаются как маски соответствия, и каждая маска определяет группу URL-адресов, для которых расширение запрашивает дополнительные привилегии. Например, разрешение хоста может быть "*://developer.mozilla.org/*".

Дополнительные привилегии включают:

• XMLHttpRequest и fetch доступ к этим источникам без ограничений между источниками (даже для запросов, выполненных из скриптов содержимого)
• возможность чтения метаданных, специфичных для вкладки, без разрешения «вкладки», таких как свойства url, title и favIconUrl объектов tabs.Tab
• возможность программно вставлять скрипты (используя tabs.executeScript()) в страницы, серверные из этих источников
• возможность получения событий от API webrequest для этих хостов
• возможность доступа к файлам cookie для данного хоста с помощью API cookies, при условии, что также включено разрешение API "cookies".
• обход защиты от отслеживания для страниц расширения, где хост задан как полный домен или с подстановкой. Однако скрипты содержимого могут обойти защиту от отслеживания только для хостов, указанных с полным доменом.

В Firefox, начиная с версии 56, расширения автоматически получают разрешения хоста для своего собственного источника, который имеет вид:

moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/

где 60a20a9b-1ad4-af49-9b6c-c64c98c37920 — внутренний идентификатор расширения. Расширение может получить этот URL программно, вызвав extension.getURL():

browser.extension.getURL("");
// moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/

Разрешения API указываются как ключевые слова, и каждое ключевое слово обозначает API WebExtension, который расширение хочет использовать.

Эти разрешения доступны в манифесте V2 и выше, если не указано иное:

• activeTab
• alarms
• background
• bookmarks
• browserSettings
• browsingData
• captivePortal
• clipboardRead
• clipboardWrite
• contentSettings
• contextMenus
• contextualIdentities
• cookies
• debugger
• declarativeNetRequest
• declarativeNetRequestFeedback
• declarativeNetRequestWithHostAccess
• dns
• downloads
• downloads.open
• find
• geolocation
• history
• identity
• idle
• management
• menus
• menus.overrideContext
• nativeMessaging
• notifications
• pageCapture
• pkcs11
• privacy
• proxy
• scripting
• search
• sessions
• storage
• tabHide
• tabs
• theme
• topSites
• unlimitedStorage
• webNavigation
• webRequest
• webRequestBlocking
• webRequestFilterResponse
• webRequestFilterResponse.serviceWorkerScript

В большинстве случаев разрешение просто предоставляет доступ к API, за исключением следующих случаев:

• tabs предоставляет доступ к privileged parts of the tabs API без необходимости разрешений хоста: Tab.url, Tab.title и Tab.faviconUrl.
  • В Firefox 85 и более ранних версиях вам также требуется tabs, если вы хотите включить url в параметр queryInfo для tabs.query(). Остальной API tabs можно использовать без запроса разрешений.
  • Начиная с Firefox 86 и Chrome 50, можно использовать соответствия разрешений хоста вместо разрешения «вкладки».
• webRequestBlocking позволяет использовать аргумент "blocking", поэтому вы можете modify and cancel requests.
• downloads.open позволяет использовать API downloads.open().
• tabHide позволяет использовать API tabs.hide().

Это разрешение задаётся как "activeTab". Если у расширения есть разрешение activeTab, то при взаимодействии пользователя с расширением расширению предоставляются дополнительные привилегии только для активной вкладки.

«Взаимодействие пользователя» включает:

• нажатие пользователем действия расширения в строке браузера или действия на странице
• выбор пункта контекстного меню
• активацию сочетания клавиш, определённого расширением

Дополнительные привилегии:

• Возможность вставки JavaScript или CSS в вкладку программно, используя browser.tabs.executeScript() и browser.tabs.insertCSS()
• Доступ к привилегированным частям API вкладок для текущей вкладки: Tab.url, Tab.title и Tab.faviconUrl.

Цель этого разрешения — позволить расширениям выполнять распространённый сценарий использования без предоставления им очень мощных разрешений. Многие расширения хотят «сделать что-то с текущей страницей, когда пользователь попросит».

Например, рассмотрим расширение, которое хочет выполнить скрипт на текущей странице, когда пользователь нажимает действие расширения в строке браузера. Если бы разрешение activeTab не существовало, расширению потребовалось бы запросить разрешение хоста <all_urls>. Но это даёт расширению больше прав, чем ему нужно: теперь оно может выполнять скрипты в любой вкладке, в любое время, а не только в активной вкладке и только в ответ на действие пользователя.

Обычно вкладке, которой предоставлено разрешение activeTab, является только текущая активная вкладка, за исключением одного случая. API menus позволяет расширению создавать пункт меню, который отображается, если пользователь нажимает правую кнопку мыши на вкладке (то есть на элементе в строке вкладок, который позволяет пользователю переключаться с одной вкладки на другую).

Если пользователь нажимает такой элемент, то разрешение activeTab предоставляется для вкладки, на которую пользователь нажал, даже если она не является активной вкладкой (начиная с Firefox 63, ошибка Firefox 1446956).

Существует два разрешения, которые позволяют расширению взаимодействовать с буфером обмена:

clipboardWrite

Запись в буфер обмена с использованием Clipboard.write(), Clipboard.writeText(), document.execCommand("copy") или document.execCommand("cut")

clipboardRead

Чтение из буфера обмена с использованием Clipboard.read(), Clipboard.readText() или document.execCommand("paste")

См. Взаимодействие с буфером обмена для получения дополнительной информации.

Разрешение unlimitedStorage:

• Разрешает расширениям превышать любые квоты, накладываемые API storage.local
• В Firefox, разрешает расширениям создавать "постоянную" базу данных IndexedDB без запроса разрешения у пользователя при её создании.

 "permissions": ["*://developer.mozilla.org/*"]

Только в Manifest V2 запрашивайте привилегированный доступ к страницам под developer.mozilla.org.

  "permissions": ["tabs"]

Запрашивайте доступ к привилегированным частям API tabs.

  "permissions": ["*://developer.mozilla.org/*", "tabs"]

Только в Manifest V2 запрашивайте оба вышеперечисленных разрешения.