Skip to main content
Skip table of contents

Installation and configuration guide

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

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

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

  • Find the Amplify extension on the Chrome Web Store and install it on either the Google Chrome or Microsoft Edge browser.

  • Visit the Amplify browser extension page on the Chrome Web Store to install it.

Manual installation on Google Chrome and Microsoft Edge

Amplify browser extension
  • Navigate to the Amplify browser extension page using the Google Chrome or Microsoft Edge browser. The same extension link works for both browsers.

  • Click on the Add to Chrome button.

  • Verify that the browser has added the extension by using the extension manager page:

    • For Google Chrome: chrome://extensions/  

    • For Microsoft Edge: edge://extensions/

Installing the extension on multiple devices

Deploy the Amplify extension on multiple devices through any one of the preferred methods, such as group policy, or through any other configuration management solution, such as SCCM or Microsoft Intune.

Configuring Amplify

Integrate with the Nexthink instance

After you install the Amplify browser extension, you must configure it to connect to your Nexthink instance. 

Manual local configuration

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

  • Right-click on the Amplify extension in the extension bar.

Options menu
  • Select Options to open the Amplify local configuration page.

  • On the configuration page, enter the URL of your organization's Nexthink instance using the following format: https://INSTANCE_NAME.

The Nexthink URL should always end with .nexthink.cloud with no forward slash after .cloud

  • If SSO has been configured on your Nexthink instance, enable the SSO toggle in the Amplify configuration, otherwise, keep it disabled. Refer to the Nexthink SSO configuration section for more information.

Nexthink Amplify configuration

If SSO is enabled for your Nexthink instance and in the Amplify configuration, Amplify will use the configured IDP for authentication instead of having the user log in through the Nexthink web interface.

  • Click Save.

  • The system will prompt you to log in to Nexthink. Clicking on the login button on the prompt will open the SSO authentication screen or open the Nexthink web interface in a new tab based on the SSO configuration status. If you are not using an SSO-based login, log in to the Nexthink web interface.

  • Amplify prompts you to open the Nexthink instance URL in a new tab.

  • Navigate back to the Amplify configuration tab.

  • Refresh to continue the configuration process.

  • Once the system has authenticated you in the Nexthink web interface and you have managed Amplify permissions mapped to your Nexthink profile, add the web applications to integrate with and save the configuration. Refer to the Amplify documentation for more information about permissions.

Configuring registry settings (centralized configuration of all Amplify users)

Setting the Nexthink instance URL in the registry

To deploy the Nexthink instance configuration to multiple devices centrally, Nexthink recommends pushing the configuration on all target devices using either a group policy, configuration management solution or Nexthink remote actions.

Configuring the Nexthink instance URL is mandatory before configuring the ITSM settings to integrate it with Amplify. 

  1. Create the folder structure  \bmpbcphgifhfkfjioddeenggdpffbgek\policy under the registry path mentioned below:

    1. For Google Chrome: HKLM\Software\Policies\Google\Chrome\3rdparty\extensions\

    2. For Microsoft Edge: 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

Registry settings configuration
  • Set the registry value for either a local machine, if one or more users with the same profile will be using the device, or a local user, if different users with different profiles will be using the device. Configure this setting in the browser properties. 

  • For a local machine: HKLM\Software\Policies\..\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy

  • For a current user: HKCU\Software\Policies\..\3rdparty\extensions\bmpbcphgifhfkfjioddeenggdpffbgek\policy

Setting the SSO authentication option via the registry

If SSO has been configured on the Nexthink web interface, set Amplify to use SSO authentication. Push this setting to the registry of Amplify user devices using GPO, Nexthink Remote Actions or any other preferred method.

For Google Chrome: 

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

For Microsoft Edge: 

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

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

  • Name: isSsoEnabled

  • Type: REG_SZ

  • Value: 1 for true / 0 for false

Registry editor

If you do not set the SSO enabled option, it will remain disabled by default.

