LibKey Nomad Group Policy Deployment (Firefox)

Modified on Fri, 03 Nov 2023 at 11:22 AM

Part 1: Configure Firefox to manage LibKey Nomad


Step 1: Download and Install the Mozilla Firefox policy template

1. Download the Latest release policy_templates_*.zip
(https://github.com/mozilla/policy-templates/releases).

2. Unzip the bundle.

3. Copy \policy_templates_v*.*\windows\firefox.admx to C:\Windows\PolicyDefinitions\firefox.admx

4. Copy \policy_templates_v*.*\windows\en-US\firefox.adml to C:\Windows\PolicyDefinitions\en-US\firefox.adml

5. Once complete, a Firefox folder will appear under (Start > Run: gpmc.msc) Group Policy Management > Computer Configuration > Administrative Templates.


Step 2: Configure Mozilla Firefox in Group Policy Management Console

1. Navigate to Start > Run: gpmc.msc.

2. Navigate to Group Policy Management > Computer Configuration > Administrative Templates > Firefox > Extensions

Right click and Edit the “Extensions to Install”


Step 3: Enable Nomad to automatically install to Firefox

1. Tick the Enabled button, and then click the Show button


2. Add the following *.xpi file for the latest version of Nomad and Click OK.
http://addons.mozilla.org/firefox/downloads/latest/libkey-nomad/addon-16123162-latest.xpi



Find a “Download file” link or a “Add to Firefox” link and Copy Link Location.

3. Click "Ok"

4. Click "Apply" and then "Ok"

5. Now proceed to right click and Edit the “Prevent extensions from being disabled or removed."


Add the latest version of Nomad like before.



Once complete, both “Extensions to Install” and “Prevent extensions from being disabled or removed” should be Enabled.



Part 2: Setup your libraryId on the system

Step 4: Tell Nomad your libraryId so it can be automatically detected

The procedure for provisioning managed storage is different for different browsers.

For Firefox, you need to create a JSON manifest file in a specific format, in a specific location.

Section 1 - Create the JSON manifest file for LibKey Nomad

First, create the following folder path to store the JSON manifest file for LibKey Nomad:
C:\Users\Public\Third Iron\LibKey Nomad\
Next, create the JSON manifest file for LibKey Nomad:
{
  "name": "{f282d54d-83cc-45f5-b3e5-65888de1682b}",
  "description": "LibKey Nomad",
  "type": "storage",
  "data": {
    "libraryId": "ENTER YOUR LIBRARY ID (e.g. 1234)"
  }
}
Then, name the JSON manifest file {f282d54d-83cc-45f5-b3e5-65888de1682b}.json and save it under the new folder path:
C:\Users\Public\Third Iron\LibKey Nomad\{f282d54d-83cc-45f5-b3e5-65888de1682b}.json


Note: The JSON manifest file name must be the same value of the name property in the JSON manifest file for LibKey Nomad.

Note: The file extension MUST be .json


Make sure you replace the JSON placeholder text "ENTER YOUR LIBRARY ID (e.g. 1234)" with your actual Third Iron Library ID. Note that this should be a numerical value only. If you are not sure of your Library ID, please contact support@thirdiron.com to ask for it. 

How to locate your Third Iron Library ID

Via BrowZine: Log in to BrowZine. Your Third Iron ID is the number in your library's BrowZine URL: 
https://browzine.com/libraries/###

Via LibKey.io: Log in to LibKey.io. Your Third Iron ID is the number in your library's LibKey URL: 
https://libkey.io/libraries/###

Step 5 (optional): Set preferred Nomad button placement


If you would like to set a preferred location for Nomad's button at the Group Policy level you can also add "buttonPlacement:" under the data property after libraryId. The two possible options are:


bottomLeft (default): Nomad's button will be placed in the bottom-left corner of the screen

bottomRight: Nomad's button will be placed in the bottom-right corner of the screen


As in:

{
  "name": "{f282d54d-83cc-45f5-b3e5-65888de1682b}",
  "description": "LibKey Nomad",
  "type": "storage",
  "data": {
    "libraryId": "ENTER YOUR LIBRARY ID (e.g. 1234)",
    "buttonPlacement: "bottomRight"
  }
}

Section 2 - Create a registry key that points to the manifest’s location

On Windows, you need to create a registry key that points to the manifest's location

The key should have a single default value, which is the path to the manifest. Run the following command as an administrator from Command Prompt or another method that works best for you:

reg.exe add "HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\ManagedStorage\{f282d54d-83cc-45f5-b3e5-65888de1682b}" /ve /t REG_SZ /d "C:\Users\Public\Third Iron\LibKey Nomad\{f282d54d-83cc-45f5-b3e5-65888de1682b}.json"



Note: The LibKey Nomad extension icon will be green once the Library Id has been successfully added. If no Library Id, or a non-existent Library Id is added, the extension icon will be gray. Please validate your Library Id is active before distributing the extension to your network.

Note: Additionally, a Library Id configured correctly through group policy will suppress the LibKey Nomad initial library selection page on install.