Skip to main content

Deploy browser extension to managed devices

In a corporate environment, administrators may opt to streamline the roll-out of Bravura Safe browser extensions via an endpoint management system or via group policy settings by pre-loading the browser extension into an end-user browser. The approach will vary depending on operating system and web browser used.

To install Bravura Safe browser extensions on browsers within the Windows operating system, it is common to employ Windows Group Policy, utilizing an ADMX policy template to reach the designated computers under management. The exact steps for installation can vary from one browser to another.

To set up the browser extension for deployment to Google Chrome on Windows systems:

  1. Download the Chrome Enterprise Bundle for Windows and extract its contents.

  2. From the extracted folder:

    • Copy the \Configuration\admx\chrome.admx file to the C:\Windows\PolicyDefinitions directory.

    • Copy the \Configuration\admx\en-US\chrome.adml file to the C:\Windows\PolicyDefinitions\en-US directory.

  3. Launch the Windows Group Policy management console and add a new Group Policy Object for installation of the Bravura Safe browser extension.

  4. Right-click on the created GPO, click Edit... , then access Computer Configuration > Policies > Administrative Templates > Google Chrome > Extensions.

  5. On the right, click Configure the list of force-installed apps and extensions and switch the setting to Enabled.

  6. Click the Show... button and enter the following line:

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

    Confirm by clicking OK.

  7. While still within the Computer Configuration > Policies > Administrative Templates > Google Chrome section, click on Password manager.

  8. Right-click on Enable saving passwords to the password manager on the right, click Edit , change the setting to Disabled and then click OK.

  9. In the same area of Administrative Templates > Google Chrome, repeat the previous step (8) for Enable Autofill for addresses and Enable Autofill for credit cards.

  10. Apply this new GPO to the appropriate organizational units or groups.

To set up the browser extension for Microsoft Edge on Windows:

  1. Obtain and extract the Windows Policy Files for Microsoft Edge .

  2. Within the extracted directory:

    • Copy the \windows\admx\msedge.admx file into the directory: C:\Windows\PolicyDefinitions.

    • Copy the \windows\admx\en-US\msedge.adml file to the directory: C:\Windows\PolicyDefinitions\en-US.

  3. Launch the Windows Group Policy Editor and establish a new Group Policy Object (GPO) dedicated to installing the Bravura Safe browser extension.

  4. Right-click the created GPO, click Edit... , then go to: Computer Configuration > Policies > Administrative Templates > Microsoft Edge > Extensions.

  5. On the right, click Control which extensions are installed silently. Then, switch the Enabled setting to active.

  6. Click Show... and enter the details below:

    lgjgabmkhcjfpcmflkhmhjgmnnpfgmnc;https://edge.microsoft.com/extensionwebstorebase/v1/crx

    Confirm your entry by clicking OK.

  7. Continuing in Administrative Templates > Microsoft Edge , open Password manager and protection.

  8. On the right, find and right-click Enable saving passwords to the password manager, and select Edit. Then, change the setting to Disabled and click OK.

  9. Follow the same process in Step 8 for both the Enable Autofill for addresses and Enable Autofill for credit cards settings located in the Administrative Templates > Microsoft Edge section.

  10. Assign the configured GPO to the appropriate group of users or computers.

Installing Bravura Safe browser extensions on various browsers within macOS is usually done using a property list file, known as a .plist file. The exact steps for this process can differ depending on the browser being configured.

To install the Bravura Safe browser extension for Google Chrome on macOS:

  1. Get the macOS version of Google Chrome by downloading the .dmg or .pkg file.

  2. Obtain the Chrome Enterprise Bundle for Mac.

  3. Extract the Enterprise Bundle (either GoogleChromeEnterpriseBundle64.zip or GoogleChromeEnterpriseBundle32.zip).

  4. Edit the /Configuration/com.Google.Chrome.plist file using a text editor of your choice.

  5. Incorporate the following configurations into the .plist file:

    <key>ExtensionSettings</key>
     <dict>
      <key>cjidmfgdjckibjdfnglfdgohkaballnn</key>
      <dict>
       <key>installation_mode</key>
       <string>force_installed</string>
       <key>update_url</key>
       <string>https://clients2.google.com/service/update2/crx</string>
      </dict>
     </dict>

    In this snippet, cjidmfgdjckibjdfnglfdgohkaballnn refers to the ID for the Bravura Safe browser extension, while the URL https://clients2.google.com/service/update2/crx directs Chrome to fetch the specified extension from the Chrome Web Store.

    Note

    While you can also use the ExtensionInstallForcelist policy to enforce installation, the ExtensionSettings approach takes precedence over ExtensionInstallForcelist.

  6. To further enhance security, it is advised to turn off Chrome's integrated password manager by adding the following entry to the com.Google.Chrome.plist:

    <key>PasswordManagerEnabled</key>
    <false />
  7. Transform the com.Google.Chrome.plist into a configuration profile using a utility such as mcxToProfile.

  8. Distribute both the Chrome installation file ( .dmg or .pkg) and the configuration profile to all the applicable machines through your chosen software deployment or Mobile Device Management (MDM) solution.

    Tip

    For additional assistance, consult the Chrome Browser Quick Start guide for Mac provided by Google.

