比较修订

Comment utiliser les fichiers AutoConfig pour paramétrer et verrouiller les préférences qui ne sont pas garanties par les stratégies de Firefox.

Les fichiers AutoConfig peuvent être utilisés pour paramétrer et verrouiller les préférences qui ne sont pas prises en charge par la [[Customize Firefox using Group Policy (Windows)|stratégie de groupe sous Windows]] ou le [[Customize Firefox using policies.json|fichier policies.json pour macOS et Linux]]. Cette méthode peut être employée pour modifier automatiquement les préférences des utilisateurs et utilisatrices, ou les empêcher de modifier des préférences particulières en les verrouillant. __TOC__ =Configurer AutoConfig= Pour utiliser AutoConfig, vous avez besoin de créer deux fichiers, un au niveau le plus haut, l’autre dans un sous-répertoire. Sous Windows, les chemins commencent au répertoire d’installation de Firefox. Sous macOS, ils commencent au répertoire <code>Contents/Resources</code> de Firefox.app. {note}Le fichier autoconfig.js doit utiliser la fin de ligne Unix (LF), même pour les systèmes Windows disposant des [[Find what version of Firefox you are using|versions de Firefox]] 60 ou ultérieures.{/note} Le premier fichier que vous avez besoin de créer se nomme '''autoconfig.js''' et se place dans le répertoire {filepath defaults/pref}. Il devrait contenir les deux lignes suivantes : pref("general.config.filename", "firefox.cfg"); pref("general.config.obscure_value", 0); La première ligne indique le nom du fichier AutoConfig. Le nom de ce fichier peut être personnalisé, mais son emplacement ne peut être modifié. La seconde ligne indique que le fichier AutoConfig ne doit pas être obscurci. Par défaut, Firefox attend un décalage de 13 octets dans ce fichier dans le but de le brouiller. Le second fichier à créer est nommé '''firefox.cfg''' et est placé au niveau supérieur du répertoire de Firefox. Il doit toujours commencer par une ligne de commentaire, telle que : // IMPORTANT : commencez votre code sur la 2e ligne Bien que l’extension d’un fichier AutoConfig soit typiquement <code>.cfg</code>, le fichier AutoConfig lui-même est un fichier JavaScript. Cela permet d’y écrire du code JavaScript supplémentaire pour obtenir des logiques différentes selon les situations. =Fonctions d’AutoConfig= Les fonctions suivantes sont disponibles dans un fichier AutoConfig : '''pref(prefName, value)''' – positionne la valeur utilisateur d’une préférence. Cette fonction positionne explicitement la préférence comme une préférence utilisateur. Cela signifie que si l’utilisateur ou l’utilisatrice change cette valeur, elle sera réinitialisée chaque fois que le navigateur est lancé. '''defaultPref(prefName, value)''' – positionne la valeur par défaut d’une préférence. Il s’agit de la valeur prise par une préférence tant que l’utilisateur ou l’utilisatrice ne lui en a pas spécifié une ou n’a pas réinitialisé la préférence. Elle peut être changée en permanence par cette personne. '''lockPref(prefName, value)''' – positionne la valeur par défaut d’une préférence et la verrouille. C’est la fonction la plus couramment employée. Verrouiller une préférence empêche l’utilisateur ou l’utilisatrice de la modifier, et, dans la plupart des cas, désactive l’interface utilisateur dans les paramètres de façon évidente pour l’utilisateur ou l’utilisatrice. '''unlockPref(prefName)''' – déverrouille une préférence. Pour exemple, cette fonction pourrait servir dans le cas où une préférence devrait être verrouillée pour l’ensemble des utilisateurs et utilisatrices, mais déverrouillée pour des personnes précises. '''getPref(prefName)''' – retourne la valeur d’une préférence. Si la préférence n’existe pas, elle affiche une erreur. Cette fonction ne devrait être utilisée que pour des préférences dont vous connaissez l’existence. '''clearPref(prefName)''' – supprime la valeur utilisateur d’une préférence, la réinitialisant à sa valeur par défaut. '''displayError(funcname, message)''' – affiche une erreur dans un format spécifique, ce qui en fait un outil pratique de débogage. Échec lors de la lecture du fichier de configuration. Veuillez contacter votre administrateur système. Erreur : [funcname] échoué : [message]<!-- chaînes de l’UI de fx --> '''getenv(name)''' – interroge les variables de l’environnement. Cette fonction peut permettre l’accès à des éléments comme les noms d’utilisateur ou d’utilisatrice et d’autres informations sur le système. ==Désactiver des éléments de l’interface== Au cas où des éléments de l’interface ne sont pas automatiquement désactivés dans les préférences, il existe des préférences « disable_button » qui, quand elles sont verrouillées, désactivent des boutons. Par exemple, si vous ajoutez la ligne suivante : lockPref("pref.privacy.disable_button.view_passwords",true); dans votre fichier AutoConfig, le bouton {button Afficher les mots de passe} est désactivé. Voici les autres préférences qui verrouillent des boutons : *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 =Gestion centralisée= Le fichier AutoConfig peut être géré de façon centralisée. À cette fin, spécifiez l’emplacement d’un fichier AutoConfig secondaire dans le fichier AutoConfig primaire : pref("autoadmin.global_config_url","https://yourdomain<!-- -->.com/autoconfigfile.js"); Son URL peut utiliser n’importe quel protocole pris en charge par Firefox, y compris le protocole <code>file:</code> pour pointer vers un fichier situé sur un disque réseau. Le format du fichier AutoConfig distant est le même que celui du fichier AutoConfig sur le client, à l’exception de sa première ligne qui n’est pas ignorée. Il y a quelques autres préférences qui contrôlent des particularités d’AutoConfig. La préférence {pref autoadmin.refresh_interval} provoque le rafraîchissement d’AutoConfig selon un intervalle donné spécifié en minutes. Il existe aussi quelques préférences relatives à la manière dont le mode hors connexion est géré, comprenant {pref autoadmin.offline_failover} et {pref autoadmin.failover_to_cached} À chaque fois qu’un fichier AutoConfig est récupéré à distance, une copie de sauvegarde de ce fichier, nommée {pref failover.jsc}, est créée dans le dossier de profil de l’utilisateur ou de l’utilisatrice. Si la préférence {pref autoadmin.failover_to_cached} est positionnée sur {pref false}, Firefox lit le fichier mis en cache, marque le navigateur comme hors connexion et verrouille la préférence pour que l’utilisateur ou l’utilisatrice ne puisse se connecter. Si la préférence est positionnée sur {pref true}, il utilise simplement le fichier en cache, puis poursuit. La préférence {pref autoadmin.offline_failover} contrôle si, oui ou non, le fichier mis en cache est utilisé quand l’utilisateur ou l’utilisatrice est juste hors connexion. Si elle est positionnée sur {pref true}, le fichier en cache est utilisé. =Paramètres spécifiques aux utilisateurs et utilisatrices= Si vous désirez obtenir des informations spécifiques aux utilisateurs et utilisatrices dans votre configuration, vous pouvez positionner une autre préférence : pref("autoadmin.append_emailaddr", true); Cela ajoute un point d’interrogation (?) et une adresse e-mail à la demande. Parce que Firefox n’utilise pas d’adresse e-mail, la préférence {pref mail.identity.useremail} doit être paramétrée. Si ce n’est pas le cas, Firefox affiche une invite demandant l’adresse e-mail. Comme le fichier AutoConfig est un fichier JavaScript, cette préférence peut être affectée avant de positionner {pref autoadmin.global_config_url}. Par exemple : var user = getenv("USER"); lockPref("mail.identity.useremail", user); lockPref("autoadmin.global_config_url","https://yourdomain<!-- -->.com/autoconfigfile.js");