Installing and Configuring the Userlane Browser Extension for Firefox on macOs (SSO)

Microsoft Edge, Mozilla Firefox and Google Chrome allow the silent installation of Browser Extensions. This way, the users do not have to manually install the Browser Extension themselves, but rather the IT Admins can roll out the Browser Extension in the background via a MDM solution, such as Microsoft InTune, Enteo NetInstall, or Matrix42 Empirum.

Each browser needs to be set up separately.

This article explains the configuration for Firefox on macOS.

Browser Extensions in Firefox can be installed and configured through Enterprise Policies.

Installation

Add the Userlane Extension (Link for Firefox: https://browser-extension.userlane.com/firefox/userlane.xpi)
to the Extension\Install list: https://github.com/mozilla/policy-templates#extensions 


There are 2 ways to achieve this.

Option A: With a plist file:
Example org.mozilla.firefox.plist file:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

<plist version="1.0">

<dict>

  <key>EnterprisePoliciesEnabled</key>

  <true/>

  <key>Extensions</key>

  <dict>

    <key>Install</key>

    <array>

      <string>https://browser-extension.userlane.com/firefox/userlane.xpi</string>

    </array>

  </dict>

</dict>

</plist>


Option B: With a policies.json file

Place a policies.json file inside the Firefox.app container at Firefox.app/Contents/Resources/distribution/policies.json.

Example policies.json file:

{

  "policies": {

    "Extensions": {

      "Install": [

        "https://browser-extension.userlane.com/firefox/userlane.xpi"

      ]

    }

  }

}


Configuration

(1) Firefox Extensions are configured through Managed Storage Manifests: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests.


Example managed storage manifest .json file::

{

  "name": "{9f6832a6-ec0c-11e8-8eb2-f2801f1b9fd1}",

  "description": "Config for the Userlane Extension in Firefox",

  "type": "storage",

  "data": {

    "companyId": "abc",

    "companyIntegrity": "xyz"

    "region": "eu|us"

  }

}

}

Place this .json file anywhere on the client.


(2) For Firefox to find the file, we need to add it’s path to a Registry Key: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Manifest_location. The Name of the Userlane Extension for Firefox is {9f6832a6-ec0c-11e8-8eb2-f2801f1b9fd1}.

User Icon

Thank you! Your comment has been submitted for approval.