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.

 
AAPL
$100.91
Apple Inc.
+0.38
MSFT
$44.97
Microsoft Corpora
-0.36
GOOG
$584.63
Google Inc.
-2.23

MacTech Search:
Community Search:

Software Updates via MacUpdate

Tidy Up 3.0.15.0 - Find duplicate files...
Tidy Up is a complete duplicate finder and disk-tidiness utility. With Tidy Up you can search for duplicate files and packages by the owner application, content, type, creator, extension, time... Read more
Parallels Desktop 10.0 - Run Windows app...
Parallels Desktop is simply the world's bestselling, top-rated, and most trusted solution for running Windows applications on your Mac. With Parallels Desktop for Mac, you can seamlessly run both... Read more
Apple Final Cut Pro X 10.1.3 - Professio...
Apple Final Cut Pro X is a professional video editing solution.Completely redesigned from the ground up, Final Cut Pro adds extraordinary speed, quality, and flexibility to every part of the post-... Read more
Apple Compressor 4.1.3 - Adds power and...
Compressor adds power and flexibility to Final Cut Pro X export. Customize output settings, work faster with distributed encoding, and tap into a comprehensive set of delivery features. Powerful... Read more
Chromium 36.0.1985.143 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. FreeSMUG-Free OpenSource Mac User Group build is... Read more
Macgo Blu-ray Player 2.10.6.1691 - Blu-r...
Macgo Mac Blu-ray Player can bring you the most unforgettable Blu-ray experience on your Mac. Overview Macgo Mac Blu-ray Player can satisfy just about every need you could possibly have in a Blu-ray... Read more
Apple Motion 5.1.2 - Create and customiz...
Apple Motion is designed for video editors, Motion 5 lets you customize Final Cut Pro titles, transitions, and effects. Or create your own dazzling animations in 2D or 3D space, with real-time... Read more
A Better Finder Rename 9.39 - File, phot...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more
PopChar X 6.6 - Floating window shows av...
PopChar X helps you get the most out of your font collection. With its crystal-clear interface, PopChar X provides a frustration-free way to access any font's special characters. Expanded... Read more
MacUpdate Desktop 6.0.2 - Install Mac ap...
MacUpdate Desktop 6 brings seamless 1-click installs and version updates to your Mac. With a free MacUpdate account and MacUpdate Desktop 6, Mac users can now install almost any Mac app on macupdate.... Read more

Latest Forum Discussions

See All

Space Colors – Tips, Tricks, Strategies,...
Hello Cadets: Want to know what we thought about this hectic space combat/roguelike? Check out our Space Colors review! Space Colors is a cool shooter/roguelike from Team Chaos. You travel from planet to planet across a huge galaxy and complete a... | Read more »
Tap Sports Baseball – Tips, Tricks, and...
Tap Sports Baseball is a pretty simple game to learn, but that doesn’t mean it’s an easy game to master, by any means. To start your batting career off well, we thought we’d give you the heads up on some handy tips and tricks. Hey Batter-Batter:... | Read more »
Tap Sports Baseball Review
Tap Sports Baseball Review By Jennifer Allen on August 20th, 2014 Our Rating: :: LET'S PLAY BALLUniversal App - Designed for iPhone and iPad Tap Sports Baseball is briefly fun but lacks some important features.   | Read more »
Frontier Heroes Review
Frontier Heroes Review By Andrew Fisher on August 20th, 2014 Our Rating: :: BLAZES NO TRAILSUniversal App - Designed for iPhone and iPad Despite awesome visuals and great music, Frontier Heroes just doesn’t quite deliver enough fun... | Read more »
Echo Prime is Now on Sale for $0.99
Echo Prime is Now on Sale for $0.99 Posted by Jessica Fisher on August 20th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Star Realms Review
Star Realms Review By Andrew Fisher on August 20th, 2014 Our Rating: :: A STAR IS BORNUniversal App - Designed for iPhone and iPad Star Realms is an excellent adaptation of an outstanding deck-builder. With great visuals and an... | Read more »
This. Is. SPRINGFIELD! War comes to The...
This. Is. SPRINGFIELD! | Read more »
One Tap RPG Review
One Tap RPG Review By Campbell Bird on August 20th, 2014 Our Rating: :: DUNGEON SLIDERUniversal App - Designed for iPhone and iPad This casual arcade game introduces some very light rpg elements into its fantasy-themed pachinko... | Read more »
Goodbye Paywall – Table Tennis Touch Eli...
Goodbye Paywall – Table Tennis Touch Eliminates In-App Purchases Posted by Jessica Fisher on August 20th, 2014 [ permalink ] | Read more »
Go to Bed – An Interview With Touchfight...
Touchfight Games is an exciting new indie studio that was co-formed between game journalist and author Nathan Meunier, artist Leonard Kenyon, and programmer Jon Kenyon. Their debut game Go To Bed will be released this fall, and with all the... | Read more »

