TweetFollow Us on Twitter

MacEnterprise: Managing FireFox

Volume Number: 24
Issue Number: 12
Column Tag: MacEnterprise

MacEnterprise: Managing FireFox

Configuring FireFox for your organization's environment

By Greg Neagle, MacEnterprise.org

Introduction

Although Safari is an excellent web browser, many organizations need to support Firefox as well for a variety of reasons. One very good reason is that it is a modern browser that runs natively on Windows, Linux, and OS X. If your organization supports multiple platforms, it makes sense to standardize on cross-platform applications like Firefox and Thunderbird when possible.

If you are supporting Firefox as a browser in your organization, you may need to pre-configure it for users in your environment. You may need to set up proxies, define your organization's home page as the default browser home page, and turn off application updates, among other things.

Unfortunately, Firefox does not respond to the Mac OS X administrator's standard bag of tricks for managing it. Workgroup Manager/MCX is of no use here, as the important settings are not stored in the org.mozilla.firefox.plist file in the user's preferences. By default, Firefox pays no attention to the system proxy settings. Even such time-honored tricks as copying in pre-defined preference files can be difficult with Firefox as it stores the user profiles at different paths, generated on the first run of Firefox.

A New Bag of Tricks

To manage Firefox in an enterprise environment, you'll need to learn a new bag of tricks. There are two things to learn:

How Firefox defines its preferences.

Where to define your preferences so Firefox will use them for all users on a given machine.

Firefox Preferences

Firefox is a descendant of the Mozilla browser, which was in turn descended from Netscape. Many of the mechanisms carry over from those browsers, and if you are looking for documentation on the Internet, you might want to broaden your search to those browsers as well.

Firefox uses JavaScript files to define its preferences. There are three JavaScript functions defined by Mozilla/Firefox you might use:

  • pref() - sets the current value of a preference. Useful for preferences you'd like to reset to defaults for each session, but to allow users to change during a session.
  • lockPref() - sets the value of a preference, and locks it so users can't change it. Useful to enforce certain policies.
  • defaultPref() - sets the default value of a preference. If the user has already set a value for this preference, this will have no effect.

What preferences can be set? You can get an idea of the vast array of available preferences by opening a Firefox window, and typing about:config into the URL field. If you are running Firefox 3, you might see a warning:


Ignore the sensationalism and click the "I'll be careful" button. You'll see a long list of available preferences:


Some of these correspond to preferences you can access from the Preferences window in Firefox, and others are hidden preferences. The important thing here is that you can get the preference name, its status, type and value, which you'll need in order to manage the preference.

In theory you can manage any of the preferences you find in about:config, but for this article we'll look at a subset. We'll explore how to manage proxy settings, the default browser check, and application updates. We'll also look at changing the default home page, but that actually uses a different technique, which we'll save for later.

Proxy Settings

To get started with managing the proxy settings, first configure them manually, using the Preferences window in Firefox:


In this example, I'm using an automatic proxy configuration URL, sometimes referred to as a "PAC file". Click OK, and once again, visit about:config. To narrow down what is displayed, type "proxy" in the Filter field:


The values we've set will have a status of "user set", and display in bold:


You can use a similar process to determine the correct names and values for most of the preferences you'd like to manage.

Here are the rest of the preferences we're going to manage for this article:


These control application and extension updates, updating the list of available search providers, and the check to see of Firefox is the default browser at launch. Since we are managing Firefox, we don't want users to be notified of newer versions of the application or extensions, and we don't want the user constantly prompted to set Firefox as the default browser.

Editing the Firebox Bundle

To actually get Firefox to use your desired preferences for all users of a given machine, you'll need to edit some files inside the Firefox.app bundle. You'll need to do the editing as either root (via the command line, perhaps using sudo), or as the owner of the files in the Firefox bundle; typically the admin user that installed Firefox.

Take care when editing. If you use a GUI editor, make sure you save any new or changed files as plain text and that no extra extensions are appended to the end of the filename.

You will start by editing the file /Applications/Firefox.app/Contents/MacOS/greprefs/all.js.

