Overview
This guide explains how to integrate Confluence on Josys's App Catalog page.
Integration Specifications
| Target Plan | All |
|---|---|
| Administrator Role Required | Organization Administrator (Organization Admin role or site-admins group member) |
| Integration Method | API Key/Token |
| Integration Key | Email (or Basic Info > Confluence Account ID) |
| Capabilities | Account Discovery |
| Account Discovery | Deactivated Active Deleted |
| Statuses Excluded from Unmanaged IDs | Deleted |
| Provisioning Settings | |
| Deprovisioning Settings | |
| Subscription Info | How to Check Subscription Details |
| Discoverable Fields |
• Permissions • Status |
| License Management Data Collected | |
| Common Fields | Role Status User |
| Permission Editing | |
| Integration Target Accounts | Includes guest accounts |
Generate an API Token
Log in to the Atlassian API token management page using an Organization Administrator account and generate an API token.
Please generate an API token without scope restrictions.
Save the generated token, as it will be required to complete the integration with Josys.
For more details, refer to the official documentation.
Integrating with Josys
- From the left sidebar in Josys, click Integrations > App Catalog.
- Search for Confluence and click it.
- A setup panel will appear on the right side.
- Enter the Admin Email Address, API Token, and Admin URL, then click Next to complete the integration.
For the Admin URL, enter https://{subdomain}.atlassian.net.
Frequently Asked Questions
Q: When integrating Confluence, users are categorized as "Unmanaged IDs" instead of automatically linking with members in All Identities, even though their email addresses match. Is there a solution?
Due to Confluence specifications, the email address visibility for each user is set to private by default. In this state, Josys cannot retrieve the email address during integration, preventing automatic linking.
To enable automatic linking, please perform one of the following methods:
- Change email visibility settings individually: Users must set their email address visibility to "Anyone" in their Atlassian account profile settings.
-
Link via Confluence Account ID: Go to All Identities in Josys, select the target user, add an integration ID, and register their "Confluence Account ID".
Reference: Registering an Integration ID