# Deploying Amplify to multiple devices

{% hint style="warning" %}
This documentation references external sources. Nexthink does not have control over the accuracy of third-party documentation, nor any external updates or changes that might create inconsistencies with the information presented on this page. Please report any errors or inconsistencies to [Nexthink Support](https://support.nexthink.com/).
{% endhint %}

Nexthink Amplify relies on a browser extension available for Google Chrome and Microsoft Edge.

The Nexthink browser extension is available in the Chrome Web Store and Edge store.

* Download the extension from [Nexthink Amplify - Chrome Web Store](https://chrome.google.com/webstore/detail/nexthink-amplify/bmpbcphgifhfkfjioddeenggdpffbgek) with `bmpbcphgifhfkfjioddeenggdpffbgek` as the extension ID.
* Download the extension from [Nexthink Amplify - Microsoft Edge Addons](https://microsoftedge.microsoft.com/addons/detail/nexthink-amplify/kcidkikoejfejnfmbmhmfkncdlopflhe) with `kcidkikoejfejnfmbmhmfkncdlopflhe` as the extension ID.

## Deploying the Amplify browser extension <a href="#extensiondeployment-deploymentconsiderations" id="extensiondeployment-deploymentconsiderations"></a>

### Deployment considerations <a href="#extensiondeployment-deploymentconsiderations" id="extensiondeployment-deploymentconsiderations"></a>

* Deployment pace varies and depends on the release process of your organization.
* Any change in hardware or software precedes the implementation of the browser extension by a proof of concept and testing phase. This should be done on a limited number of endpoints.
* Use Group Policy Object (GPO) on Microsoft Windows to deploy the browser extension on selected target devices if this is the standard way of managing browser extensions in your organization.
  * Ensure that the Nexthink browser extension is a part of the organization’s [browser policy](#extensiondeployment-policies), which enforces the extension.
* Before deploying the Amplify browser extension, ensure that you do not have existing browser extensions set at the current or higher user level; otherwise, the system might uninstall them.
  * Check your existing policies on a device, by typing `chrome://policy` in the Chrome address bar.
  * Check your existing policies on a device, by typing `edge://policy` in the Edge address bar.

{% hint style="info" %}
Before rolling out the extension to all target users, Nexthink strongly recommends educating those target users on how to use the extension.
{% endhint %}

### Deployment policies <a href="#extensiondeployment-policies" id="extensiondeployment-policies"></a>

Your IT department can deploy the browser extension using a GPO or policy profile.

If the extension is not deployed through GPOs on Windows, verify that no existing policy can remove the extension.

For more information about policy management, refer to your browser documentation:

* [Understand Chrome policy management](https://support.google.com/chrome/a/answer/9037717)
* [Configure Microsoft Edge policy settings on Windows](https://docs.microsoft.com/en-us/deployedge/configure-microsoft-edge)

### Deployment from Chrome store <a href="#extensiondeployment-chrome" id="extensiondeployment-chrome"></a>

To deploy the Amplify browser extension for Google Chrome, add the Nexthink Amplify Chrome browser extension ID to the Chrome browser's Extension Install Force list GPO.

Here is an example of a registry key pushed by GPO for the Chrome browser:

<pre><code>Windows Registry Editor Version 5.00

<strong>[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist]
</strong>"1"="bmpbcphgifhfkfjioddeenggdpffbgek;https://clients2.google.com/service/update2/crx"
</code></pre>

Here is an example of a registry key pushed by GPO for the Edge browser:

```
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallForcelist]
"1"="bmpbcphgifhfkfjioddeenggdpffbgek;https://edge.microsoft.com/extensionwebstorebase/v1/crx"
```

#### **Force the browser extension pinned state**

For managed Chrome browsers on Windows and macOS, you can pin the extension to the toolbar by default, making it easier to locate and use Amplify.

Adjust the `toolbar_pin` setting of the **ExtensionSettings** policy to force the browser extension pinned state.

Refer to the [Chrome support ](https://support.google.com/chrome/a/answer/9867568?hl=en\&sjid=7959409330485200328-AP)website for more information.

### Deployment from Edge store <a href="#extensiondeployment-chrome" id="extensiondeployment-chrome"></a>

To deploy the Nexthink browser extension for Microsoft Edge, add the Nexthink Applications Edge browser extension ID to the Extension Install Force list GPO of the Edge browser.

Here is an example of a registry key pushed by GPO:

```
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallForcelist]
"1"="kcidkikoejfejnfmbmhmfkncdlopflhe"
```

## **Deploying Nexthink instance configuration via Registry for Amplify users**

### **Google Chrome Extension**

To deploy the Nexthink instance configuration to multiple devices:

1. Create the folder structure `\bmpbcphgifhfkfjioddeenggdpffbgek\policy` under the registry path mentioned below:
   * For Google Chrome: `HKLM\Software\Policies\Google\Chrome\3rdparty\extensions\`
   * For Microsoft Edge: `HKLM\Software\Policies\Microsoft\Edge\3rdparty\extensions\`
2. Add the Nexthink instance details by creating a registry key and values in the `\policy` folder as described below:
   * **Name**: `tenants`
   * **Type**: `REG_SZ`
   * **Value**: Enter your Nexthink instance details in the following format:
     * `[{"uuid":"[unique-identifier]","name":"customer-A","url":"https://myorganization.nexthink.cloud"}]`

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FfEalwuP0kFihPlY8VQTo%2Fimage.png?alt=media&#x26;token=9224ee76-02de-4f65-9aa5-7053bcf874df" alt=""><figcaption></figcaption></figure>

3. In the browser properties, set up the registry value for:

* A local machine, if one or more users with the same role use the device:`HKLM\Software\Policies\..\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy`
* A current and local user, if different users with different roles use the device: `HKCU\Software\Policies\..\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy`

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-96aa7dc569b50100aadfa322ec3d9c37bd139120%2Famp-1679489052.png?alt=media" alt="Registry editor" width="750"><figcaption></figcaption></figure>

### **Microsoft Edge Extension**

1. Create the folder structure `\kcidkikoejfejnfmbmhmfkncdlopflhe\policy` under the registry path `HKLM\Software\Policies\Microsoft\Edge\3rdparty\extensions\`
2. Add the Nexthink instance details by creating a registry key and values in the `\policy` folder as described below:
   * **Name**: `tenants`
   * **Type**: `REG_SZ`
   * **Value**: Enter your Nexthink instance details in the following format:
     * `[{"uuid":"[unique-identifier]","name":"customer-A","url":"https://myorganization.nexthink.cloud"}]`
3. In the browser properties, set up the registry value for:
   * A local machine, if one or more users with the same role use the device: `HKLM\Software\Policies\..\3rdparty\extensions\kcidkikoejfejnfmbmhmfkncdlopflhe\policy`
   * A current and local user, if different users with different roles use the device: `HKCU\Software\Policies\..\3rdparty\extensions\kcidkikoejfejnfmbmhmfkncdlopflhe\policy`

## Exporting the configuration details from the Amplify extension <a href="#installationandconfiguration-exportingtheconfigurationdetailsfromtheamplifyextensionexportingconfigu" id="installationandconfiguration-exportingtheconfigurationdetailsfromtheamplifyextensionexportingconfigu"></a>

After configuring Amplify to integrate web applications for [multiple instances](#installationandconfiguration-configuringamplifyformultipleinstancesmulti-instance), from the Amplify extension:

1. **Download configuration** to export the configuration details in `.reg` registry file.
2. Deploy the web application configurations to the target Amplify user devices via Registry.
   * The configuration file contains individual files for `HKLM` and `HKCU` settings for Google Chrome and Microsoft Edge respectively.

Deployment considerations:

* The Amplify extension does not pull the central configuration from Nexthink for configured multi-instances.
* Registry values update configured web applications locally if present, preventing any configuration edits from within the Amplify extension.
* Invalid syntax values in the registry do not update web application configurations.

Refer to the [Deploying Nexthink instance configuration via Registry for Amplify users](#deploying-nexthink-instance-configuration-via-registry-for-amplify-users) section on this page.

#### **Deploying configuration details on Amplify user devices - Registry path (Google Chrome Extension on Google Chrome browser)**

Local machine:

{% code overflow="wrap" fullWidth="false" %}

```
HKLM\SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy
```

{% endcode %}

OR

Current user:

{% code overflow="wrap" fullWidth="false" %}

```
HKCU\SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy
```

{% endcode %}

#### **Deploying configuration details on Amplify user devices - Registry path (Google Chrome Extension on Microsoft Edge browser)**

Local machine:

{% code overflow="wrap" fullWidth="false" %}

```
HKLM\SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy
```

{% endcode %}

OR

Current user:

{% code overflow="wrap" fullWidth="false" %}

```
HKCU\SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy
```

{% endcode %}

#### **Deploying configuration details on Amplify user devices - Registry path (Microsoft Edge Extension)**

Local machine:

{% code overflow="wrap" fullWidth="false" %}

```
HKLM\SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\kcidkikoejfejnfmbmhmfkncdlopflhe\policy
```

{% endcode %}

OR

Current user:

{% code overflow="wrap" fullWidth="false" %}

```
HKCU\SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\kcidkikoejfejnfmbmhmfkncdlopflhe\policy
```

{% endcode %}