Description
This guide will instruct you on how to install ConcealBrowse for supported browsers on macOS with a manual installation. This is a two stage process as required by macOS architecture.
Stage 1 you will install the ConcealBrowse helper application which authenticates the browser extension and provides you with telemetry in the Conceal dashboard such as the hostname and logged in username.
Stage 2 you will install the ConcealBrowse extension for each browser.
Applies to
- Google Chrome version 101+
- Microsoft Edge version 77+
- Mozilla Firefox 113.0+
- Brave browser
- Apple macOS
Stage 1: Install ConcealBrowse Helper application
With the helper installed in this way, the extension(s) will automatically authenticate and provide device information to the Conceal dashboard.
Option 1: Recommended, use a customized PKG file
- Log in to https://dashboard.conceal.io
- (Optional for multi-tenants) Choose the specific tenant
- At the top right, click DOWNLOAD EXTENSION
- If in your dashboard you do not see the text below specifying that you have a customized installer, request a customized macOS PKG from support@conceal.io which includes your tenant's information.
- Download and double click the customized macOS PKG
- Follow the installation wizard to complete the installation
Option 2: use the PKG and shell script
First, collect your tenant IDs from the dashboard
- Log in to https://dashboard.conceal.io
- (Optional for multi-tenants) Choose the specific tenant
- At the top right, click DOWNLOAD EXTENSION
- Scroll down to Company ID and Site ID
- Note these values for the next steps
Second, configure and install the PKG
- Download the generic PKG installer here: https://conceal-public-packages-prod.s3.amazonaws.com/installer/latest/ConcealInstaller.MacOS.zip
- Unzip the file
- In the unzipped folder, open install.sh in a text editor
- Replace <INSERT COMPANYID> and <INSERT SITEID> with the values collected earlier
- Save the file in the unzipped folder, replacing the existing file
- Right click the unzipped folder and choose New Terminal at this Folder
- Type sudo ./install.sh
- Enter your macOS password and press enter
- The installation results will be displayed including "The software was successfully installed." if successful!
- Done, you may close the Terminal window
Stage 2: Install ConcealBrowse Extension to each browser
- In one of the supported browsers listed above, navigate to the Conceal dashboard at https://dashboard.conceal.io
-
Upon login, in the upper right-hand corner click DOWNLOAD EXTENSION
-
Select the browser where you'd like install the extension.
-
For Chrome/Brave, and Edge this will take you directly to the web store where the extension is hosted and you can add the extension. (Image below is Google Chrome)
- For Firefox see the section below
-
You should now see the ConcealBrowse extension in your extensions list.
Firefox Steps
- Clicking Firefox in dashboard.conceal.io will download the concealbrowse.xpi file which you will load into Firefox
- Open Firefox and navigate to about:addons
- Click the gear icon to the right of Manage Your Extensions, then select Install Add-on From File...
- Select the downloaded concealbrowse.xpi file and click Open
- ConcealBrowse should now be installed for Firefox and appear in about:addons
Uninstallation Steps
- First, remove the extension from any browsers where you've installed it
- Second, uninstall the helper
- On your mac, Open Terminal.app
- Paste: sudo /Applications/ConcealBrowse.app/Contents/Resources/uninstall.sh
- Press Enter
- Enter your password to complete the uninstall