Menyesuaikan Firefox menggunakan AutoConfig

Berkas AutoConfig dapat digunakan untuk mengatur dan mengunci preferensi yang tidak tercakup oleh kebijakan grup di Windows atau policies.json untuk Mac dan Linux. Metode ini dapat digunakan untuk mengubah preferensi pengguna secara otomatis atau mencegah pengguna akhir mengubah preferensi tertentu dengan menguncinya.

Menyiapkan AutoConfig

Untuk menggunakan AutoConfig, Anda perlu membuat dua berkas, satu di tingkat atas, dan satu di subdirektori. Di Windows, path didasarkan pada direktori tempat Firefox diinstal. Di macOS, path didasarkan pada direktori Contents/Resources dari Firefox.app.

Berkas pertama yang dibuat bernama autoconfig.js, dan harus ditempatkan di direktori defaults/pref. Berkas ini harus berisi dua baris berikut:

pref("general.config.filename", "firefox.cfg");
pref("general.config.obscure_value", 0);

Baris pertama menentukan nama berkas AutoConfig. Nama berkas dapat disesuaikan, tetapi lokasi berkas tidak dapat diubah.

Baris kedua menunjukkan bahwa AutoConfig tidak boleh diobfuskasi. Secara default, Firefox mengharapkan berkas tersebut digeser bita sebanyak 13 bita untuk mengobfuskasinya.

Berkas kedua yang dibuat bernama firefox.cfg dan ditempatkan di tingkat atas direktori Firefox. Berkas ini harus selalu dimulai dengan baris komentar, seperti:

// PENTING: Mulai kode Anda pada baris ke-2

Meskipun ekstensi berkas AutoConfig biasanya adalah .cfg, berkas AutoConfig adalah berkas JavaScript. Hal ini memungkinkan JavaScript tambahan ditulis di dalam berkas untuk menambahkan logika yang berbeda dalam situasi yang berbeda.

Fungsi AutoConfig

Fungsi-fungsi berikut tersedia di dalam berkas AutoConfig:

pref(prefName, value) – mengatur nilai pengguna dari sebuah preferensi. Fungsi ini secara eksplisit mengatur preferensi sebagai preferensi pengguna. Artinya, jika pengguna telah mengubah nilainya, nilai tersebut akan diatur ulang setiap kali peramban dimulai.

defaultPref(prefName, value) – mengatur nilai default dari sebuah preferensi. Ini adalah nilai yang dimiliki preferensi ketika pengguna belum menetapkan nilai apa pun atau pengguna mengatur ulang preferensi. Nilai ini dapat diubah secara permanen oleh pengguna.

lockPref(prefName, value) – mengatur nilai default dari sebuah preferensi dan menguncinya. Ini adalah fungsi yang paling umum digunakan. Mengunci preferensi mencegah pengguna mengubahnya, dan dalam banyak kasus, menonaktifkan UI di preferensi sehingga jelas bagi pengguna bahwa preferensi tersebut telah dinonaktifkan.

unlockPref(prefName) – membuka kunci preferensi. Sebagai contoh, ini akan digunakan dalam kasus di mana preferensi harus dikunci untuk semua pengguna, tetapi tidak dikunci untuk pengguna tertentu.

getPref(prefName) – mengambil nilai dari sebuah preferensi. Jika preferensi tidak ada, fungsi ini akan menampilkan kesalahan. Fungsi ini hanya boleh digunakan pada preferensi yang selalu ada.

clearPref(prefName) – menghapus nilai pengguna dari sebuah preferensi, mengaturnya kembali ke nilai default.

displayError(funcname, message) – menampilkan kesalahan dalam format tertentu, yang merupakan alat yang berguna untuk melakukan debug.

   Netscape.cfg/AutoConfig gagal. Silakan hubungi administrator sistem Anda.
   Kesalahan: [funcname] gagal: [message]

getenv(name) – menanyakan variabel lingkungan. Ini dapat memungkinkan akses ke hal-hal seperti nama pengguna dan informasi sistem lainnya.

Menonaktifkan Elemen UI

Dalam kasus di mana elemen UI tidak dinonaktifkan secara otomatis di preferensi, ada beberapa preferensi “disable_button” yang, ketika dikunci, akan menonaktifkan tombol. Misalnya, dengan menyertakan

lockPref("pref.privacy.disable_button.view_passwords",true);

di dalam berkas AutoConfig Anda akan menonaktifkan tombol View Passwords. Preferensi lain yang mengunci tombol meliputi:

• pref.general.disable_button.default_browser
• pref.browser.homepage.disable_button.current_page
• pref.browser.homepage.disable_button.bookmark_page
• pref.browser.homepage.disable_button.restore_default
• security.disable_button.openCertManager
• security.disable_button.openDeviceManager
• app.update.disable_button.showUpdateHistory
• pref.privacy.disable_button.cookie_exceptions
• pref.privacy.disable_button.view_cookies
• pref.privacy.disable_button.view_passwords
• pref.privacy.disable_button.view_passwords_exceptions
• pref.downloads.disable_button.edit_actions

Manajemen Terpusat

Berkas AutoConfig dapat dikelola secara terpusat. Untuk melakukannya, tentukan lokasi berkas AutoConfig sekunder di dalam berkas AutoConfig utama:

pref("autoadmin.global_config_url","https://yourdomain.com/autoconfigfile.js");

URL dapat berupa protokol apa pun yang didukung oleh Firefox, termasuk protokol file: untuk menunjuk ke berkas di drive jaringan. Format berkas AutoConfig jarak jauh sama dengan berkas AutoConfig di klien, kecuali bahwa baris pertama tidak diabaikan.

Ada preferensi lain yang mengontrol aspek AutoConfig. Preferensi autoadmin.refresh_interval menyebabkan AutoConfig diperbarui pada interval tertentu yang ditentukan dalam menit. Ada juga preferensi yang terkait dengan bagaimana mode luring ditangani, termasuk autoadmin.offline_failover dan autoadmin.failover_to_cached.

Setiap kali berkas AutoConfig diambil dari jarak jauh, salinan cadangan dari berkas tersebut dibuat di direktori profil pengguna yang disebut failover.jsc. Jika preferensi autoadmin.failover_to_cached diatur ke false, Firefox akan membaca berkas yang di-cache, menandai peramban sebagai luring dan mengunci preferensi, sehingga pengguna tidak dapat daring. Jika preferensi diatur ke true, Firefox hanya menggunakan berkas yang di-cache dan melanjutkan. Preferensi autoadmin.offline_failover mengontrol apakah berkas yang di-cache digunakan atau tidak saat pengguna luring. Jika diatur ke true, berkas yang di-cache akan digunakan.

Preferensi Spesifik Pengguna

Jika informasi spesifik pengguna perlu disertakan dalam berkas AutoConfig, preferensi berikut harus diatur:

pref("autoadmin.append_emailaddr", true);

Ini akan menambahkan tanda tanya (?) dan alamat email ke permintaan.

Karena Firefox tidak menggunakan alamat email, preferensi mail.identity.useremail harus diatur. Jika tidak diatur, Firefox akan menampilkan prompt yang meminta alamat email. Karena berkas AutoConfig adalah berkas JavaScript, preferensi ini dapat diatur sebelum mengatur autoadmin.global_config_url. Sebagai contoh:

var user = getenv("USER");
lockPref("mail.identity.useremail", user);
lockPref("autoadmin.global_config_url","https://yourdomain.com/autoconfigfile.js");