Confluence Docs 3.0 : Installing the Firefox Add-On for the Office Connector This page last changed on Mar 29, 2009 by rhartono. If you are using Firefox as your browser, you will need to install an add-on into Firefox in order to use some features of the Office Connector. You will be prompted to install the add-on the first time you try to use a function which requires it. For an overview of all Office Connector features, please refer to Working with the Office Connector. On this page: Installing the Firefox Add-On Configuring the Add-On Configuring the Add-On in Windows Configuring the Add-On in Mac OS X Configuring the Add-On in Linux Security Risks ## Installing the Firefox Add-On You will be prompted to install the add-on the first time you try to use a function which requires it. The add-on is required for editing a wiki page in Office, or for editing an Office document which is displayed on a wiki page. When you choose an option which requires the Firefox add-on, you will see a popup window like this one: Click 'OK'. Some browsers may now ask you to confirm the download with a message bar across the top of the page, beneath the browser's address bar. You may see a message like the yellow bar shown here: Click 'Allow'. Or you may see a similar message with an 'Edit Options' button like this: If you see the above message, click 'Edit Options'. You will then see an 'Allowed Sites' window like this one: This window lets you tell Firefox that your Confluence server is allowed to install add-ons into Firefox. The 'Address of web site' box should already contain the address of your Confluence server. Click the 'Allow' button to add your Confluence server to the list. Go back to your Confluence page and try to edit your Office document again, e.g. by clicking 'Edit in Word' again. Now you will see the option to install the add-on. A 'Software Installation' window will appear, asking you to confirm the installation. The window will look something like the one below, but the URL will be the address of your own Confluence server: Click 'Install Now'. The installation will happen and a window will pop up asking you to restart Firefox: Make sure you have saved all your Confluence pages and any other work in your browser, then restart Firefox. If Firefox asks you to confirm the restart, confirm it. Firefox will close all the browser windows and will then start up again. You will see a window confirming that a new add-on has been installed, like this: ## Configuring the Add-On After you have installed the add-on into Firefox, you will need to configure it. Basically, you will associate a desktop application (editor) with each relevant file type. This tells the Office Connector which application to launch when it encounters a link to an editable file. The configuration is slightly different for each operating system, as described below. #### Configuring the Add-On in Windows The add-on can will automatically configure itself on Windows via the system registry. The first time you edit a new file type, the add-on will look up the default editor for that file type and make that the permanent setting. If you want to override the registry settings, or if for some reason the automatic configuration is not working, you can configure the Firefox add-on manually. In Firefox, go to the 'Tools menu and select 'WebDAV Launcher Options', as shown in this screenshot: A 'WebDAV Launcher Options' window will appear, allowing you to associate a specific file type (file extension) with a desktop application (editor). The window looks like this one: In the 'File Extension box, enter the extension for a particular file type. For example, you may want to associate the 'doc' file extension with Microsoft Word. To do this, you would type 'doc' in the File Extension text box: Enter the 'Application Path — Use one of the following methods to specify the associated application for editing the given file type: Click the 'Auto' button to load the associated application from the Windows registry. Alternatively, you can click the 'Browse' button to find the application on your computer. Or you can manually type in the path to the application's executable file. Click the 'Add' button. The file extension association will be added to the list. In the picture below you can see that the 'doc' extension has been associated with 'C:\Program Files\Microsoft Office\OFFICE11\WINWORD.EXE'. This is the path to the Microsoft Word 2003 executable on a specific Windows machine. #### Configuring the Add-On in Mac OS X The only supported Office editor for Mac OS X is NeoOffice. (See Office Connector Prerequisites.) The add-on will try to configure itself automatically by looking under `/Applications/NeoOffice`, which is the default installation location for NeoOffice. If the automatic configuration does not work, you will need to associate your NeoOffice executable with each file type. The configuration procedure is similar to Windows, as shown above. Note that there is no 'Auto' button in Mac OS X. #### Configuring the Add-On in Linux The only known supported Office editor for Linux is OpenOffice. (See Office Connector Prerequisites.) There is no automatic configuration on Linux. You will need to associate each file type with your Office editor in Firefox. Note that there is no 'Auto' button in Linux. The configuration procedure is similar to Windows, as shown above. For both Ubuntu and OpenSUSE, the configuration will look something like this:
File Extension | Application Path
--- | ---
doc | /usr/bin/oowriter
ppt | /usr/bin/ooimpress
xls | /usr/bin/oocalc
## Security Risks
| Please be aware that there are security risks in installing this add-on to Firefox. Internet Explorer is exposed to the same risks, because it can directly open Office documents. By installing the add-in into Firefox, you are exposing Firefox to the same risks.
Summary of the risks: Office documents can contain macro viruses. Before opening an Office document, make sure that you trust the source of the document. There are known flaws in the Office file formats and Microsoft Office that an attacker can exploit to gain control of your machine. Microsoft has fixed the known exploits in the latest Service Packs for all Microsoft Office versions. But new exploitations may arise at any time. Again, be sure that you trust the source of a document before opening it. The add-on tries to reduce the risk by supporting the following: Same origin policy — The add-on can only open documents from the same host that initiated the action. Digital signature — The add-on is digitally signed. When you install the add-on please verify that it is signed by Benryan Software Inc. Prompt the user for confirmation — You will always be warned before a file is opened. Please read these warnings carefully before opening a file. The warning tells you the complete URL of the file as well as the complete application path of the application opening the file. ##### RELATED TOPICS Working with the Office Connector Office Connector Prerequisites Installing the Firefox Add-On for the Office Connector Editing a Confluence Page in an Office Application Importing an Office Document into Confluence Displaying an Office Document in Confluence Editing an Office Document from Confluence Editing an Office Presentation from Confluence Editing an Office Spreadsheet from Confluence Configuring the Office Connector in the Confluence Administration Guide Take me back to Confluence User Guide Attachments: OCFirefoxAddONPrompt.png (image/png) OCFirefoxAddOnConfirm.png (image/png) OCFirefoxAddOnConfirm2.png (image/png) OCFirefoxAddOnDone.png (image/png) OCFirefoxAddOnInstalled.png (image/png) OCFirefoxAddOnConfirm3.png (image/png) OCFirefoxAddOnConfirm4.png (image/png) OCFirefoxAddOnsigned.png (image/png) OCFirefoxAddOnWarning.png (image/png) OCFirefoxAddOnOptions.png (image/png) OCFirefoxAddOnOptions2.png (image/png) OCFirefoxAddOnOptions3.png (image/png) OCFirefoxAddOnOptions4.png (image/png) OCFirefoxAddOnOptions5.png (image/png)

Document generated by Confluence on Nov 05, 2009 23:35