Install the Chrome browser extension

The Blue Prism Chrome browser extension establishes connectivity with Blue Prism, allowing Blue Prism to interact with Chrome applications and web pages so data can be exchanged and elements manipulated.

The Blue Prism browser extensions should be installed on any machine that will be used to automate Chrome.

For details of browser extension and Blue Prism versions, see browser extension compatibility.

Prerequisites

The following are required:

  • Access to the Chrome web store for online installations
  • Extension package for offline installations
  • The ability to configure Chrome add-ons

Install the Chrome browser extension using the Blue Prism installer

The Blue Prism installer applies a registry key that installs the Blue Prism extension the next time the browser is started. The installer can be run using the graphical user interface or from the command line.

Run the Blue Prism installer

Using the advanced installation option, you can determine which browser extensions (and other optional features) are installed.

  1. Run the appropriate Blue Prism installer for your system – 32-bit or 64-bit.
  2. Select Advanced install from the Install location page of the install wizard.
  3. Click Next and select the Chrome browser extension and any other features you want to install.

  4. Click Install and complete the installation.

During an upgrade, the settings already applied for the current installation are maintained unless edited in the advanced install options.

Use the command line

The following command line options are available for installing Blue Prism and setting the registry key for the Chrome extension. The example commands are for the 6.9 version of Blue Prism – update the version number as required.

Command

Description

msiexec /i BluePrism6.9.0_x64 /qn

msiexec /i BluePrism6.9.0_x86 /qn

Installs Blue Prism and sets Chrome extension registry key as well as those for Edge and Firefox.

msiexec /i BluePrism6.9.0_x64 ADDLOCAL=BluePrism,BPServer /qn

msiexec /i BluePrism6.9.0_x86 ADDLOCAL=BluePrism,BPServer /qn

Installs Blue Prism without setting the browser extension registry keys.

msiexec /i BluePrism6.9.0_x64 ADDLOCAL=ChromePlugin /qn

msiexec /i BluePrism6.9.0_x86 ADDLOCAL=ChromePlugin /qn

Adds the Chrome extension registry key to an existing installation of Blue Prism.

The ADDLOCAL property can also be used to install multiple Blue Prism components by separating them with a comma. The following command installs 64-bit versions of Blue Prism, and the Chrome, Edge, and Firefox extensions:

msiexec /i BluePrism6.9.0_x64 ADDLOCAL=BluePrism,BPServer,ChromePlugin,EdgePlugin,FirefoxPlugin /qn

The BluePrism and BPServer components must both be specified to install or upgrade Blue Prism when using the ADDLOCAL parameters. They cannot be used in isolation.

Install the Chrome browser extension from the web store

The Blue Prism Chrome extension can be installed via the Chrome web store using the appropriate URL for your version of Blue Prism:

Blue Prism version: 6.9 – compatible extension: 2.2.0

https://chrome.google.com/webstore/detail/blue-prism-69-browser-ext/apjdloapfacpgloidbikcdcigljkgogg

Blue Prism version: 6.5 to 6.8 – compatible extension version: 2.1.0

https://chrome.google.com/webstore/detail/blue-prism-browser-extens/nadpbbdaaifbaebnniobcfpiifbfokij

Blue Prism version: 6.3 and 6.4 – compatible extension version: 1.0.6.3

https://chrome.google.com/webstore/detail/blue-prism-browser-extens/oaflhlmnamdgbgdgakpihkkdfapkebfp

To install the browser extension for Chrome:

  1. Open Chrome.
  2. Paste the URL for the required version into the address bar of the browser.

  3. Click Add to Chrome and confirm the installation when prompted.

A notification displays when installation is complete and the Blue Prism extension icon is added to the browser toolbar.

Install the Chrome browser extension using an offline package

If the browser extension has already been installed, updated extensions that are made available after a Blue Prism release are automatically updated when the browser is loaded if there is an active internet connection. For devices that are not connected to the internet, the Blue Prism Chrome extension can be installed offline using an independent package. The extension will need to be installed separately for each user on each device that needs to use the extension.

To install the browser extension for Chrome:

  1. Download the required extension package from the web store, see URL for applicable Blue Prism version above.
  2. Create a ZIP file of the downloaded extension.

    Extensions are stored in the folder C:\Users\'Username'\Appdata\Local\'extension-path', for example for Blue Prism 6.9: C:\Users\'Username'\Appdata\Local\Google\Chrome\User Data\Default\Extensions\apjdloapfacpgloidbikcdcigljkgogg

    Select all files in the 6.9.0.0_0 folder and add them to a ZIP file.

  3. Open Chrome.
  4. Click the menu (three dots) icon and select More Tools > Extensions.
    chrome://extensions displays with the existing extensions.
  5. If you have installed Blue Prism using the installer, you will see a Blue Prism extension on this page. This is a managed extension (indicated with the managed icon), as such, you can not remove or turn off the extension from this page.

  6. Switch the page into Developer mode using the slider.
  7. In Windows Explorer, navigate to the extension ZIP file then drag and drop it into the Chrome Developer page.
    The extension installs and displays on the page.
  8. Switch the page back into standard mode using the Developer mode slider.

Ensure you turn off Developer mode after installing the extension. Leaving your browser in Developer mode can be a security risk.

Chrome browser extension registry keys

The following registry key is applied when installing the browser extension with the Blue Prism installer to instruct the browser to add the Blue Prism extension.

For situations where the browser extension is to be installed independently or, where the registry value applied by the installer is prevented from persisting, such as if network restrictions override them, the setting can be applied using an alternative deployment method, such as Group Policy or Local Security Policy.

Registry Key

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist

Name

1

Type

REG_SZ

Data

apjdloapfacpgloidbikcdcigljkgogg;https://clients2.google.com/service/update2/crx

Remove the Chrome Blue Prism extension

Remove using browser options

Select Remove from Chrome from the extension options.

Remove using the Blue Prism installer

Run the Blue Prism installer and on the Advanced Install page, select Change features and deselect the Chrome extension.

The registry key is deleted and the extension is removed. Alternatively, delete the registry key manually using a registry editor.

Remove using Local Security Policy or Group Policy

To uninstall the Blue Prism Chrome extension, remove the value from the specified registry key or delete the entire key if none of the associated settings are required.