Thực thi chính sách doanh nghiệp nghiêm ngặt hơn đối với chrome.debugger trong Chrome 155

Ngày xuất bản: Ngày 8 tháng 9 năm 2026, Lần cập nhật gần đây nhất: Ngày 4 tháng 11 năm 2026

Kể từ Chrome 155, Chrome sẽ cập nhật cách áp dụng các quy định hạn chế trong chính sách doanh nghiệp cho các tiện ích sử dụng API chrome.debugger.

Thay đổi này chỉ ảnh hưởng đến các tiện ích chạy trên trình duyệt được quản lý, trong đó quản trị viên đã định cấu hình rõ ràng runtime_blocked_hosts, DisableScreenshots hoặc các quy tắc Ngăn chặn mất dữ liệu (DLP).

Nếu một tiện ích chạy trên trình duyệt không được quản lý hoặc trong môi trường doanh nghiệp không có các quy định hạn chế cụ thể này theo chính sách, thì chrome.debugger sẽ tiếp tục hoạt động bình thường mà không có thay đổi nào.

Tiến trình và kế hoạch triển khai

  • Chrome 155 Beta: Ngày 16 tháng 9 năm 2026
  • Ngày phát hành bản Chrome 155 ổn định: Ngày 6 tháng 10 năm 2026
  • Ngày huỷ bỏ: Ngày 3 tháng 11 năm 2026

Những thay đổi quan trọng trong Chrome 155

Những thay đổi sau đây chỉ ảnh hưởng đến các trình duyệt do doanh nghiệp quản lý:

  • Hạn chế về máy chủ lưu trữ: Nếu một chính sách doanh nghiệp (ExtensionSettings) định cấu hình danh sách máy chủ lưu trữ bị chặn không trống (runtime_blocked_hosts) cho một tiện ích, thì chrome.debugger.attach() sẽ bị từ chối trên tất cả các mục tiêu có:

    "Host access is restricted by policy."

    Điều này xảy ra ngay cả khi các nguồn gốc cụ thể được đưa vào runtime_allowed_hosts.

  • Các quy định hạn chế về ảnh chụp màn hình và DLP: Nếu tính năng chụp ảnh màn hình bị vô hiệu hoá theo chính sách của doanh nghiệp (DisableScreenshots hoặc quy tắc Ngăn chặn mất dữ liệu (DLP)), thì chrome.debugger.attach() sẽ không thành công và có thông báo:

    "Screenshot capture is restricted by policy."

Hồ sơ cá nhân và môi trường không được quản lý vẫn có quyền truy cập không hạn chế vào chrome.debugger như trước đây.

API chrome.debugger cấp quyền truy cập trực tiếp vào Giao thức Chrome DevTools (CDP) để có các chức năng mạnh mẽ, bao gồm cả việc đánh giá tập lệnh tuỳ ý và chặn mạng. Vì CDP hoạt động bên dưới mô hình nguồn gốc của nền tảng web, nên tính năng lọc dựa trên nguồn gốc không thể hạn chế CDP một cách an toàn. Do đó, Chrome 155 giải quyết vấn đề này bằng mô hình tất cả hoặc không có gì, xác thực trước các chính sách doanh nghiệp trên mỗi lệnh gọi chrome.debugger.attach().

Xử lý khéo léo khi bị từ chối đính kèm

Luôn xử lý các trường hợp từ chối đính kèm trong mã tiện ích để đưa ra ý kiến phản hồi rõ ràng cho người dùng doanh nghiệp:

// Promise-based (Manifest V3)
try {
  await chrome.debugger.attach({ tabId }, "1.3");
} catch (error) {
  if (error.message.includes("Host access is restricted by policy")) {
    console.warn("Debugger attach blocked: Extension has host restrictions configured by enterprise policy.");
  } else if (error.message.includes("Screenshot capture is restricted by policy")) {
    console.warn("Debugger attach blocked: Screenshots or DLP restrictions are enforced by enterprise policy.");
  } else {
    console.warn("Debugger attach failed:", error.message);
  }
}

// Callback-based
chrome.debugger.attach({ tabId }, "1.3", () => {
  if (chrome.runtime.lastError) {
    console.warn("Debugger attach failed:", chrome.runtime.lastError.message);
  }
});

Cân nhắc các API cấp cao thay thế

Nếu tiện ích của bạn không nhất thiết phải có quyền truy cập trực tiếp vào CDP, hãy cân nhắc chuyển sang các API tiện ích cấp cao hơn hỗ trợ quyền chi tiết của máy chủ lưu trữ và hoạt động cùng với danh sách cho phép và danh sách chặn của máy chủ lưu trữ doanh nghiệp:

  • Sử dụng API chrome.scripting để thực thi tập lệnh và chèn kiểu vào các trang được phép.
  • Sử dụng API chrome.declarativeNetRequest để kiểm tra, sửa đổi hoặc chặn các yêu cầu mạng một cách khai báo.
  • Sử dụng API chrome.cookies có quyền của máy chủ lưu trữ tiêu chuẩn.

Hướng dẫn dành cho quản trị viên doanh nghiệp

Thông tin cập nhật (ngày 4 tháng 11 năm 2026): Việc thực thi chính sách của Chrome 155 đã được khôi phục thông qua một bản cập nhật cấu hình phía máy chủ. Chrome sẽ tự động tải bản cập nhật này xuống và áp dụng sau khi khởi động lại. Để tắt việc thực thi mà không cần chờ bản cập nhật này, hãy chạy Chrome bằng cờ hiệu dòng lệnh --disable-features=ExtensionDebuggerStrictPolicyRestrictions.

Cho đến khi việc huỷ bỏ có hiệu lực, hướng dẫn sau đây vẫn được áp dụng.

Quản trị viên doanh nghiệp quản lý chính sách tiện ích cần lưu ý rằng các tiện ích yêu cầu quyền trình gỡ lỗi không thể hoạt động khi có các quy định hạn chế một phần đối với máy chủ lưu trữ (runtime_blocked_hosts). Nếu cần chrome.debugger, tiện ích không được có máy chủ lưu trữ bị chặn được định cấu hình trong ExtensionSettings.

Nếu tính năng chụp ảnh màn hình bị tắt bằng DisableScreenshots hoặc quy tắc Ngăn chặn mất dữ liệu (DLP), thì chrome.debugger.attach() sẽ không thành công.

Những tổ chức yêu cầu danh sách chặn máy chủ lưu trữ hoặc quy định hạn chế về ảnh chụp màn hình nên xác minh xem các tiện ích nội bộ hoặc tiện ích được phê duyệt của họ có thể di chuyển sang các API cấp cao hơn như chrome.scripting hoặc chrome.declarativeNetRequest hay không.

Chia sẻ ý kiến phản hồi

Để biết thêm thông tin, hãy tham khảo tài liệu về API chrome.debugger. Nếu bạn có câu hỏi hoặc ý kiến phản hồi, hãy liên hệ qua nhóm trên Google Groups về Tiện ích Chromium.