Confluence

Confluence is a web-based collaboration platform created by Atlassian.

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