LibKey Nomad Group Policy Deployment (FireFox)

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.
https://addons.mozilla.org/firefox/downloads/file/3695390/libkey_nomad-1.8.2-fx.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

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.






Feedback and Knowledge Base