For the installation of the Bravura Safe browser extension on macOS with Microsoft Edge:

  1. Begin by getting the .pkg installer for Microsoft Edge for macOS.

  2. Open a Terminal application, and employ the command below to generate a property list (.plist) file for Microsoft Edge on your Desktop:

    /usr/bin/defaults write ~/Desktop/com.microsoft.Edge.plist RestoreOnStartup -int 1

  3. To convert the .plist file from a binary format to a readable plaintext format, input the following command:

    /usr/bin/plutil -convert xml1 ~/Desktop/com.microsoft.Edge.plist

  4. Edit the com.microsoft.Edge.plist file to include these settings:

    <key>ExtensionSettings</key>
     <dict>
      <key>lgjgabmkhcjfpcmflkhmhjgmnnpfgmnc</key>
      <dict>
       <key>installation_mode</key>
       <string>force_installed</string>
       <key>update_url</key>
       <string>https://edge.microsoft.com/extensionwebstorebase/v1/crx</string>
      </dict>
     </dict>

    In the above snippet, lgjgabmkhcjfpcmflkhmhjgmnnpfgmnc refers to the unique identifier for the Bravura Safe browser extension, while the specified URL https://edge.microsoft.com/extensionwebstorebase/v1/crx directs Edge to fetch the extension from the Edge Add-On Store.

    Note

    While it is possible to manage forced installations using the ExtensionInstallForceList policy, employing the ExtensionSettings method is preferred as it takes precedence.

  5. For an additional security measure, it is advised to turn off the native password manager in Edge. To accomplish this, add this setting to your com.microsoft.Edge.plist:

    <key>PasswordManagerEnabled</key>
    <false/>
  6. Convert the updated com.microsoft.Edge.plist file into a configuration profile using a tool such as mcxToProfile.

  7. Proceed with the distribution of the Edge .pkg file and the configuration profile to all controlled machines through your preferred software deployment or MDM (Mobile Device Management) system.

    Tip

    For assistance with Jamf, consult Microsoft's configuration guides for Edge policy settings on macOS using Jamf.

Installation of Bravura Safe browser extensions on Linux systems typically requires the utilization of a .json configuration file to define the necessary settings. The specific approach varies based on the browser.

To deploy the Bravura Safe browser extension for Google Chrome on a Linux system:

  1. Download the appropriate package for Google Chrome on Linux, which could be either a .deb or .rpm file.

  2. Get the Chrome Enterprise Bundle from Google's official site.

  3. Extract the contents of the downloaded Enterprise Bundle (which will be named either GoogleChromeEnterpriseBundle64.zip or GoogleChromeEnterpriseBundle32.zip) and navigate to the /Configuration directory within the extracted folder.

  4. Locate the master_preferences.json file (named initial_preferences.json in Chrome version 91 and later), create a duplicate of this file and rename the duplicate to managed_preferences.json.

  5. Edit the managed_preferences.json file by adding:

    {
      "policies:" {
      "ExtensionSettings": {
        "cjidmfgdjckibjdfnglfdgohkaballnn": {
          "installation_mode": "force_installed",
          "update_url":
             "https://clients2.google.com/service/update2/crx"
          }
        }
      }
    }

    In the above snippet, cjidmfgdjckibjdfnglfdgohkaballnn refers to the identifier for the Bravura Safe browser extension, while the URL https://clients2.google.com/service/update2/crx is used by Chrome to download the extension from the Chrome Web Store.

    Note

    Although the ExtensionInstallForcelist policy can be used for forced installations, the ExtensionSettings configuration will take priority.

  6. It is also wise to deactivate the default password manager in Chrome. To achieve this, add the following settings within the "policies": { } section of the managed_preferences.json file:

    {
      "PasswordManagerEnabled": false
    }
  7. Ensure the necessary directories are present on the system by executing these commands:

    mkdir /etc/opt/chrome/policies

    mkdir /etc/opt/chrome/policies/managed

  8. Move the managed_preferences.json file to the /etc/opt/chrome/policies/managed directory.

  9. To maintain security after deployment, modify the permissions so that only administrators can alter files in the /managed directory:

    chmod -R 755 /etc/opt/chrome/policies

  10. Using your choice of software distribution tool or MDM solution, deploy the following to the users' Linux systems:

    • The Google Chrome browser package (.deb or .rpm)

    • The managed configuration at /etc/opt/chrome/policies/managed/managed_preferences.json

    Tip

    For additional guidance, consult the Chrome Browser Quick Start for Linux documentation provided by Google.