'activeTab' 권한

"activeTab" 권한은 사용자가 확장 프로그램을 호출할 때(예: 작업을 클릭하여) 확장 프로그램에 현재 활성 탭에 대한 임시 액세스 권한을 부여합니다. 탭에 대한 액세스는 사용자가 해당 페이지에 있는 동안 지속되며 사용자가 다른 페이지로 이동하거나 탭을 닫으면 취소됩니다. 예를 들어 사용자가 https://example.com에서 확장 프로그램을 호출한 후 https://example.com/foo로 이동하면 확장 프로그램은 페이지에 계속 액세스할 수 있습니다. 사용자가 https://chromium.org로 이동하면 액세스가 취소됩니다.

이는 "<all_urls>"의 많은 용도에 대한 대안으로 사용되지만 설치 중에 경고 메시지가 표시되지 않습니다.

"activeTab"를 사용하지 않습니다.

activeTab이 없는 경우

"activeTab"를 사용합니다.

activeTab 사용

chrome:// 페이지와 같은 제한된 페이지에는 액세스 권한이 부여되지 않습니다.

예

Page Redder 샘플 확장 프로그램을 참고하세요.

manifest.json:

{
  "name": "Page Redder",
  "version": "2.0",
  "permissions": [
    "activeTab",
    "scripting"
  ],
  "background": {
    "service_worker": "service-worker.js"
  },
  "action": {
    "default_title": "Make this page red"
  },
  "manifest_version": 3
}

service-worker:

function reddenPage() {
  document.body.style.backgroundColor = 'red';
}

browser.action.onClicked.addListener((tab) => {
  // If the tab URL is not set, it is a restricted page.
  if (tab.url) {
    browser.scripting.executeScript({
      target: { tabId: tab.id },
      func: reddenPage
    });
  }
});

동기

작업과 컨텍스트 메뉴 항목이 있는 웹 클리핑 확장 프로그램을 생각해 보세요. 이 확장 프로그램은 작업이 클릭되거나 컨텍스트 메뉴 항목이 실행될 때만 탭에 액세스하면 됩니다.

"activeTab"가 없으면 이 확장 프로그램은 사용자가 호출하는 경우 작업을 수행할 수 있도록 모든 웹사이트에 대한 전체적이고 영구적인 액세스 권한을 요청해야 합니다. 이러한 간단한 확장 프로그램에 부여하기에는 너무 많은 권한입니다. 확장 프로그램이 손상되면 공격자는 확장 프로그램이 가지고 있던 모든 것에 액세스할 수 있습니다.

반면 "activeTab" 권한이 있는 확장 프로그램은 명시적인 사용자 동작에 대한 응답으로만 탭에 액세스할 수 있습니다. 확장 프로그램이 손상된 경우 공격자는 액세스 권한을 얻기 전에 사용자가 확장 프로그램을 호출할 때까지 기다려야 합니다. 이 액세스 권한은 탭이 탐색되거나 닫힐 때까지만 지속됩니다.

'activeTab'에서 허용하는 작업

탭에 "activeTab" 권한이 사용 설정되어 있는 동안 확장 프로그램은 다음을 실행할 수 있습니다.

  • "scripting" 권한도 선언된 경우(위의 예 참고) 해당 탭에서 scripting.insertCSS() 또는 scripting.executeScript()를 호출합니다.
  • tabs.Tab 객체를 반환하는 API를 통해 해당 탭의 URL, 제목, 파비콘을 가져옵니다(기본적으로 "activeTab"는 호스트 권한을 일시적으로 부여함).
  • webRequest API를 사용하여 탭의 네트워크 요청을 탭의 기본 프레임 출처로 가로챕니다. 확장 프로그램은 탭의 기본 프레임 출처에 대한 호스트 권한을 일시적으로 가져옵니다.

activeTab 호출

다음 사용자 동작은 "activeTab" 권한을 사용 설정합니다.