Skip to main content

Integrating Apps

Updated
[Notice of UI Terminology Change]
With sequential updates, the term "User" in the screen has been updated to "User". If you still see the old term "User" in some parts of this help documentation, please read it as "User" accordingly. For more details on the background of this change, please check this announcement.
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 article describes the steps to integrate apps.

Target Audience

IT Administrators

Steps

  1. From the Josys admin dashboard, go to "Integrations" > "App Catalog".
  2. Select the app you want to integrate and click "+ Integrate".
    For detailed integration settings for each app, please search for the app in the App Integration List.
  3. Enter the required information for the integration and click Next.
  4. Once the integration is successful, a message saying "(App Name) has been integrated" will be displayed.
💡 When you click "+ Integrate", a link titled "How to integrate with (App Name)" will appear in the pop-up window.
This link directs you to the help page for the respective app, which contains information such as the permissions required for integration.

Apps with SSO/MFA Login Enabled

App integrations are performed either via API or RPA.
Integrations using RPA require the administrator's ID and password.
In such cases, if SSO or MFA is enabled, the integration will likely fail. Therefore, you must temporarily disable SSO/MFA for the administrator account.
However, some apps, like those listed below, can be integrated without disabling these settings:

  • Apps that provide a dedicated URL for logging in with an ID/password without using SSO.
  • Apps that allow you to generate two-factor authentication codes in advance.

Setting Up an App Owner

In Josys, you can invite users who are not Josys IT administrators to become App Owners.
Invited users will receive a Josys administrator account with permissions restricted only to the features related to that specific app.
This is useful, for example, when someone in the Sales or General Affairs department is the owner of an app.

Inviting an App Owner When Integrating a New App

  1. From the Josys admin dashboard, go to "Integrations" > "App Catalog".
  2. Click "Invite for App Integration" at the bottom of the screen.
  3. A dropdown menu to select a user will appear. Select the target user.
  4. Click the "Send Email" button in the bottom right. An email will be sent to the selected user.

Setting Up an App Owner for an Existing App

  1. From the Josys admin dashboard, go to "Settings" > "User Permissions".
  2. Click "Add" in the top right.
  3. Select "Admin" and click "Add".
  4. A screen to select a user will appear. Select the target user.
  5. Click the "Next" button in the bottom right.
  6. Under the "Integrated Apps" permission, select "Admin of Selected Apps".
  7. Click the "Select Apps" button that appears, and select the target app.
  8. Set all other permissions for users and devices to "No Access".
  9. Click "Save" in the bottom right. An email will be sent to the selected user.

Steps for the Invited User

  1. Upon receiving the email, log in to Josys using one of the following methods:
    Create a password and sign up for Josys, or sign in with Google/Microsoft.
  2. Once logged in, the "Integrations > App Catalog" page will be displayed.
  3. Search for the target app using the search box. Only the assigned app will be enabled and clickable.
  4. Proceed with the integration by following the app integration instructions.
  5. On other pages, only information related to the assigned app will be visible.

Related articles