Remote activation of Josys Browser Extension using Google Admin Console

This article provides a comprehensive guide on how to activate the Josys browser extension on any browser (Google Chrome/Microsoft Edge) and validate the activation using Google Admin Console.

The deployment includes the following two steps:

1. Pushing the browser extension

2. Activating and validating the browser extension on your browser

1. Pushing the browser extension

Step 1: Log in to Google Admin Console using an admin account. Navigate to Devices and select Chrome. Click on Apps & Extensions and select Users & Browsers.

Step 2: Select your organization unit and click the Plus icon on the right. Select the Chrome icon.

Step 3: Enter the Josys browser extension ID (moaklgcgokbgplldonjkoochhlefkbjf) and press Enter. Click Select.

Step 4: Click Select to select the Josys browser extension.

Step 5: Click Allow Install.

Step 6: Select an Installation Policy according to your requirements and other permissions:

• Force install: Silently installs the extension on the end user's Chrome profile.
• Force install + pin to browser toolbar:  Silently install the extension and pin it to the toolbar. This method is preferred by the IT Admin.

Step 7: After selecting the Installation Policy, scroll down to locate the Policy for extensions section. Here, you have to enter the JSON code to initiate the activation. 

You can activate the browser extension in three different ways:

• Using Chrome/Edge user's profile
• Using Device Identity
• Using end-user's email ID

For each of the activation methods, the organization key is mandatory. Refer to section 1 of the Remote activation of Josys Browser Extension to learn how to locate your organization key. 

a) Activating using Chrome/Edge user's profile

When you choose this option, then provide only the organization key. The user's profile is fetched from the browser. In the Policy for extensions section, enter the following JSON value. Replace the "org_key" with your organization key. 

{
  "OrganizationKey": {
    "Value": "org_key"
  }
}

For example, if "abccompany" is your organization key, enter the following JSON:

{

  "OrganizationKey": {

    "Value": "abccompany"

  }

}

b) Activating using the Device Identity

Note: Prior to activation through the Device Identity, it is mandatory to first upload Device Identity to Josys using the bulk CSV upload.

To activate the browser extension using the device identity, enter the following JSON value under the Policy for extensions section. Replace the "org_key" with your organization key and "DeviceIdentity" with the device identity. You can fetch the device identity from User Profile>>Open any user's profile>>Identities tab.

{
  "OrganizationKey": {
    "Value": "org_key"
  },
"DeviceIdentity" {
"Value": "DeviceIdentity"
}
}

For example, if "abccompany" is your organization key and "device123" is the device identity, then enter the following JSON:

{

  "OrganizationKey": 

{

    "Value": "abccompany"

  },

   "DeviceIdentity":

{

    "Value": "device123"

  }

}

The following values can be used as a Device Identity:

Note: Josys recommends using username and user SID's as a unique identifier.

c) Activating using the end-user's email id

To activate the browser extension using the end-user's email id, enter the following JSON value under the Policy for extensions section. Replace the "org_key" with your organization key and the "[email protected]" with the user email id. You can fetch the user email id from User Profile>>Open any user's profile>>Email.

{
  "OrganizationKey": {
    "Value": "org_key"
  },
"UserEmail" {
"Value": "[email protected]"
}
}

For example, if "abccompany" is your organization key, and "[email protected]" is the user email id, then enter the following JSON:

{

  "OrganizationKey": 

{

    "Value": "abccompany"

  },

   "UserEmail":

{

     "Value": "[email protected]"

  }

}

Step 8: Save the changes.

2. Validating browser extension activation

After activating the browser extension, follow these steps to validate that the activation is successful.

Step 1: Log in to Google Chrome or Microsoft Edge on your targeted device using an admin account.

Step 2: Open your browser, type <browsername>://extensions into your browser URL and press Enter. 

For example, for Google Chrome, type "chrome://extensions" or, enter <browsername>://extensions (for for Microsoft Edge) in the URL bar and press Enter.

Step 3 Verify if the extension is listed in the extension list.

By following the above-mentioned steps, you can deploy, activate, and validate the Josys browser extension on your organizatios's Google Chrome/Microsoft Edge browsers.