Enrich Browser Extension

Use the ControlUp Enrich browser extension to integrate ControlUp for Desktops monitoring and remediation features into other SaaS applications.

You can open the Enrich overlay when you are viewing a device with the ControlUp for Desktops Agent installed from another SaaS application (for example, Microsoft Intune, ServiceNow, or the Google Admin Console). The overlay lets you see device data from ControlUp and perform remediation actions on the device without leaving the SaaS application.

From the Enrich overlay, you can:

• Perform actions on the device, including custom scripts that you have added to ControlUp.
• Start a Remote Control or Remote Shadow session.
• Open a Remote Shell to access the device's command line.
• See which processes are consuming the most resources. You can kill a process directly from the Enrich overlay.
• See details about the device's network connection, including WiFi signal strength, latency, and network usage.
• See real-time and historical performance metrics such as CPU and RAM usage.
• See events recorded in the Windows Event Log.
• See Blue Screen Errors (BSODs) that have occurred on the device.
• See application crashes.
• See OS and hardware information.
• See the device's storage drives.

Supported browsers

You can install ControlUp Enrich on the following browsers:

• Microsoft Edge
• Google Chrome

Configure Enrich settings

You can configure settings to control the websites from which you can open Enrich, how often Enrich syncs with your ControlUp organization, and login preferences.

To configure Enrich, sign into app.controlup.com, go to Settings > Enrich, and enable the settings. Any Enrich extension that connects to your organization stays updated with the configuration you set on this page.

If you use more than one ControlUp organizations and enable Enrich settings in multiple organizations, Enrich will fetch the configuration for the most recently connected organization.

Refresh interval

The refresh interval sets how often the Enrich extension syncs with your list of ControlUp-managed devices and your list of supported sites. For example, if you set a 12-hour refresh interval and you add a new device to ControlUp, it could take up to 12 hours before you can open Enrich while you are viewing that device in another SaaS application.

To manually perform a sync, you can open the extension, go to the Sync tab, and click Sync now.

Sign in with SAML SSO

If you aren't signed into ControlUp in your browser and you open Enrich, you have to sign in to your ControlUp organization. By default, the login link takes you to your login screen where you can select your login method. If you use SAML and enable this option, the login link takes you directly to your SAML URL for a faster login experience.

Device and user detection methods

The Device and User Detection Methods settings determine how Enrich detects device information on the page.

• For device detection methods, Enrich displays a device if the device's name or serial number is detected on the page. A device is detected using its serial number only if the serial number is longer than 4 charachters.
• For user detection method methods, Enrich displays a device if the device user's UPN or display name is detected on the page. Enrich uses the console_user_upn and console_user_display_name fields in the _devices data index (depending on which detection methods are enabled) to determine which devices belong to the user.

When you open Enrich and view a device, you can see how the device was detected on the page underneath the device name.

Automatically log Enrich actions into ServiceNow work notes

With this feature enabled, actions performed through Enrich (such as Remote Control, script executions, etc.) while you are viewing a ServiceNow incident, are automatically added to the incident's work notes.

Sites

By default, you can use Enrich from ServiceNow or Microsoft Intune. If you want to use Enrich from other sites, click Add Sites and add a URL. You can use wildcards, for example https://*console.aws.amazon.com.

If the information identfiying a device (such as the device name or UPN) is within an iframe, you must enable Iframe Support (Advanced) when adding or editing a site. You should enable this only after you have confirmed that iframe support is necessary for the site.

How to use Enrich

1. Install the ControlUp Enrich plugin from the Microsoft Edge or Google Chrome extension store.

2. If this is your first time using Enrich and you have customized Enrich settings (described above), make sure you sign into ControlUp so that the extension can fetch the custom configuration.

3. Navigate to a supported site that contains the name or serial number of a device in your ControlUp environment, or the display name or UPN of a user who uses a device in your ControlUp environment, depending on your configured device detection methods.

4. Click on the ControlUp icon on the right side of the screen to open the Enrich overlay. If you aren't already signed into ControlUp on your browser, click Log in to ControlUp.
   

5. Click on the arrow to expand the overlay and access more information and features. If multiple devices are detected on a page, then you can use the dropdown at the top of the Enrich overlay to switch between devices.
   

Troubleshooting

If you are having trouble getting Enrich to activate on a website, follow these steps:

1. Make sure the Enrich is installed and running on your browser.

2. Open the Enrich browser extension. The Sites tab shows all supported sites. The site you are currently viewing is highlighted in blue.
   

   • If the site you are viewing is not in the list, read Configure Enrich settings above to learn how to add a custom site.
   • If the site you are viewing is in the list but not highlighted in blue, make sure the site's URL is entered correctly.

3. If you have added a custom site but don't see it in the list of supported sites, check the banner at the top of the extension to see if Enrich is connected to your organization's settings.
   

   • If it is connected to your organization, go to the Sync tab and click Sync now. Note that you can adjust the Refresh interval to sync more or less frequently.
   • If it isn't connected to your organization, open app.controlup.com and sign into your organization.
   • If you have multiple organizations, make sure Enrich is connected to the correct organization. Enrich stays connected to the organization you have signed into most recently.

If you are still having issues, contact ControlUp Support.