Add the following to the end of this file:

 // MyOrganization additions
pref("general.config.obscure_value", 0);
pref("general.config.filename", "firefox_AA.cfg");

Feel free to change "MyOrganization" to the actual name of your organization. What we're doing here is telling Firefox to read the file named here for additional configuration info. The "general.config.obscure.value" tells Firefox the file will be in plain text; by default it expects the file to be obscured with ROT13 encoding, where 13 is added to the ASCII value of every character. The reasons for this are lost in the mists of antiquity.

Save the /Applications/Firefox.app/Contents/MacOS/greprefs/all.js file. Now create a new file at /Applications/Firefox.app/Contents/MacOS/firefox_AA.cfg with the following contents:

// This file sets some prefs for use at MyOrganization
// and locks down some other prefs.
// set proxy config
pref("network.proxy.autoconfig_url", "http://www.myorg.org/auto.proxy");
pref("network.proxy.type", 2);
// disable application updates
lockPref("app.update.enabled", false);
lockPref("app.update.autoUpdateEnabled", false);
lockPref("extensions.update.enabled", false);
lockPref("extensions.update.autoUpdate", false);
lockPref("browser.search.update", false);
// disable default browser check
pref("browser.shell.checkDefaultBrowser", false);

Again, make sure you save it as a plain text file with the name "firefox_AA.cfg" in the directory "/Applications/Firefox.app/Contents/MacOS/". Double-check your work via the command line:

> cd /Applications/Firefox.app/Contents/MacOS/
> ls -al firefox_AA.cfg 
-rw-rw-r—  1 admin  admin  636 Jul 23 13:22 firefox_AA.cfg
> cat firefox_AA.cfg

That last command (cat firefox_AA.cfg) should return the exact contents you entered when you created the file.

In this example, we used two different commands: pref(), and lockPref(). For the proxy, I wanted the user to be able to modify the proxy if needed, but have it return to our recommended settings on the next launch. For the application updates, I wanted to prevent the user from turning these back on. Your requirements may differ.

With everything saved and double-checked, try launching Firefox. You should find these settings exactly as you specified, and in the case of the update prefs, locked:


Note how the corresponding controls are grayed-out and unavailable.

Default Home Page

One important preference is a little harder to manage: the default home page. You might get a clue of why this is so by looking at the preferences in about:config:


You'll see that the browser.startup.homepage points to another file, instead of just being a normal URL. You can set it to a normal URL, and it usually works, but I've found it unreliable. So instead of setting a preference, we'll edit the contents of browserconfig.properties:

Open /Applications/Firefox.app/Contents/MacOS/browserconfig.properties, delete its entire contents, and replace them with:

browser.startup.homepage=http://homepage.myorg.org
browser.startup.homepage_reset=http://homepage.myorg.org

Of course you want to substitute your own URL for the home page.

Now quit and relaunch Firefox. Unless you've set a custom home page, you'll be taken to the home page you defined. Users have the ability to override this if they want. If you truly wanted to enforce a home page, adding

pref("browser.startup.homepage", "http://homepage.myorg.org");
pref("browser.startup.homepage_reset", "http://homepage.myorg.org");

to /Applications/Firefox.app/Contents/MacOS/firefox_AA.cfg should get the behavior you want, but your users may dislike you.

Now that you've modified the Firefox.app bundle, you'll need to push out these changes to all your machines. I hope you have a software distribution mechanism in your organization!

More Info

Congratulations! You've added a few new tricks to your toolbox. For more information on Mozilla/Firefox preferences and configuration, check out these URLs:

http://kb.mozillazine.org/Firefox_:_FAQs_:_About:config_Entries

http://preferential.mozdev.org/preferences.html

http://developer.mozilla.org/en/Automatic_Mozilla_Configurator/Locked_config_settings