Nexthink SSO configuration

To check if the Nexthink instance is configured for SSO:

  • Log in to the Nexthink web interface as an administrator.

  • Select Administration from the main menu.

  • Click on Single sign-on in the navigation panel.

  • Go to the SSO configuration tab.

  • Check if the SAML 2.0 authentication toggle is enabled and if the configuration has been defined.

Single sign-on configuration

Integrate with web applications

Integrate Amplify with any web application, such as an ITSM solution, and enable it on configured applications.

Central configuration

If you have Manage Amplify permissions enabled, you can configure Amplify to integrate with any web application centrally in the Nexthink web interface. All the devices that have the Amplify browser extension installed will pull the integration configuration from the Nexthink platform once the Amplify user logs in to the Amplify plugin.

Accessing Amplify
  • Log in to the Nexthink web interface.

  • Select the Administration module from the main menu.

  • Click on Amplify from the Integrations section of the navigation panel.

  • On the Amplify configuration page, click on the Add web application button.

Amplify_Configuration

Configure Amplify to work on all pages of the web application

If you want to place the Amplify button on all pages of the web application without reading the device or user identification fields from the webpage, follow the steps below. This configuration places Amplify buttons on all pages of the web application. Clicking on the Amplify button opens a search box to search for a user or device.

  • In the Web application URL field, add the base URL of the application.

  • Leave the User or device identifier value field blank.

  • Click Save.

  • Repeat the process to add more web applications.

  • Hover over the action menu to edit, delete, or move it up and down within the list.

  • Click on the edit or delete icon, then click Save.

Amplify - 1705076264.png

Configure Amplify to work on a specific module of a web application

If you want to place an Amplify button only on specific pages without reading the device or user identification fields from the webpage, follow the steps below. This configuration places Amplify buttons only on pages of the specified module. Clicking on the Amplify button opens a search box to search for a user or device.

Amplify_Name_Web_App
  • In the Web application URL field, add the URL of a specific module of the application where the Amplify button should be activated.

  • Leave the User or device identifier value field blank.
    For example, if you want to place the Amplify button on all pages of the ServiceNow incidents module without configuring the fields to read from, add the web application URL https://your-service-now.com/nav_to.do?uri=%2Fincident.do and leave the User or device identifier field blank.

  • Click Save.

  • Repeat the process to add more web applications.

  • Hover over the existing configuration to edit, delete or move it up and down within the list.

  • Click Save.

Local configuration (single device)

The following configuration enables Amplify only on a specific device and is not applicable to other Amplify users until the same configuration is updated in the Amplify central configuration, in the Nexthink web interface.

  • Open the browser with the installed Amplify extension.

  • Right-click on the Amplify extension icon in the extensions bar.

  • Select Options from the menu.

  • Select the Local tab.

  • Click the Add web application button.

Enable Amplify to work on all pages of the web application.

If you want to place an Amplify button on all pages of the web application without reading the device or user identification fields from the webpage, follow the steps below. This configuration places Amplify buttons on all pages of the web application. Clicking on the Amplify button opens a search box to search for a user or device.

Local configuration
  • In the Web application URL field, add the base URL of the application.

  • Leave the User or device identifier value field blank.

  • Click Save.

  • Repeat the process to add more web applications.

  • Hover over the existing configuration to edit, delete or move it up and down within the list.

  • Click Save.

Enable Amplify on a specific module of a web application.

If you want to place an Amplify button only on specific pages without reading the device or user identification fields from the webpage, follow the steps below. This configuration will place Amplify buttons only on the pages of the specific module. Clicking on the Amplify button opens a search box to search for a user or device.

Amplify - 1705076730.png
  • Under the Web application URL field, add the URL of a specific module of the application where the Amplify button should be activated. For example, if you wish to place an Amplify button on all pages of the ServiceNow incidents module without configuring the fields to read from, enter the web application URL https://your-service-now.com/nav_to.do?uri=%2Fincident.do

  • Leave the User or device identifier value field blank.

  • Click Save.

  • Repeat the process to add more modules of the application.

  • Hover over the existing configuration to edit, delete, or move it up and down within the list.

  • Click Save.

