Description

This guide outlines usage and troubleshooting for the ConcealBrowse MSI installer. Using the MSI for deployment results in automatic device registration to the conceal.io platform.

Getting Started

Download the latest release of the MSI from the ConcealBrowse MSI Installer article, you can also find it in the Attachments section toward the bottom of this article.

Usage

The MSI can either be ran as a stand alone UI application, or it can be executed using management tools such asmsiexec.

When executing via the UI the only configuration options available is to set the SITEID and COMPANYID. If those values are not configured then the installer will output an error COMPANYID and SITEID must be set.

When executing via the command-line there are several more potential flags that can be configured. The exhaustive list is as follows

• COMPANYID - (REQUIRED) The company UUID to register the extension with

• SITEID - (REQUIRED) The site UUID to register the extension with

• OVERRIDE_UPDATE_URL - Specifies where Chrome should download the ConcealBrowse extension. Defaults to https://clients2.google.com/service/update2/crx

• INSTALLATION_MODE - Controls if and how extensions that you specify are added to Chrome Browser. You can set the installation mode to:

  • force_installed - (Suggested) Automatically install the extension without user interaction. Users can't remove it 
  • normal_installed - (Default) Automatically install the extension without user interaction. Users can disable it

• TOOLBAR_PIN - Controls if the extension icon is pinned to the toolbar. You can set the value to:

  • force_pinned - (Default - Suggested)The extension icon is pinned to the toolbar and visible at all times. The user can't hide it in the extension menu.
  • default_unpinned - The extension starts hidden in the extension menu, and the user can pin it to the toolbar.

• ADDLOCAL - Optionally controls which features will be installed

  • Base - (REQUIRED) installs the base files required by the extension
  • Chrome - installs Conceal Browse for Chrome
  • Edge - installs Conceal Browse for Edge
  • Brave - installs Conceal Browse for Brave

• REMOVE - Optionally removes a feature that has been installed

  • Chrome - removes Conceal Browse from Chrome
  • Edge - removes Conceal Browse from Edge
  • Brave - removes Conceal Browse from Brave
  • ALL - removes Conceal Browse from all browsers and deletes installation files

Example msiexec usage

The installation can be executed using msiexec with the following arguments:

• Basic installation

  msiexec /i ConcealInstaller.Windowsx64.msi COMPANYID="<YOUR COMPANY ID>" SITEID="<YOUR SITE ID>"

• Custom installation

  msiexec /i ConcealInstaller.Windowsx64.msi COMPANYID="<YOUR COMPANY ID>" SITEID="<YOUR SITE ID>" OVERRIDE_UPDATE_URL="<YOUR UPDATE URL>" INSTALLATION_MODE="<INSTALLATION MODE OPTION>" TOOLBAR_PIN="<TOOLBAR PIN OPTION>"

• Install silently without the UI (must be run in an administrative context)

  msiexec /i ConcealInstaller.Windowsx64.msi COMPANYID="<YOUR COMPANY ID>" SITEID="<YOUR SITE ID>" /qn

Modifying the extension

The extension can be modified using msiexec

Example setting the toolbar pinned state to default_unpinned

msiexec /i ConcealInstaller.Windowsx64.msi TOOLBAR_PIN="default_unpinned" REINSTALL=ALL REINSTALLMODE=omus /L*v "C:\Windows\Temp\ConcealHelper-modify.log"

Removing the extension

The extension can be removed either by uninstalling the ConcealHelper application via the Programs and Features menu and selecting Uninstall, or by using msiexec

msiexec /x ConcealInstaller.Windowsx64.msi /L*v "C:\Windows\Temp\ConcealHelper-uninstall.log"
msiexec /i ConcealInstaller.Windowsx64.msi REMOVE=ALL /L*v "C:\Windows\Temp\ConcealHelper-uninstall.log"

If you would like to only remove specific features you can achieve this with msiexec

msiexec /i ConcealInstaller.Windowsx64.msi REMOVE=Brave /L*v "C:\Windows\Temp\ConcealHelper-uninstall.log"

Output

Upon successful installation the following registry keys and files should be created. Upon successful removal the keys and files should all be deleted.

Files

• C:\ProgramData\Conceal\conceal-helper\conceal-helper.conf
• C:\ProgramData\Conceal\conceal-helper\conceal-helper.exe
• C:\ProgramData\Conceal\conceal-helper\conceal-helper-manifest.json

Registry keys Chrome

• HKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\io.conceal.helper
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\installation_mode
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\toolbar_pin
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\update_url

Registry keys Edge

• HKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\io.conceal.helper
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\installation_mode
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\toolbar_state
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\update_url
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\override_update_url

Registry keys Brave

• HKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\io.conceal.helper
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\BraveSoftware\Brave\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\installation_mode
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\BraveSoftware\Brave\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\toolbar_pin
• HKEY_LOCAL_MACHINE\SOFTWARE\Policies\BraveSoftware\Brave\ExtensionSettings\jmdpihfpelphmllgmamebdbelmobjfpg\update_url

Troubleshooting

If you are experiencing difficulties with the installer try enabling logging to see the full installation output

• Log the install process

  msiexec /i ConcealInstaller.Windowsx64.msi COMPANYID="<YOUR COMPANY ID>" SITEID="<YOUR SITE ID>" /L*v "C:\Windows\Temp\ConcealHelper-install.log"

• Log the uninstall process

  msiexec /x ConcealInstaller.Windowsx64.msi /L*v "C:\Windows\Temp\ConcealHelper-uninstall.log"

*Never hesitate to contact your Customer Success Manager for any questions or concerns. You may also open a support ticket at support.conceal.io by scrolling to the bottom and clicking Submit a request.