Price Scanner via MacPrices.net

Apple now offering certified refurbished 2014...
 The Apple Store is now offering Apple Certified Refurbished 2014 MacBook Airs for up to $180 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is... Read more
Best Buy’s College Student Deals: $100 off Ma...
Take an additional $100 off all MacBooks and iMacs, $50 off iPad Airs and iPad minis, at Best Buy Online with their College Students Deals Savings, valid through September 6th. Anyone with a valid .... Read more
MacBook Airs on sale for $100 off MSRP, free...
B&H Photo has three 2014 MacBook Airs on sale for $100 off MSRP. Shipping is free, and B&H charges NY sales tax only. They also include free copies of Parallels Desktop and LoJack for Laptops... Read more
Razer Taipan Mouse For Gamers And Non-Gamers...
If you’re a serious gamer on either Mac or Windows PCs, a serious gaming mouse is a necessity for first-tier performance. However, even if like me you’re not much of a gamer, there’s still a strong... Read more
15-inch 2.2GHz MacBook Pro on sale for $1899,...
Adorama has the new 15″ 2.2GHz Retina MacBook Pro on sale for $1899 including free shipping plus NY & NJ sales tax only. Their price is $100 off MSRP, and it’s the lowest price available for this... Read more
Mid-Size Tablet Shootout Posted: iPad mini wi...
I ‘m curious about how many iPads Apple is actually selling these days. It’s been widely rumored and anticipated that new models with A8 SoCs, 2 GB of RAM, 8 megapixel cameras, and fingerprint... Read more
The 15 Biggest iPad Air Problems And How To A...
What’s this? Fifteen “biggest” problems with the iPad Air? Does that mean there are a lot of smaller problems as well? Say it isn’t so! My old iPad 2 has manifested no hardware problems in three... Read more
TYLT Syncable-Duo, 2-in-1 USB Cable With Appl...
TYLT has introduced the Syncable-Duo, a universal cable solution for charging and syncing data to smartphones and tablets. The Syncable-Duo eliminates the need for multiple cables by incorporating... Read more
Save up to $140 off MSRP with Apple refurbish...
Apple is offering Certified Refurbished iPad Airs for up to $140 off MSRP. Apple’s one-year warranty is included with each model, and shipping is free. Stock tends to come and go with some of these... Read more
2.5GHz Mac mini on sale for $549, save $50
B&H Photo has the 2.5GHz Mac mini on sale for $549.99 including free shipping. That’s $50 off MSRP, and B&H will also include a free copy of Parallels Desktop software. NY sales tax only. Read more

Jobs Board

Senior Event Manager, *Apple* Retail Market...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global event strategy. Delivering an overarching brand story; in-store, Read more
*Apple* Solutions Consultant - Apple (United...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Position Opening at *Apple* - Apple (United...
**Job Summary** Being a Business Manager at an Apple Store means you're the catalyst for businesses to discover and leverage the power, ease, and flexibility of Apple Read more
Position Opening at *Apple* - Apple (United...
**Job Summary** At the Apple Store, you connect business professionals and entrepreneurs with the tools they need in order to put Apple solutions to work in their Read more
Project Manager / Business Analyst, WW *Appl...
…a senior project manager / business analyst to work within our Worldwide Apple Fulfillment Operations and the Business Process Re-engineering team. This role will work Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.