Overview
This article describes the steps to integrate apps.
Target Audience
IT Administrators
Steps
- From the Josys admin dashboard, go to "Integrations" > "App Catalog".
- 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. - Enter the required information for the integration and click Next.
- Once the integration is successful, a message saying "[App Name] has been integrated" will be displayed.
This link directs you to the help page for the respective app, which details the permissions required for integration.
Apps with SSO/MFA Login Enabled
App integrations are performed either via API or RPA.
The RPA-based integration uses the administrator's ID and password.
In this case, if SSO or MFA is enabled, the integration will fail in most cases. Therefore, you will need to temporarily disable SSO/MFA only for the administrator performing the integration.
Note that some apps, such as those listed below, can be integrated without disabling these settings:
- Apps that provide a dedicated URL to log 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 send an app owner invitation to users who are not Josys IT administrators.
Invited users will receive a Josys administrator account with permissions restricted only to the features related to that specific app.
This is useful when members of the Sales or General Affairs departments are the actual owners of an app.
Inviting an App Owner When Integrating a New App
- From the Josys admin dashboard, go to "Integrations" > "App Catalog".
- Click "Invite for App Integration" at the bottom of the screen.
- A dropdown menu to select a user will appear. Select the target user.
- Click the "Send Email" button in the bottom right. An invitation email will be sent to the selected user.
Setting Up an App Owner for an Existing App
- From the Josys admin dashboard, go to "Settings" > "User Permissions".
- Click "Register" in the top right corner.
- Select "Admin" and click "Register".
- A user selection screen will appear. Select the target user.
- Click the "Next" button in the bottom right.
- Under the "Integrated Apps" permission, select "Admin of some integrated apps".
- Click the "Select Apps" button that appears, and select the target app.
- Set permissions for other user and device features to "No Access".
- Click "Save" in the bottom right. An email will be sent to the selected user.
Steps for the Invited User
- 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. - Once logged in, the "Integrations > App Catalog" page will be displayed.
- Search for the target app using the search box. Only the assigned app will be enabled and clickable.
- Proceed with the integration by following the app integration instructions.
- On other pages, only information related to the assigned app will be visible.