Overview

Torii integrates with your Confluence account and syncs the users' data: ID, email, first name, last name, status, license status, and role.

Note that Torii can sync multiple Confluence accounts.

Prerequisites

Account owners and global admins can generate credentials required for the integration.

Optional: To sync user roles from Confluence, you will also need to provide the following Atlassian details:

• Atlassian API Key
• Atlassian Organization ID

These fields are not mandatory for the Confluence integration itself, but are required if you wish to sync user roles. For instructions on how to obtain these details, please refer to the Atlassian Integration article .

Connect Confluence Cloud integration to Torii

When connecting the Confluence integration, you will be asked to choose an Authentication Method. Torii supports two authentication methods:

• User Basic Auth – authentication using a user API token
• Service Account – authentication using an Atlassian service account (recommended)

Follow the relevant steps below based on the authentication method you select.

User Basic Auth

1. Go to the Integrations page and select the Confluence tile.
2. Click Connect.
3. Enter your Confluence Organization URL from the address bar.

   • 

4. In Group Name, select the group with all your Confluence users.

   • 

5. In the Email Address field, enter the email address associated with your Atlassian account.
6. Create and enter an API Token :
   • Go to https://id.atlassian.com/manage/api-tokens
   • Click Create API token
   • Enter "Torii" as the label and click Create
   • Copy and save the generated token
7. (Optional) Enter your Atlassian API Key and Atlassian Organization ID if you want to sync user roles.
8. Click Connect.

Service Account Authentication

Service Account authentication allows Torii to connect to Confluence without relying on a specific user. This method is recommended for long-term stability.

Create a Service Account in Atlassian

1. Log in to your Atlassian organization.
2. From the main menu, select Directory → Service accounts.
3. Click Create a service account.
4. Enter a name and click Next.
5. Select Confluence and assign the User role.
6. Click Create.

Create OAuth 2.0 credentials

1. In the service account page, click Create credentials.
2. Select OAuth 2.0 and click Next.
3. Enter a name and click Next.
4. Select the required scopes:
   • read:confluence-groups - Used to retrieve users' data.
5. Click Next.
6. Click Create.
7. Copy the generated Client ID and Client Secret.

Retrieve your Cloud ID
Follow Atlassian’s official guide to retrieve your Confluence Cloud ID: Retrieve my Atlassian site Cloud ID .

Connect the integration

1. Go to the Integrations page and select the Confluence tile.
2. Choose Service Account as the Authentication Method.
3. Provide your Client ID, Client Secret, and Cloud ID.
4. (Optional) Provide the Atlassian API Key and Atlassian Organization ID to sync user roles.
5. Click Connect.

Once the integration is connected and synced, it will display a green checkbox.