Step 2: Connecting the extension via UEM solutions [Generic]

This page includes:

About connecting the extension via UEM solutions

This page describes Step 2 of the managed extension deployment process - Connecting the extension.

For an overview of the extension deployment process, see Deploying the extension [Managed deployment].

After you have completed Step 1 - installing the extension to the endpoints - the extensions on the endpoints must be connected to the ABS organization. This connection enables the extension to access policies [and other settings] that are defined for the organization.

The connection is made using an organization token. For details on the organization token, see Organization tokens.

For an overview of the full extension deployment process, see Deploying the extension [Managed deployment].

Extension connection process

The extension connection process varies - depending on the UEM tool that you'll be using to perform the connection, and the environment of the target devices [Windows or MacOS]. There are three options for the connection process. These three connection options are described below:

Option 1 - Connecting via Google Workspace

This option uses Google Workspace to connect the extension on Google Chrome browsers - on any operating system.

  • Connection procedure:

    1. Download the required Google Workspace .txt file that contains the organization token.

    2. Include the downloaded file in Google Workspace.

    3. Use Google Workspace to distribute the downloaded file to all target computers, and then execute the file on the target computers.

  • Sample procedure: Deployment via Google Workspace

Option 2 - Connecting on Windows systems

This option uses a Windows PowerShell file [that contains the organization token] to connect the extension.

  • This option is applicable to Google Chrome, Microsoft Edge, and Firefox [all on Windows].

  • Connection procedure:

    1. Download the Windows PowerShell (.ps1) file from the Advanced Browser Security console.

    2. Include the downloaded file in the UEM tool.

    3. Use the UEM tool to distribute the downloaded file to all target computers, and then execute the file on the target computers.

    4. For implementation details, refer to the official documentation for the UEM.

  • Sample procedure: Deployment via Microsoft Endpoint Manager [Intune]

Note: When using a PowerShell script to install the extension [Step 1] and another PowerShell script to connect the extension [Step 2], the two PowerShell scripts can be combined, and deployed as a single script. Combining the scripts will require some scripting knowledge.

Option 3 - Connecting on MacOS systems

This option uses a MacOS Shell Script file [that contains the organization token] to connect the extension.

  • This option is applicable to Google Chrome, Microsoft Edge, Safari, and Firefox [all on MacOS].

  • Connection procedure:

    1. Download the MacOS Shell Script (.sh) file.

    2. Include the downloaded file in the UEM tool.

    3. Use the UEM tool to distribute the downloaded file to all target computers, and then execute the file on the target computers.

    4. For implementation details, refer to the official documentation for the UEM.

  • Sample procedures:

What's next

You must now make sure that the extension is activated on all profiles on which the extension is installed.

For details, see Step 3: Activating the extension on endpoints.

See also: