Private hosting (Edge)

Deploy the JNLP Runner chrome extension via Group Policy (Windows).

If your organisation requires to use our extension in multiple devices, we have amazing news for you! Our JNLP Runner extension is available for private hosting and deployment via Group Policy. This way, you can deploy our extension for multiple users under your organisation simultaneously and administrate it from a single place. This page will take you step by step on how to do this.

Requirements:

The appropriate IT permissions at your organisation.
The JNLP Runner extension CRX file.

The CRX File and `DownloadURL`

The CRX file is a compressed format for browser extensions. To obtain the CRX file of the JNLP runner extension for self-hosting, you will need to contact us and we will be happy to provide it for you alongside a license token.

You will need to host the extension CRX file in the appropriate location of your IT infrastructure and create a DownloadURL to access it. You will need this URL later in the tutorial.

About DownloadURL

You can also use the Edge add-ons store DownloadURL, but you won’t be self-hosting the extension and it will be retrieved from the Edge store for all your users. This is a limitation for IT infrastructures where the organisation devices do not have connection permissions to the wider internet. For this reason we recommend the self-hosting method.

The extension ID

The extension ID is a unique identifier you can easily retrieve from the extension URL of Edge’s Add-ons store (last 32 characters):

https://microsoftedge.microsoft.com/addons/detail/cheerpj-jnlp-runner/dpleickbpchmkpkmicanfolmianepfhe

The extension ID is:

dpleickbpchmkpkmicanfolmianepfhe

The policy string

Now that you have the extension’s CRX file and ID, you can build the policy string by merging the extension’s ID and the CRX Download URL separated by a semicolon: ID;DownloadURL It must look something like this: dpleickbpchmkpkmicanfolmianepfhe;https://some.download.url.file.crx

Hypothetical policy string

The example above contains hypothetical URL, please do not use this policy string.

Policy templates

You need to install the Microsoft Edge Administrative template to configure policies for Edge. Please follow this tutorial by Microsoft

Edge policies

Creating a new group policy

Now you have everything you need to create a new GPO, please follow these final steps to create a Group Policy. You can skip this step and just edit an existing one.

Open the Group Policy Management interface
Go to your desired domain and right click to display the options menu.
Click on Create a GPO in this domain, and Link it here…
Name your policy object and hit Ok.

Force-install

You can now configure your Group Policy to force install the extension in all your organisation browsers. To do so, you will need the Policy String from the previous step and follow this force-install tutorial by Microsoft

Licensing and further group policy setup

The final step is to setup your license among other relevant configurations for this Group Policy.

Open the Group Policy Management interface, find the JNLP Runner group policy you created previously (or your existing policy) and click Edit.
Find Microsoft Edge > Extensions > Configure Extension management setting policy.
On the right side menu click on Configure Extension management settings.

In this window you can configure all the settings relevant for your organisation when using the JNLP runner extension. To do so you need to input the relevant settings in JSON format into the editor. This is done by editing the JSON string shown in the interface using the format:

{ "*": { "FieldKey": "FieldValue" } }

They Key (*) will apply the settings to all extensions or apps under this policy. Remember to use the extension ID for those settings that you want to apply only for the JNLP Runner extension.

{ "ExtensionIDHere": { "SettingField": "FieldValues" } }

Licensing

To correctly configure your license, make sure to include the license token field in your JSON:

{ "ExtensionIDHere": { "licenseToken": "YourValidTokenHere" } }

Other settings

Remember you can always configure other settings for this Group Policy that are appropriate for your group of users and the extension. You can do this in this same JSON adding the appropriate key/values as the examples shown below:

For example:

Always pin this extension to the browser toolbar

{ "ExtensionIDHere": { "toolbar_state": "force_shown" } }

Block extension from interacting with certain websites:
```
{ "runtime_blocked_hosts": ["*://an.example.com"] }
```
Allow the extension to interact with specific websites even when they’re in the blocked list:

{ "runtime_allowed_hosts": ["*://an.example.com"] }

For more information about extension settings visit The Microsoft documentation

Microsoft Documentation

Update your changes

Once you are happy with your group policy configuration, you can apply these changes to see them reflected on your user’s Edge clients by running the shell command:

 gpupdate