Deploy the Workspace browser extension in Google Chrome or Edge using GPOs

Important note for Workspace browser extension versions prior to 2021.2.3.0.

The settings deployed with the group policy object (GPO) are only enforced when the extension is used for the first time. This means that the settings will not be enforced and changed if you modify the settings in the GPO and the extension has already been used by a user at least once.

Configuring extensions by policy on Windows 10/11 for Chrome or Edge

  1. Open Group Policy Management (Start – Run – GPMC.msc).

  2. Right-click on the GPO list and select New.

  3. In the New GPO window, create your new object then click on OK.

  4. Right-click on your new GPO and select Edit.

  5. Select Registry located in Computer Configuration – Preferences – Windows Settings – Registry or User Configuration – Preferences – Windows Settings – Registry according to your needs.

  6. Right-click in the Registry items list and select New – Registry Item.

  7. Set the Action parameter to Replace to modify the existing rule or to create it if it does not exist.

  8. Set the Hive parameter to HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER according to your needs.

  9. Enter SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\neimonjjffhehnojilepgfejkneaidmo\policy in the Key Path text field.

    Enter \SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\ddloeodolhdfbohkokiflfbacbfpjahp\policy in the Key Path text field if you are using Microsoft Edge.

  10. Enter Settings in the Value name text field.

  11. Select REG_SZ in the Value type drop-down list.

  12. Write the JSON settings string in the Value data text field. See the Values section below for an example.

  13. Click on OK.

    KB8106

  14. In Group Policy Management, configure the GPO Links and Security Filtering according to your needs.

Example

  • Activate Devolutions Server
  • Set https://localhost/mydvlsurl as Devolutions Server URL.
  • Disable the settings page.
  • Always override the settings in the settings section when the extension starts.
{
  "settings": {
    "dvlsActivated": true,
    "dvlsUrl": "https://localhost/mydvlsurl"
  },
  "adminSettings": {
    "disableSettingsPage": true,
    "setGPOSettings": "AlwaysOverride"
  }
}

Default settings

All attributes can have their value changed or their key removed.

{
  "settings": {
    "activateBeta": false,
    "autoFillEntryOnLoad": false,
    "autoRetrieveCredentials": true,
    "autoSubmitFormOnFill": false,
    "autofillBasicAuthentication": false,
    "destinationGroup": "Workspace browser extension",
    "disableAnalytics": false,
    "dvlsActivated": false,
    "dvlsAutoFillEntryOnLoad": false,
    "dvlsAutoRetrieveCredentials": true,
    "dvlsAutoSubmitFormOnFill": false,
    "dvlsAutofillBasicAuthentication": false,
    "dvlsDestinationFolder": "Workspace browser extension",
    "dvlsMatchDetectionType": 2,
    "dvlsShouldIncludePrivate": true,
    "dvlsShowFavicon": false,
    "dvlsSyncAllAvailableVaults": false,
    "dvlsUrl": "",
    "enableContextMenu": true,
    "enableNativeMessaging": false,
    "filledFieldsColor": "#b3d9ff",
    "hubActivated": false,
    "hubAutoFillEntryOnLoad": false,
    "hubAutoSubmitFormOnFill": false,
    "hubAutofillBasicAuthentication": false,
    "hubDefaultLoginUsername": "",
    "hubMatchDetectionType": 2,
    "hubPersonalActivated": false,
    "hubPersonalAutoFillEntryOnLoad": false,
    "hubPersonalAutoSubmitFormOnFill": false,
    "hubPersonalDefaultLoginUsername": "",
    "hubPersonalLucidUrl": "https://login.devolutions.com",
    "hubPersonalMatchDetectionType": 2,
    "hubPersonalServerUrl": "https://hub-server.devolutions.com",
    "hubPersonalShowFavicon": true,
    "hubShouldIncludePrivate": true,
    "hubShowFavicon": true,
    "hubSyncAllAvailableVaults": false,
    "hubUrl": "",
    "lucidUrl": "https://login.devolutions.com",
    "rdmActivated": false,
    "rdmApplicationCode": "",
    "rdmAutoFillEntryOnLoad": false,
    "rdmAutoRetrieveCredentials": true,
    "rdmAutoSubmitFormOnFill": false,
    "rdmAutofillBasicAuthentication": false,
    "rdmDefaultDestinationVaultIsPrivate": true,
    "rdmDefaultPortUsage": true,
    "rdmDestinationFolder": "Workspace browser extension",
    "rdmEnableNativeMessaging": false,
    "rdmPort": 19443,
    "rdmShowFavicon": false,
    "rdmUseLegacyApi": false,
    "shouldColorFilledFields": false,
    "showIconInFields": true,
    "showSaveSiteDialog": true,
    "theme": 0,
    "useLegacyApi": false
  }
}

Default admin Settings

All attributes can have their value changed or their key removed. If this section is added in the JSON string, a comma needs to be added at the end of the settings section above. See the sample in the Example section about it.

{
  "adminSettings": {
    "disableSettingsPage": false,
    "setGPOSettings": "OnInstall"
  }
}

Values

disableSettingsPage

Hide the settings button and disable the settings page in the Workspace browser extension for the end-user. Possible values:

  • True
  • False (Default)

setGPOSettings

Set when the GPO settings are used. Possible values:

  • OnInstall (default): Set the value the GPO settings when the extension is installed.
  • AlwaysOverride: Always override the value from the GPO settings when the extension is started.
  • AlwaysUseDefaultAndOverride: Use the default settings for all settings not in the GPO and override the values from the GPO when the extension is started.

Configuring the Workspace browser extension to be automatically pinned on the Google Chrome toolbar

  1. Create a new GPO rule to have the Workspace browser extension automatically pinned on the Chrome toolbar.
  2. Select Registry located in Computer Configuration – Preferences – Windows Settings – Registry or User Configuration – Preferences – Windows Settings – Registry according to your needs.
  3. In the registry properties, set the Action parameter to Replace to change the existing rule or to create it if it does not exist.
  4. Set the Hive parameter to HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER according to your needs.
  5. Enter ExtensionSettings in the Value name text field.
  6. Select REG_SZ in the Value type drop-down list.
  7. Enter the following JSON settings string in the Value data text field:
    {
      "neimonjjffhehnojilepgfejkneaidmo": {
        "installation_mode": "force_installed",
        "update_url": "https<area>://clients2.google.com/service/update2/crx",
        "toolbar_pin": "force_pinned"
      }
    }
    
  8. Click on OK and update the GPO rules on your local machine.
    KB8105

References