Integrate Your App Using the Integration Builder

Overview

This page describes the function that allows you to create an application integration in Josys and connect applications other than those officially supported as "Integrated Apps."

Target Audience

• Josys IT Administrators.
• Customers who currently create custom applications and manually manage app information.

What You Can Do

Josys currently has a set of applications that can be officially integrated ("Integrated Apps") and those that cannot. Official integration requires the third-party application to expose an API, which is not available for all applications. Unlisted applications are often managed manually as "Tracked Apps."

However, if your application meets the conditions below, you may be able to automatically retrieve information, similar to an "Integrated App," even if it is not officially supported.

Conditions for Successful Integration:

• The application does not use Two-Factor Authentication (2FA) or IP Address Restrictions and only requires an ID and password for login.
• The application does not display pop-up guides after logging in.
• The application has a page where a list of users can be viewed.

Usage Requirements

• Setup is only supported on Google Chrome.
• The Josys Browser Extension must be installed.
  Reference: About the Browser Extension

Application Integration Setup

1. Pre-Configuration

1. Access chrome://extensions/.
2. Navigate to the details settings page for the Josys extension.
3. Turn ON the option "Allow in Incognito" (or "Allow to run in private/secret mode").

2. Creating the App Integration

1. In the Josys left-side menu, click "Integrations" > "App Catalog".
2. Scroll to the bottom and click "Add New App."
3. A window will open on the right side.
4. If this is your first time creating an app integration, agreement is required. Click "Agree" on the top right.
5. A pop-up will appear; click "Agree" again.
6. Enter the app details: input the App Name and the App URL. (Please enter the URL of the application's login screen for the App Login URL.)
7. Click "Review App."
8. The required setup steps will be displayed. Click the "Build Integration" button on the bottom right.

3. Configuring the App Integration

A new window will open with the URL you just entered.

A. Log in to the App

1. On the login screen, a guide will appear on the bottom right.
2. Click "Let's Go" displayed to the right of "Log in with Credentials."
3. The guide will disappear. Proceed to log in to the application.
4. After logging in, wait until the guide reappears on the bottom right.
5. Once the guide is displayed and the login is complete, click the "Complete" button.

B. Set Up the App User List

1. Click "Let's Go" displayed to the right of "Navigate to App User List."
2. Open the application's account list page (the list of users who can log into the app itself).
3. Once the user list page is open, click the "Complete" button.
4. When "App User Details" appears in the guide, click it, and click the "Let's Go" button displayed to the right of  "Capture App User List".
5. When the guide "Select 3 Email IDs" appears on the bottom right, click the field that indicates the user's email address in three locations on the user list screen.
   Example: If there is a column named "EMAIL ADDRESS," click three email addresses in that column.
6. Set up the following fields similarly: User Names, Roles, License info, Last Used, Statuses, and MFAs. For any item where the corresponding column is not available, click "Skip".
   MFA: Select the column that indicates whether MFA is enabled or not, if available.
7. Next, register whether Pagination/Scrolling is required.
8. Select "Yes" if all users are not displayed unless you scroll down or move to the next page. Select the Pagination/Scroll Type.
9. Record the pagination. Click "Let's Go".
   Even if the account count is low and the "Next" button is not clickable, click "Next" and/or "Previous" and then confirm the completion.
10. Once completed, click "Validate Data".
11. Once completed, click "Take me back to Josys". The opened window will close.

4. Confirming Data in Josys

1. Once back on the Josys screen, click "Review Data and Add App" on the bottom right.
2. When the app integration build is complete, click "Add App" on the bottom right.

Frequently Asked Questions (FAQ)

Q: The guide on the bottom right does not appear.
A: Please check the extension settings. Access chrome://extensions/ and turn ON the option "Allow in Incognito" in the details settings screen for the Josys extension.

Q: An error occurred midway through the process.
A: Errors will occur in the following situations, so please start over from the beginning:

1. If you reloaded the page while creating the integration.
2. Furthermore, integration cannot be created in the following cases:
3. If SSO login or Two-Factor Authentication (2FA) is configured.
4. If IP address restrictions are in place.
5. If guides are displayed on the target application screen.