Greg Neagle is a member of the steering committee of the Mac OS X Enterprise Project (macenterprise.org) and is a senior systems engineer at a large animation studio. Greg has been working with the Mac since 1984, and with OS X since its release. He can be reached at gregneagle@mac.com.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Path Finder 7.5 - Powerful, award-winnin...
Path Finder makes you a master of file management. Take full control over your file system. Save your time: compare and synchronize folders, view hidden files, use Dual Pane and full keyboard... Read more
Merlin Project 4.2.3 - $349.00
Merlin Project is the leading professional project management software for OS X. If you plan complex projects on your Mac, you won’t get far with a simple list of tasks. Good planning raises... Read more
TextSoap 8.4 - Automate tedious text doc...
TextSoap can automatically remove unwanted characters, fix up messed up carriage returns, and do pretty much anything else that we can think of to text. Save time and effort. Be more productive. Stop... Read more
Smultron 9.4 - Easy-to-use, powerful tex...
Smultron 9 is an elegant and powerful text editor that is easy to use. Use it to create or edit any text document. Everything from a web page, a note or a script to any single piece of text or code.... Read more
QuarkXPress 13.0.0.0 - Desktop publishin...
QuarkXPress 2017 is the new version that raises the bar for design and productivity. With non-destructive graphics and image editing directly within your layout, you no longer have to choose between... Read more
Brackets 1.9.0 - Open Source Web design...
Brackets is an Open-Source editor for Web design and development built on top of Web technologies such as HTML, CSS, and JavaScript. The project was created and is maintained by Adobe, and is... Read more
Audio Hijack 3.3.4 - Record and enhance...
Audio Hijack (was Audio Hijack Pro) drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio... Read more
Tunnelblick 3.7.1a - GUI for OpenVPN.
Tunnelblick is a free, open source graphic user interface for OpenVPN on OS X. It provides easy control of OpenVPN client and/or server connections. It comes as a ready-to-use application with all... Read more
Amazon Chime 4.3.5721 - Amazon-based com...
Amazon Chime is a communications service that transforms online meetings with a secure, easy-to-use application that you can trust. Amazon Chime works seamlessly across your devices so that you can... Read more
BBEdit 11.6.6 - Powerful text and HTML e...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more

Latest Forum Discussions

See All

Magikarp Jump splashes onto Android worl...
If you're tired ofPokémon GObut still want something to satisfy your mobilePokémon fix,Magikarp Jumpmay just do the trick. It's out now on Android devices the world over. While it looks like a simple arcade jumper, there's quite a bit more to it... | Read more »
Purrfectly charming open-world RPG Cat Q...
Cat Quest, an expansive open-world RPG from former Koei-Tecmo developers, got a new gameplay trailer today. The video showcases the combat and exploration features of this feline-themed RPG. Cat puns abound as you travel across a large map in a... | Read more »
Jaipur: A Card Game of Duels (Games)
Jaipur: A Card Game of Duels 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: ** WARNING: iPad 2, iPad Mini 1 & iPhone 4S are NOT compatible. ** *** Special Launch Price for a limited... | Read more »
Subdivision Infinity (Games)
Subdivision Infinity 1.03 Device: iOS Universal Category: Games Price: $2.99, Version: 1.03 (iTunes) Description: Launch sale! 40% Off! Subdivision Infinity is an immersive and pulse pounding sci-fi 3D space shooter. https://www.... | Read more »
Clash of Clans' gets a huge new upd...
Clash of Clans just got a massive new update, and that's not hyperbole. The update easily tacks on a whole new game's worth of content to the hit base building game. In the update, that mysterious boat on the edge of the map has been repaired and... | Read more »
Thimbleweed Park officially headed to iO...
Welp, it's official. Thimbleweed Park will be getting a mobile version. After lots of wondering and speculation, the developers confirmed it today. Thimbleweed Park will be available on both iOS and Android sometime in the near future. There's no... | Read more »
Pokémon GO might be getting legendaries...
The long-awaited legendary Pokémon may soon be coming to Pokémon GO at long last. Data miners have already discovered that the legendary birds, Articuno, Moltres, and Zapdos are already in the game, it’s just a matter of time. [Read more] | Read more »
The best deals on the App Store this wee...
If you’ve got the Monday blues we have just the thing to cheer you up. The week is shaping up to be a spectacular one for sales. We’ve got a bunch of well-loved indie games at discounted prices this week along with a few that are a little more... | Read more »
Honor 8 Pro, a great choice for gamers
Honor is making strides to bring its brand to the forefront of mobile gaming with its latest phone, the Honor 8 Pro. The Pro sets itself apart from its predecessor, the Honor 8, with a host of premium updates that boost the device’s graphical and... | Read more »
The 4 best outdoor adventure apps
Now that we're well into the pleasant, warmer months, it's time to start making the most of the great outdoors. Spring and summer are ideal times for a bit of trekking or exploration. You don't have to go it alone, though. There are plenty of... | Read more »

