Learn
Documentation
Support
Community

Installing and configuring Amplify

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.

Installing the Amplify browser extension

  1. Install the extension on your device manually to configure and test Amplify.

  2. Push the extension to a target group of Amplify users via a group policy or any other configuration management solution.

  3. After installing the Amplify extension, verify that the browser has added the extension by using the extension manager page:

    • For Google Chrome: chrome://extensions/

    • For Microsoft Edge: edge://extensions/

The Amplify extension from the Edge store only functions if SSO is enabled and configured.

The Amplify extension updates when a new version is released in the Chrome Web Store.

Amplify browser extension

Configuring the Nexthink Instance URL

Set up Amplify based on your specific needs:

To configure Amplify, ensure you have Manage Amplify permissions.

Configuring Amplify for a single instance

Connecting to the Nexthink instance from the Amplify extension

  1. Open the browser where you installed the Amplify extension (Google Chrome or Microsoft Edge).

  2. Right-click on the Amplify extension in the browser extension bar.

  3. From the drop-down, click Options to open the Nexthink Amplify configuration page.

  4. From the Nexthink Amplify configuration page, click on New instance.

image-20240312-115156.png

  1. Enter the Customer name and the URL of the organization's Nexthink instance using the following https://INSTANCE_NAME.cloud format.

    • The Nexthink URL must end with .nexthink.cloud with no forward slash after .cloud.

    • URL example:https://myorganization.nexthink.cloud.

image-20240312-115238.png

  1. Enable/disable SSO status.

If you are using a portal-less instance of Nexthink, you must enable SSO logins, as the system does not support non-SSO login attempts for portal-less instances.

  1. Log in following a successful authentication.

  2. Save the new instance configuration in the Amplify extension.

Configuring Amplify for multiple instances

The Amplify browser extension supports integrating multiple Nexthink instances. This is particularly helpful for support teams sharing an ITSM solution with customers with independent instances.

To locally add multiple Nexthink instances to Amplify:

  1. Open the browser where you installed the Amplify extension (Google Chrome or Microsoft Edge).

  2. Right-click on the Amplify extension in the browser extension bar.

  3. From the drop-down, click Options to open the Nexthink Amplify configuration page.

  4. Click New instance and fill in the fields from the pop-up:

    • Name that is used to identify the customer. The customer name is unique.

    • URL of the Nexthink instance of the customer. The instance URLs are unique.

    • Enable or Disable the SSO status toggle to match the SSO-configured status of the Nexthink instance.

If you are using a portal-less instance of Nexthink, you must enable SSO logins, as the system does not support non-SSO login attempts for portal-less instances.

  • Log in to the instance.

image-20240314-060843.png

  1. Once the authentication is successful, the Amplify extension adds the instance to the configuration.

  2. Click Save and add another instance by clicking on the Add instance button.

    • Edit or Delete instances, by opening the action menu from the relevant instance.

You require a valid account with Amplify permissions on each Nexthink instance to configure.

image-20240314-062636.png

Deploying Amplify

Deploying Nexthink instance configuration via Registry for Amplify users (Google Chrome)

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 URL by creating a registry key and values in the \policy folder as described below:

    • Name: instanceURL

    • Type: REG_SZ

    • Value: Enter your Nexthink instance URL, for example, https://myorganization.nexthink.cloud

Registry settings configuration

  1. Configure the SSO authentication by creating a registry key and values in the \policy folder as described below:

    • Name: isSsoEnabled

    • Type: REG_SZ

    • Value: 1 for true or 0 for false

If you do not choose the SSO enabled option, it remains disabled by default.

If you are using a portal-less instance of Nexthink, you must enable SSO logins, as the system does not support non-SSO login attempts for portal-less instances.

  1. 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

Registry editor

Deploying Nexthink instance configuration via Registry for Amplify users (Microsoft Edge)

  1. Create the folder structure \kcidkikoejfejnfmbmhmfkncdlopflhe\policy under the registry path HKLM\Software\Policies\Microsoft\Edge\3rdparty\extensions\

  2. In the policy folder, create the registry key and values as described below:

    1. Name: instanceURL

    2. Type: REG_SZ

    3. Value: Enter your Nexthink instance URL, for example https://Instance-Name.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

After configuring Amplify to integrate web applications for multiple instances, 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 section on this page.

Deploying configuration details on Amplify user devices - Registry path (Google Chrome)

Local machine:

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

OR

Current user:

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

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

Local machine:

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

OR

Current user:

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

RELATED TASKS

Last updated

Was this helpful?