What is App Integration?
The Integrated Apps feature allows Jodoo to act as an Identity Provider (IdP), issuing identity credentials to third-party systems. This enables users to achieve single sign-on (SSO) from Jodoo into external systems with a single click, eliminating the need to re-enter credentials.
In simple terms:
The user logs in to Jodoo
The user clicks Enter App
Jodoo tells the external system who the user is
The external system trusts that identity and signs the user in automatically
So the experience feels like one-click access, but behind the scenes there is still a verification process.
Applicable Scenarios
Integrating BI tools like Tableau or Metabase into Jodoo for password-free viewing of reports and dashboards.
Connecting enterprise self-built systems (e.g., HR, ERP, CRM) to Jodoo to establish a unified access portal.
Embedding external system pages within Jodoo dashboards or forms for seamless page-level access.
Prerequisites
Before configuring an Integrated App, ensure the following conditions are met.
Jodoo Requirements
Permissions: Only business owners and super admins can configure Integrated Apps.
Plan: The Enterprise (or higher) plan of Jodoo is required. If the version is downgraded, existing configurations are retained, but the feature becomes inactive.
Third-Party System Requirements
The third-party system must be configured with HTTPS.
The third-party system must have configured Trusted Domains.
The third-party system must support receiving user identity information via URL parameters or the OAuth protocol.
How to Integrate an App?
Step 1 Accessing the feature
There are two primary entry points for managing Integrated Apps:
1. Via Product Center
Used for creating and managing Integrated Apps.
Navigate to Management > Product Center. Here, you can view existing apps and click "+ Integrate more apps" to create new ones.
2. Via SSO Settings
Navigate to Management > Business Settings > Single Sign-On. Under the "using this system's account" section, click "Go to configure" to jump to the Product Center.
Step 2 Filling out the configuration dialog
Fill out the configuration dialog:
Configuration Item | Description | Required |
App Name | Custom name for the Integrated App. | Yes |
App Description | Brief explanation of the app's purpose. | Yes |
App Icon | Icon displayed in the Product Center. | No |
Trusted Domain | Domains allowed to be embedded in Jodoo. | Yes |
Suite ID | Automatically generated unique identifier for the app. Used by the third-party system. | Auto |
Suite Secret | Automatically generated secret key used to call Jodoo APIs to exchange for user info. | Auto |
App Homepage | The URL of the external system's homepage. | No |
Note:
Each enterprise can create a maximum of 50 Integrated Apps.
The role of Suite ID and Suite Secret
The Suite ID and Suite Secret are the core credentials generated automatically upon creation.
Suite ID: Acts as the "account" identifier for the app.
Suite Secret: Acts as the "password" used by the server to verify identity when calling Jodoo APIs.
You can view these by clicking "Edit" on a created app. The Suite Secret can be copied, viewed in plaintext, or reset.
Warning: Resetting the Suite Secret immediately invalidates existing SSO connections until they are updated with the new secret.