Actualizado por última vez:
2 semanas, 3 días ago
Los archivos AutoConfig se pueden usar para establecer y bloquear preferencias que no están cubiertas por la política de grupo en Windows o por el archivo policies.json para Mac y Linux. Este método se puede usar para cambiar automáticamente las preferencias del usuario o para evitar que el usuario final modifique preferencias específicas bloqueándolas.
Tabla de contenidos
Configuración de AutoConfig
Para usar AutoConfig, necesitas crear dos archivos, uno en el nivel superior y otro en un subdirectorio. En Windows, las rutas se basan en el directorio donde está instalado Firefox. En macOS, las rutas se basan en el directorio Contents/Resources de Firefox.app.
El primer archivo que se debe crear se llama autoconfig.js y debe colocarse en el directorio defaults/pref. Debe contener las siguientes dos líneas:
pref("general.config.filename", "firefox.cfg");
pref("general.config.obscure_value", 0);
La primera línea especifica el nombre del archivo AutoConfig. El nombre del archivo se puede personalizar, pero la ubicación del archivo no se puede cambiar.
La segunda línea indica que el AutoConfig no debe ser ofuscado. De forma predeterminada, Firefox espera que el archivo se desplace 13 bytes para ofuscarlo.
El segundo archivo que se debe crear se llama firefox.cfg y se coloca en el nivel superior del directorio de Firefox. Siempre debe comenzar con una línea comentada, como:
// IMPORTANT: Start your code on the 2nd line
Aunque la extensión de un archivo AutoConfig suele ser .cfg, el archivo AutoConfig es un archivo JavaScript. Esto permite escribir JavaScript adicional dentro del archivo para agregar una lógica diferente en distintas situaciones.
Funciones de AutoConfig
Las siguientes funciones están disponibles dentro de un archivo de configuración automática:
pref(prefName, value) – establece el valor de usuario de una preferencia. Esta función establece explícitamente la preferencia como una preferencia del usuario. Eso significa que si el usuario ha cambiado el valor, se restablecerá cada vez que se inicie el navegador.
defaultPref(prefName, value) – establece el valor predeterminado de una preferencia. Este es el valor que tiene una preferencia cuando el usuario no ha establecido ningún valor o cuando el usuario restablece la preferencia. El usuario puede cambiarlo permanentemente.
lockPref(prefName, value) – establece el valor predeterminado de una preferencia y la bloquea. Esta es la función más utilizada. Bloquear una preferencia impide que un usuario la cambie y, en la mayoría de los casos, deshabilita la interfaz de usuario en las preferencias, por lo que es obvio para el usuario que la preferencia ha sido deshabilitada.
unlockPref(prefName) – desbloquea una preferencia. Como ejemplo, esto se usaría en el caso de que una preferencia deba bloquearse para todos los usuarios, pero desbloquearse para usuarios particulares.
getPref(prefName) – recupera el valor de una preferencia. Si la preferencia no existe, muestra un error. Esta función solo debe usarse en preferencias que siempre existen.
clearPref(prefName) – elimina el valor de usuario de una preferencia, restableciéndola a su valor predeterminado.
displayError(funcname, message) – muestra un error en un formato específico, lo cual es una herramienta útil para la depuración.
Netscape.cfg/AutoConfig failed. Please contact your system administrator. Error: [funcname] failed: [message]
getenv(name) – consulta variables de entorno. Esto puede permitir el acceso a elementos como nombres de usuario y otra información del sistema.
Deshabilitar elementos de la interfaz de usuario
En los casos en que los elementos de la interfaz de usuario no se deshabilitan automáticamente en las preferencias, existen algunas preferencias de "disable_button" que, cuando se bloquean, deshabilitan los botones. Por ejemplo, si se incluye
lockPref("pref.privacy.disable_button.view_passwords",true);
en tu archivo AutoConfig, se deshabilitará el botón . Otras preferencias que bloquean botones incluyen:
- 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
Gestión centralizada
El archivo AutoConfig se puede gestionar de forma centralizada. Para ello, se especifica la ubicación de un archivo AutoConfig secundario en el archivo AutoConfig principal:
pref("autoadmin.global_config_url","https://yourdomain.com/autoconfigfile.js");
La URL puede ser cualquier protocolo compatible con Firefox, incluido el protocolo file: para apuntar a un archivo en una unidad de red. El formato del archivo AutoConfig remoto es el mismo que el del archivo AutoConfig en el cliente, excepto que la primera línea no se ignora.
Hay otras preferencias que controlan aspectos de AutoConfig. La preferencia autoadmin.refresh_interval hace que el AutoConfig se actualice en un intervalo dado especificado en minutos. También hay preferencias relacionadas con cómo se maneja el modo sin conexión, incluidas autoadmin.offline_failover y autoadmin.failover_to_cached.
Cada vez que se recupera un archivo AutoConfig de forma remota, se crea una copia de seguridad de ese archivo en el directorio de perfil del usuario llamada failover.jsc. Si la preferencia autoadmin.failover_to_cached se establece en false, Firefox lee el archivo en caché, marca el navegador como sin conexión y bloquea la preferencia, por lo que el usuario no puede conectarse. Si la preferencia se establece en true, simplemente usa el archivo en caché y continúa. La preferencia autoadmin.offline_failover controla si el archivo en caché se usa o no cuando el usuario está sin conexión. Si se establece en true, se utiliza el archivo en caché.
Preferencias específicas del usuario
Si se necesita incluir información específica del usuario en el archivo AutoConfig, se debe establecer la siguiente preferencia:
pref("autoadmin.append_emailaddr", true);
Esto agregará un signo de interrogación (?) Y una dirección de correo electrónico a la solicitud.
Como Firefox no usa direcciones de correo electrónico, se debe establecer la preferencia mail.identity.useremail. Si no se establece, Firefox mostrará un aviso solicitando la dirección de correo electrónico. Como el archivo AutoConfig es un archivo JavaScript, esta preferencia se puede establecer antes de configurar autoadmin.global_config_url. Por ejemplo:
var user = getenv("USER");
lockPref("mail.identity.useremail", user);
lockPref("autoadmin.global_config_url","https://yourdomain.com/autoconfigfile.js");
