Quyền "activeTab"

Quyền "activeTab" cấp cho tiện ích quyền truy cập tạm thời vào thẻ đang hoạt động khi người dùng gọi tiện ích, chẳng hạn như bằng cách nhấp vào hành động của tiện ích. Quyền truy cập vào thẻ sẽ kéo dài trong khi người dùng ở trên trang đó và bị thu hồi khi người dùng rời khỏi hoặc đóng thẻ. Ví dụ: nếu người dùng gọi tiện ích trên https://example.com rồi chuyển đến https://example.com/foo, thì tiện ích sẽ tiếp tục có quyền truy cập vào trang đó. Nếu người dùng chuyển đến https://chromium.org, thì quyền truy cập sẽ bị thu hồi.

Đây là một giải pháp thay thế cho nhiều trường hợp sử dụng "<all_urls>", nhưng không hiển thị thông báo cảnh báo trong quá trình cài đặt:

Không có "activeTab":

Với "activeTab":

Không cấp quyền truy cập vào các trang bị hạn chế, chẳng hạn như trang chrome://.

Ví dụ

Xem tiện ích mẫu 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
    });
  }
});

Động lực

Hãy xem xét một tiện ích cắt web có hành động và mục trong trình đơn theo bối cảnh. Tiện ích này có thể chỉ thực sự cần truy cập vào các thẻ khi người dùng nhấp vào hành động của tiện ích hoặc khi mục trong trình đơn theo bối cảnh của tiện ích được thực thi.

Nếu không có "activeTab", tiện ích này sẽ cần yêu cầu quyền truy cập đầy đủ và liên tục vào mọi trang web, chỉ để tiện ích này có thể thực hiện công việc của mình nếu người dùng gọi tiện ích này. Đây là một quyền hạn rất lớn để giao phó cho một tiện ích đơn giản như vậy. Và nếu tiện ích bị xâm phạm, kẻ tấn công sẽ có quyền truy cập vào mọi thứ mà tiện ích có.

Ngược lại, một tiện ích có quyền "activeTab" chỉ có quyền truy cập vào một thẻ để phản hồi một cử chỉ của người dùng rõ ràng. Nếu tiện ích bị xâm phạm, kẻ tấn công sẽ phải đợi người dùng gọi tiện ích trước khi có quyền truy cập. Và quyền truy cập đó chỉ kéo dài cho đến khi thẻ được điều hướng hoặc đóng.

Những việc mà "activeTab" cho phép

Khi quyền "activeTab" được bật cho một thẻ, tiện ích có thể:

• Gọi scripting.insertCSS() hoặc scripting.executeScript() trên thẻ đó nếu quyền "scripting" cũng được khai báo (như trong ví dụ ở trên).
• Lấy URL, tiêu đề và biểu tượng trang web cho thẻ đó thông qua một API trả về đối tượng tabs.Tab (về cơ bản, "activeTab" cấp tạm thời quyền của máy chủ lưu trữ).
• Chặn các yêu cầu mạng trong thẻ đến nguồn gốc khung chính của thẻ bằng API webRequest. Tiện ích tạm thời nhận được quyền của máy chủ lưu trữ cho nguồn gốc khung chính của thẻ.

Gọi activeTab

Các cử chỉ sau đây của người dùng sẽ bật quyền "activeTab":

• Thực thi một hành động
• Thực thi một mục trong trình đơn theo bối cảnh
• Thực thi phím tắt từ API lệnh
• Chấp nhận đề xuất từ API thanh địa chỉ