Using Amplify on the configured webpage

Once you have completed the configuration process, Amplify is enabled for the configured webpage. You can use it in the following ways.

Using Amplify for the first time post-installation

After the extension is deployed on user devices follow the steps below.

  • Open the web application Amplify integrates with.

  • (optional) If the extension is not pinned to the browser when deployed, click on the extension icon in the toolbar and click on the pin icon next to Nexthink Amplify.

  • Click on Nexthink Amplify to authenticate to your Nexthink instance.

  • Once the user authenticates to the Nexthink instance, the configurations are downloaded to the device and the button gets placed in the bottom left corner of the configured web page by default, which can be used to launch Amplify for further usage.

Using the button on the web page

After the user authenticates to the extension for the first time and the button gets placed on the configured web application, users can click the Amplify button from the web page to launch the pop-up.

Look up with the right-click context menu

Highlight the device or user on the webpage, right-click, and select the Look up… on Amplify option from the context menu to load the details for the selected item.

Look up with a keyboard shortcut

Configure the Amplify browser extension to look up selected text using keyboard shortcuts on a webpage.

  • Right-click on the extension icon in the browser and select the Manage Extension option.

  • On the extensions management page, select the keyboard shortcuts option from the left-side menu.

  • Scroll down to the Nexthink Amplify extension shortcut options.

  • Set or update a desired shortcut key combination for the Look up device or user in Amplify option.

  • Go to the configured webpage and select the desired user or device name from the webpage. Press the shortcut key combination to launch and look up the device or user on Amplify.

Using the search option in the Amplify pop-up

  • Click on the Amplify button that appears in the bottom-right corner of the page to launch a pop-up.

  • Enter the device or user in the search field to view more details.

Search option in the Amplify pop-up

Using checklists

Checklists shows the list of parameters and ratings along with the description of the property, which helps you assess the impact of the parameters on the selected device.

  • Click on the checklists tab to view all the checklists mapped to your profile.

  • Use the dropdown to switch between different checklists.

  • Click on the properties in a checklist to view the details of the property such as the description, custom documentation and links added by the checklist administrator, and a list of remote actions mapped to the property that can be triggered to take relevant actions on the device.

Using remote actions

Trigger actions on the selected device from the remote actions tab or view the status of the actions that were triggered on the device in the past seven days.

  • Go to the remote actions tab to view the list of all remote actions mapped to your profile.

  • Click on the sort options to sort the remote action by name or execution time.

  • Use the search option to locate a specific remote action from the list.

  • Click on the Run button next to the remote action name to trigger the action on the selected device.

  • Once executed, expand the name of the action to view the execution status.

  • Use the copy to clipboard icon to copy the execution details of the executed action to paste it into the ticket or notes.

Copying content from Amplify

Copy content such as device properties, user properties, fields and the values of checklists, and remote action execution details from Amplify to use elsewhere such as ticket log updates.

To copy the device properties, user properties and checklist details, click on the action menu on the top of the section and select the copy option.

Changing the settings of the Amplify pop-up

Click on the settings icon on the pop-up to change the appearance and select the default location to place the Amplify button on the web pages.

Changing the size and location of the pop-up

Resize the pop-up by pulling the pop-up window from any of the corners or edges.

To move the pop-up to a different location, hold the Nexthink logo on the pop-up and drag it to a custom location.

Changing the Amplify button location

If you want to change the position of where the Amplify button is placed on the configured web page, hover over the top-right corner of the button and when the pointer changes to the move option, click and drag the button to a custom location.

Configuring Amplify to read identifiers from a specific field

Configure Amplify to read the value of a device or user identifier from a persistent field from a web application.

Due to the varying UI designs and field availability on different web applications, this configuration may not be supported in certain cases.

