How to Use the Browser Extension

Overview

This page explains how to install and set up the Josys Browser Extension.

Target Audience

IT administrators who are considering installing and configuring the Josys Browser Extension.

Eligible Customers

Customers currently using the Josys SaaS Management Plan or Access Management Plan.

About the Browser Extension

Please refer to the help page: About the Browser Extension.

How to Install the Browser Extension

There are two ways to deploy the browser extension to your employees:

1. Sending invitation emails to prompt employees to set up
   (You can send invitation emails from Josys to each user to prompt them to use the extension. Each employee will install the extension individually.)
2. Distributing via Silent Activation & Installation
   (The administrator deploys the extension automatically to users without requiring user action.)
   *To use this feature, tools such as MDM, Active Directory, or Google Workspace are required.

Please choose the method that best fits your organization's environment. Details for each method are described below.

1. Sending Invitation Emails to Prompt Employees to Set Up

This method requires actions from both the administrator and the employees.

Admin Steps

1. In the left sidebar of the Josys admin screen, click "Integrations > Browser Extension".
2. Once the page loads, click the "Uninvited" tab.
   
3. A list of users will be displayed. Select the users you want to enable the extension for.
   
   ▽ To send to multiple users:
   Check the boxes to the left of the user names. Then, click the "Review" button on the right side of the screen.
   
   ▽ To send to a single user:
   Click "✉ Send Email" next to the user's name. (This will take you to the confirmation screen.)
4. On the confirmation screen, verify the following details:
   ・Selected users
   ・Invitation email content
   ・Reminder email content *Reminders are sent up to 10 times on a Monday-Wednesday-Friday cycle. 
5. Click the "Send" button in the bottom right to send the invitation emails to the selected email addresses.
   ⚠️You cannot resend emails to users who are currently invited.
   

Employee Steps

1. Open the received email.
2. Follow the instructions in the email to install the extension.
   💡If the extension is hidden and not pinned after installation, please follow these steps to pin it:
3. Copy the "Verification Code" provided in the email.
4. Click the browser extension icon and enter the copied "Verification Code".
5. Once successfully activated, the status will be displayed as follows.

2. Distributing via Silent Activation & Installation

This method only requires actions from the administrator.

What is Silent Activation & Installation?

What is Silent Activation?

This is a mechanism that automatically links the installed extension with the user.
Specifically, by loading the Organization ID and email address (or user-specific unique string) into the Josys extension, the extension and the user are automatically associated.

<Example of Browser Profile (Browser Login)>

How to check your Organization ID: You can find your Organization ID by clicking your profile in the top right corner of the screen.

Activation is performed in the following order of priority:

1. The email address written in the registry (or configuration profile for Mac) and the user's email address in Josys.
2. The email address logged into the browser and the user's email address in Josys.
3. The user-specific unique string written in the registry (or configuration profile for Mac) and the user's Mapping ID in Josys.

What is Silent Installation?

This is a mechanism that automatically installs the extension to the browser without any user action.
Since the administrator configures this in bulk, users do not need to perform any manual installation steps.

Using in Incognito/Private Window

1. Access chrome://extensions/.
2.  In the detailed settings screen of the Josys extension, turn ON "Allow in Incognito".

Workflow for Silent Activation & Installation

To perform silent activation and installation, please follow these steps in order.
(Steps 1 and 2 can be done in reverse order. Step 3 must always be performed last.)

1. Register users in Josys (including email addresses and Mapping IDs (IT Device IDs)).
2. Configure registry settings (or configuration profile for Mac) for activation.
3. Configure registry settings (or configuration profile for Mac) for silent installation.

Please refer to the help page for silent activation corresponding to your management tool in the table below.
If you already have a policy to force-install (automatically install) other browser extensions, please use the same method.
Using a different method may overwrite existing settings or cause conflicts.

Frequently Asked Questions (FAQ)

• Q: Can I resend the invitation email to users who are currently invited?

  A: No, you cannot resend invitation emails to users who are currently invited. If you need to resend, please contact our support team.
  You can only resend to users who have already been activated.
  For users who are currently invited, please ask them to search their inbox for the following email:
  Subject: 【ジョーシス】ブラウザ拡張機能を設定してください (Please set up the Josys browser extension)
  • Q: The employee's browser shows "Activated" without asking for a verification code, but the status on the admin screen remains "Sent" and does not update to "Activated."

    A: This is highly likely due to old authentication data remaining in the browser. Please uninstall the extension once, and reinstall it using the link in the invitation email.