Penerapan kebijakan Enterprise yang lebih ketat untuk chrome.debugger di Chrome 155

Dipublikasikan: 8 September 2026, Terakhir diperbarui: 4 November 2026

Mulai Chrome 155, Chrome akan memperbarui cara pembatasan kebijakan Enterprise diterapkan ke ekstensi yang menggunakan API chrome.debugger.

Perubahan ini hanya memengaruhi ekstensi yang berjalan di browser terkelola yang administratornya telah mengonfigurasi runtime_blocked_hosts, DisableScreenshots, atau aturan Pencegahan Kebocoran Data (DLP) secara eksplisit.

Jika ekstensi berjalan di browser yang tidak dikelola, atau di lingkungan perusahaan tanpa batasan kebijakan khusus ini, chrome.debugger akan terus beroperasi secara normal tanpa perubahan.

Linimasa dan peluncuran

  • Chrome 155 Beta: 16 September 2026
  • Peluncuran Chrome 155 Stabil: 6 Oktober 2026
  • Rollback: 3 November 2026

Perubahan penting di Chrome 155

Perubahan berikut hanya memengaruhi browser yang dikelola perusahaan:

  • Batasan host: Jika kebijakan perusahaan (ExtensionSettings) mengonfigurasi daftar host yang diblokir yang tidak kosong (runtime_blocked_hosts) untuk ekstensi, chrome.debugger.attach() akan ditolak di semua target dengan:

    "Host access is restricted by policy."

    Hal ini berlaku meskipun origin tertentu disertakan dalam runtime_allowed_hosts.

  • Pembatasan screenshot dan DLP: Jika pengambilan screenshot dinonaktifkan oleh kebijakan perusahaan (DisableScreenshots atau aturan Pencegahan Kebocoran Data (DLP)), chrome.debugger.attach() akan gagal dengan:

    "Screenshot capture is restricted by policy."

Profil pribadi dan lingkungan yang tidak dikelola akan terus memiliki akses chrome.debugger tanpa batas seperti sebelumnya.

chrome.debugger API memberikan akses langsung Chrome DevTools Protocol (CDP) untuk kemampuan yang andal, termasuk evaluasi skrip arbitrer dan intersepsi jaringan. Karena CDP beroperasi di bawah model origin platform web, pemfilteran berbasis origin tidak dapat membatasinya dengan aman, sehingga Chrome 155 mengatasi hal ini dengan model semua atau tidak sama sekali, yang memvalidasi kebijakan perusahaan di awal pada setiap panggilan chrome.debugger.attach().

Menangani penolakan lampiran dengan baik

Selalu tangani penolakan lampiran dalam kode ekstensi Anda untuk memberikan masukan yang jelas kepada pengguna versi bisnis:

// 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);
  }
});

Pertimbangkan API tingkat tinggi alternatif

Jika ekstensi Anda tidak benar-benar memerlukan akses CDP langsung, pertimbangkan untuk bermigrasi ke API ekstensi tingkat lebih tinggi yang mendukung izin host terperinci dan berfungsi bersama daftar host yang diizinkan dan tidak diizinkan perusahaan:

Panduan untuk administrator perusahaan

Pembaruan (4 November 2026): Penerapan kebijakan Chrome 155 telah di-roll back melalui pembaruan konfigurasi sisi server, yang didownload Chrome secara otomatis dan diterapkan setelah memulai ulang. Untuk menonaktifkan penerapan tanpa menunggu update ini, luncurkan Chrome dengan tanda command line --disable-features=ExtensionDebuggerStrictPolicyRestrictions.

Hingga rollback diterapkan, panduan berikut masih berlaku.

Administrator perusahaan yang mengelola kebijakan ekstensi harus memperhatikan bahwa ekstensi yang memerlukan izin debugger tidak dapat beroperasi dengan pembatasan host parsial (runtime_blocked_hosts). Jika ekstensi memerlukan chrome.debugger, ekstensi tersebut tidak boleh memiliki host yang diblokir yang dikonfigurasi di ExtensionSettings.

Jika pengambilan screenshot dinonaktifkan menggunakan DisableScreenshots atau aturan Pencegahan Kebocoran Data (DLP), chrome.debugger.attach() akan gagal.

Organisasi yang memerlukan daftar host yang tidak diizinkan atau pembatasan screenshot harus memverifikasi apakah ekstensi internal atau yang disetujui dapat dimigrasikan ke API tingkat lebih tinggi seperti chrome.scripting atau chrome.declarativeNetRequest.

Berikan masukan

Untuk mengetahui detail selengkapnya, lihat dokumentasi API chrome.debugger. Jika ada pertanyaan atau masukan, hubungi kami di Grup Google Ekstensi Chromium.