Configuring the field selector on local plugin options

  • Log in to the Nexthink web interface in a different tab of the same browser and keep the tab open. Use the browser that has the Amplify extension installed.

  • Ensure your profile has Manage Amplify permissions enabled. Refer to the Amplify documentation for more information about permissions.

  • Right-click on the Amplify extension icon in the extensions bar.

  • Select Options from the menu.

  • On the Amplify configuration page, verify that the Nexthink instance URL is configured properly. If the configuration has already been deployed to the registry or added manually, the URL will be displayed on the page. Otherwise, add the valid Nexthink instance URL to proceed. Refer to the Manual local configuration section of this documentation for more information on the syntax of a valid Nexthink instance URL.

  • Open the URL of a web application in a new tab and navigate to one of the pages that has the device or the user field populated.

  • Copy the entire URL of the page.

  • Navigate back to the Amplify extension configuration tab.

  • Click on the Add web application button and paste the URL into the Web application URL field.

  • Click on the Device or user identifier field to reveal a plus button.

  • Click on the plus button that opens the URL in a new tab. The new tab contains a selector pop-up.

  • Use the highlighter to select the field on the page that contains the affected device. Once selected, the system loads the element details into the pop-up. 

Amplify - 1705076721 (1).png
  • Click Save after the selector loads the details in the element editor for the selected field.

  • Click on the Reset button if you wish to change the configuration before saving it.

Modifying the selection of device or user identifier

Amplify field selector now supports the use of regular expressions for partial text matching. This enables the selection of specific parts of the string from the selected field value. When searching for relevant information on Nexthink, specify the relevant part of the selected field from the selected field for accurate identification. Refer to the Regular expression Wikipedia page to learn more about this concept.

To modify the device or user identifier:

  • In the String selector field, enter the relevant regular expression.

  • Click the Fill field value button to verify the correct selected field value.

  • Click Save to modify the relevant device or user identifier.

Amplify - 1705076721.png

Navigating the webpage when the selector is open (disabling selector)

In certain cases, the webpage may have a pop-up that blocks the selector.

  • If you need to navigate away from the page to a different page, or if there are pop-ups blocking the selector from being able to pick a field, use the Disable selector toggle in the selector pop-up to enable navigation.

  • Once you have navigated to the right page, switch off the Disable selector toggle to once again enable the selector field picker and continue with the configuration.

Amplify - 1705076730_1 (1).png

Configuring Amplify for specific ITSM solutions

The following guidelines outline what to do when an ITSM solution doesn’t support the out-of-the-box selector configuration due to version incompatibility or user interface design:

Central configuration

If you have Manage Amplify permissions enabled, you can configure integration settings centrally in the Nexthink web interface. All devices that have the Amplify browser extension installed, will pull the integration configuration from the Nexthink platform once the Amplify user logs in to the plugin.

Before configuring Amplify centrally in the Nexthink web interface, you must first configure the extension locally on your device. Refer to the Configuring Amplify to read identifiers from a specific field section, and copy the configuration from the local configuration of the Amplify plugin into the Nexthink web interface.

  • Log in to the Nexthink web interface.

  • Select the Administration module from the main menu.

  • Click on Amplify from the Integrations section of the navigation panel.

Accessing Amplify
  • Click Add web application on the Amplify administration page.

  • Open a new tab and right-click on the Amplify extension button in the extensions bar of your browser.

  • Select Options from the menu to view the local configuration.

  • Click on the Copy to clipboard button next to Web application URL from the web application section of the configuration page.

  • Paste the content into the Web application URL field on the Amplify administration page in the Nexthink web interface.

  • Click on the Copy to clipboard button next to the Device or user identifier field to copy the content of the field selector.

  • Paste the content into the Device or user identifier field on the Amplify administration page in the Nexthink web interface.

  • Click Save

  • Repeat the process to add more applications.

  • Hover over the existing configuration to edit, delete or move it up and down within the list.

  • Click Save.

