Skip to main content

How to Silently Install and Activate the Browser Extension on macOS Devices Using Jamf (1/2)

Updated
Note: The screenshots in this article are currently taken from the Japanese version of the product. Some labels in the images may differ from the English interface.

Overview

This page provides a detailed guide on how to silently install and activate the Josys browser extension on macOS devices using Jamf.

Target Audience

Administrators planning and executing the bulk deployment of the Josys browser extension.

About the Browser Extension

Please refer to the following pages first for information regarding the browser extension.

  1. About the Browser Extension
  2. How to Use the Browser Extension

Silent Activation Steps

Simply installing the browser extension is not enough to start detecting SaaS usage. Activation requires passing information such as the "Josys Organization ID" and the "email address of the user registered in Josys" to the extension. This allows the extension to recognize "which employee in which organization is using the SaaS/application" and begin detection.

1. Prerequisites

1-1. Verify your Organization ID.

Log in to Josys and click the icon in the top right corner to verify your Organization ID.

1-2. Verify how user information is managed in Jamf Pro.

  1. Log in to Jamf Pro and open "Computers".
  2. Click "Search Inventory".
  3. Click "Search" in the top right corner.
  4. Select and click any of the displayed devices.
  5. Click "User and Location" in the left sidebar.
  6. Check if the "Username" and "Email Address" fields are populated in the list on the right.
  7. Check a few other devices in the same way.

If only one of these fields is populated, it will affect the script used later.

2. Deploying the Activation Settings

💡 This configuration must be set up for each browser (Microsoft Edge/Google Chrome).
  1. Go to "Computers" > "Configuration Profiles".
  2. Click "+ New" in the top right corner.
  3. Verify that the "General" tab of the "New macOS Configuration Profile" screen is open, and enter the following details:
    Name: (e.g., Josys Extension Config)
    Description: (Optional)
  4. Once entered, go to "Application & Custom Settings" > "Upload" from the menu, and click "+ Add".
  5. A form will appear. Enter the following in the "Preference Domain" field.
    • For Google Chrome: com.google.Chrome.extensions.moaklgcgokbgplldonjkoochhlefkbjf
    • For Microsoft Edge: com.microsoft.Edge.extensions.hjifncajikcdkhlofdjjlhcjoennmdfc
  6. For the "Property List", please update the script below before using it.

    ▽ Parts to Update
    Replace "Enter Organization ID" with the Organization ID you verified in Josys.
    If the "Email Address" field was empty in Jamf Pro, change "UserEmail" to "UserName".
    If the "Email Address" field was empty in Jamf Pro, change "$EMAIL" to "$USERNAME". 
    ​​​​<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>OrganizationKey</key>
        <string>Enter Organization ID</string>
        <key>UserEmail</key>
        <string>$EMAIL</string>
    </dict>
</plist>

  7. Once entered, click "Scope".
  8. When the Scope tab opens, click "Add".
  9. Click "Computer Groups".
  10. Find the target group for deployment and click "Add" on the far right.
    We recommend testing with a test group first.
  11. Once selected, click "Done" in the top right corner.

  12. Click "Save" in the bottom right corner.

This completes the silent activation setup. Next, proceed to the silent installation.

⏭️How to Silently Install and Activate the Browser Extension on macOS Devices Using Jamf (2/2)

Related articles