Confluence

Atlassian Confluence is a collaborative content creation and sharing platform designed to facilitate teamwork and knowledge management within organizations. It allows teams to create, organize, and share documents, ideas, meeting notes, project plans, and other types of content in a centralized and easily accessible manner. Confluence provides a wiki-style interface that enables users to collaborate in real-time, edit documents simultaneously, leave comments, and provide feedback. It also offers features such as version control, permissions management, and integration with other Atlassian products like Jira, allowing for seamless project management and documentation.

The following sections explain prerequisites, resources, and instructions for integrating with SaaS Management.

Stored Confluence Information
Required Minimum Permissions for Confluence
Confluence Authentication Method
Required Confluence Credentials
Integrating Confluence With SaaS Management
Confluence License Plans and License Consumption
Confluence API Endpoints

Stored Confluence Information

The following table describes the available integration tasks and stored data within SaaS Management.

Available Integration Tasks

Information Stored

Application Roster

Unique ID
First Name
Middle Name
Last Name
Email

Application Access

Unique ID
Summary—Captures audit log events that are displayed for each user in the Users tab. Click the user’s Email link to open the Users Slideout that displays audit log events, such as but not limited to:
Space created
Global permission removed
Space configuration updated
User added to group.
Type—Examples include:
Page
Attachment
Blog post
Comment
Occurred Date

Required Minimum Permissions for Confluence

The minimum API required permissions are based on the Required Scopes for Confluence and the Required User Roles for Confluence.

Required Scopes for Confluence

Note:Consider the following:

The Confluence required scopes provide read-only access to the API endpoints. You cannot perform any write actions.
For more information on these required Confluence scopes, see the Atlassian Developer Confluence Cloud documentation topic, Confluence Scopes for OAuth 2.0 (3LO) and Forge Apps.

Scope

Description

Integration Task Name

read:content-details:confluence

Enables you to view the users for your Confluence domain.

Application Roster 

read:content-details:confluence

read:audit-log:confluence

Enables you to view the users and their access event details for your Confluence domain.

Application Roster 

Application Access 

offline_access

Enables you to generate the refresh token.

 

Required User Roles for Confluence

Note:The following SaaS application user role is not applicable to Flexera One roles.

User Role

Description

Product Admin

Required to authenticate the Confluence integration with SaaS Management and to generate the token every time the integration tasks run. The token that is generated and stored in SaaS Management contains read-only access to the API endpoints that are consumed. You cannot perform any write actions.

Confluence Authentication Method

The required authentication method is OAuth2 With Authorize Flow. For more information, see the Atlassian Developer Confluence Cloud documentation topic, OAuth 2.0 (3LO) Apps.

Required Confluence Credentials

The following credentials are required:

Username
Password
Domain—This credential is required for authentication.

Note:The username and password are required only for authorizing the application permissions. They are not stored in SaaS Management.

Confluence License Plans and License Consumption

Atlassian offers several Confluence license plans.

Free
Standard
Premium
Enterprise

For more information, see the Atlassian documentation topic, Compare plans and pricing.

Note:As the Audit Log feature is not present in the Confluence Free Subscription Plan, the SaaS Management Application Access task would fail for the account subscribed to the free subscription.

The SaaS Management integration with Confluence does not pull in any guest users. If you wish to analyze the consumption of your organization’s Confluence licenses, you may use the FSM Data Ingestion Utility. This application can pull in your organization’s Confluence licenses and display a Consumption Tab tab for your Confluence integration with SaaS Management. For more information, see Flexera SaaS Management Data Ingestion Utility.

Integrating Confluence With SaaS Management

Complete the following steps to integrate Confluence with SaaS Management.

To integrate Confluence with SaaS Management:

1. Sign in to your Confluence instance.
2. From the instance URL, note the Confluence instance domain. For example, if the instance URL is https://test.atlassian.net, then the instance domain is test.

Important:If you enter the Confluence instance URL rather than the Confluence instance domain in the SaaS Management Domain input field, the integration will fail.

3. In SaaS Management, add the Confluence application. For more information, see Adding an Application.
4. In the SaaS Management Add Application slideout:
a. From the Integration Tasks list, select the checkboxes for Application Access and Application Roster.
b. Copy and paste the Confluence instance domain into the Domain input field.
c. Click Authorize, which redirects you to the Confluence portal.
5. In the Confluence portal, sign in with the username and password that has the required minimum permission as mentioned in the Required User Roles for Confluence.
6. On the Permissions consent page, click Accept to authorize and provide access to the account for the API endpoints used in the integration.
7. If you are required to select an option from the Choose a site dropdown list, select the site having the same domain name as entered in the SaaS Management Domain input field. Then click Accept.

Confluence API Endpoints

Application Roster

https://api.atlassian.com/ex/confluence/<<CloudId>>/wiki/rest/api/search/user

 

https://api.atlassian.com/oauth/token/accessible-resources

Application Access

https://api.atlassian.com/ex/confluence/<<CloudId>>/wiki/rest/api/search/user

 

https://api.atlassian.com/oauth/token/accessible-resources

 

https://api.atlassian.com/ex/confluence/<<CloudId>>/wiki/rest/api/audit

 

https://api.atlassian.com/ex/confluence/<<CloudId>>/wiki/rest/api/content/search