Price Scanner via MacPrices.net

Sale! 15-inch 2.6GHz Silver Touch Bar MacBook...
DataVision has the 15″ 2.6GHz Silver Touch Bar MacBook Pro (MLW72LL/A) on sale for $2199 including free shipping. Their price is $200 off MSRP, and it’s the lowest price available for this model (... Read more
A Kaby Lake Processor Upgrade For The MacBook...
Now they tell me! Well, actually Apple hasn’t said anything official on the subject, but last week Bloomberg News’s Mark Gurman and Alex Webb cited unnamed “people familiar with the matter”... Read more
Kodak’s Camera-First Smartphone EKTRA Launche...
The Eastman Kodak Company and Bullitt Group have announced the availability of a U.S. GSM version of the KODAK EKTRA Smartphone. The U.S. launch coincides with a software update addressing requests... Read more
Apple Launches App Development Curriculum for...
Apple today launched a new app development curriculum designed for students who want to pursue careers in the fast-growing app economy. The curriculum is available as a free download today from Apple... Read more
Check Apple prices on any device with the iTr...
MacPrices is proud to offer readers a free iOS app (iPhones, iPads, & iPod touch) and Android app (Google Play and Amazon App Store) called iTracx, which allows you to glance at today’s lowest... Read more
9.7-inch 2017 iPad available for $298, save $...
Sams Club has 32GB 9.7″ Apple iPads available for $298 for Sams Club members. That’s $21 off MSRP. Order online and choose free local store pickup (if available) or free shipping. Read more
touchbyte Releases PhotoSync 3.2 for iOS With...
Hamburg, Germany based touchbyte has announced the release of PhotoSync 3.2 for iOS, a major upgrade to the versatile and powerful app to transfer, backup and share photos and videos over the air.... Read more
Emerson Adds Touchscreen Display and Apple Ho...
Emerson has announced the next evolution of its nationally recognized smart thermostat. The new Sensi Touch Wi-Fi Thermostat combines proven smarthome technology with a color touchscreen display and... Read more
SurfPro VPN for Mac Protects Data While Offer...
XwaveSoft has announced announce the release and immediate availability of SurfPro VPN 1.0, their secure VPN client for macOS. SurfPro VPN allows Mac users to protect their internet traffic from... Read more
13-inch Touch Bar MacBook Pros on sale for $1...
B&H Photo has 13″ MacBook Pros in stock today for up to $150 off MSRP. Shipping is free, and B&H charges NY & NJ sales tax only: - 13″ 2.9GHz/512GB Touch Bar MacBook Pro Space Gray (... Read more

Jobs Board

*Apple* Store Leader Program - Apple, Inc (U...
…Summary Learn and grow as you explore the art of leadership at the Apple Store. You'll master our retail business inside and out through training, hands-on Read more
*Apple* Integration Specialist - A3 Solution...
Apple Integration Specialist Contract-To-HireWe are searching for dedicated, well-experienced and energetic individuals for an information technology corporation Read more
Sr. Software Engineer, *Apple* Online Store...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more Read more
Senior Engineering Project Manager, *Apple*...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more Read more
*Apple* Mobile Master - Best Buy (United Sta...
**508456BR** **Job Title:** Apple Mobile Master **Location Number:** 000040-Eau Claire-Store **Job Description:** **What does a Best Buy Apple Mobile Master Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.