If you configured Amplify to read the value from a specific field of the web application when the user clicks on the Amplify button, it reads the value of the specified field and tries to look up the matching string in the Nexthink web interface to display details of the user or device name. If there is no match found or if the field is empty, Amplify displays an option to search for any device or user name.

Setting the search order of fields

Configure Amplify to read the values of more than one field on a specific webpage by adding an entry for each field in the settings. For example, you can configure it to read the device identifier and user identifier from the same page of the web application. The plugin tries to load the value of the first field and if it doesn’t find it, it looks for the value in the next field in the set order.

Local configuration

If there is more than one field configured for the same URL, Amplify reads the values of the fields in a sequence. Follow these steps to change the sequence in which the fields are selected from the configured web application on a single device:

  • Go to the extensions options page.

  • Navigate to the local configurations tab.

  • Hover over the configuration row that you need to change the order of.

  • Use the up or down arrows to change the order.

  • Click Save.

Only users with Manage Amplify permissions can modify the configuration in the local configuration tab of the plugin options. Central configurations cannot be edited or deleted from the extension options page as this must be managed from the Amplify configuration menu in the Nexthink web interface.

Central configuration

If there is more than one field configured for the same URL, Amplify reads the values of the fields in a sequence. Follow these steps to change the sequence in which the fields are selected from the configured web application for all Amplify users:

  • Log in to the Nexthink web interface.

  • Select the Administration module from the main menu.

  • Click on Amplify from the Integrations section of the navigation panel.

  • Hover over the configuration row that you need to change the order of.

  • Use the up or down arrows to change the order.

  • Click Save.

The system updates the new sequence for all Amplify users the next time they open or log in to the Amplify browser extension on their device.

Updating the Amplify extension

When a new version of Amplify is released, the browser extension is updated on the Chrome Web Store and can be managed by the organization’s IT policy.

Reset the Nexthink URL configuration

If you changed the Nexthink URL and SSO toggle settings on the plugin options page to test a different configuration and want to reset to the configuration deployed to the registry by your organization, use the Restore default button which overwrites the Nexthink URL and the SSO setting that you have manually set with the values from the registry retrieved by your browser. 

Restore default

The Restore default button appears only when the value defined in the registry for either the Nexthink URL or SSO-enabled field is different from the value set in the local configuration for the corresponding fields. 

Considerations

  • If you have set the Nexthink instance URL manually in the local configuration of the extension, the system will not copy the value from the registry to the local configuration.

  • The system will fetch and update the Amplify ITSM configuration every time the user logs in to Amplify.

  • Local extension configuration always takes precedence over central configuration.

  • The central configuration in the Nexthink web interface cannot be edited or deleted from the extension’s configuration page.

  • If you edit or delete a configuration item in the Nexthink web interface, the system updates these changes in the extension’s local configuration when you log in to Amplify.

  • If the central and local configuration is the same, the extension will still work based on the local configuration.

  • If you have been logged in to Amplify and the central configuration changes or the user permissions change, you can continue using Amplify until you are reauthenticated on Amplify and the configuration is updated and reloaded.

  • Sometimes, the selector might not work on various versions of web applications due to different UI designs of the applications. In such cases, use the application’s base URL or URL of the specific module of the web application to integrate with Amplify. The Amplify button will appear on all pages of the specific module or all pages of the web application based on the configuration. Users can use the search function or use the “Look up… on Amplify” option in the right-click contextual menu or keyboard shortcut by highlighting the desired device or user name from anywhere on the configured web application. 

  • If you have only configured the base URL of the web application without specifying the field to read the user or device identifier from, the Amplify button will appear on all pages of the web application with the search option as default. To look up a string, use the right-click context menu or the configured keyboard shortcut to launch and look up the device or user on Amplify.

  • If you have configured the URL of a specific page but have left the device or user identifier field blank, the system will place the Amplify button only on the specific URL.


RELATED TASKS

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.