All pages
Powered by GitBook
1 of 4

Loading...

Loading...

Loading...

Loading...

Required permissions

Required permissions for integrating Confluence with Xopero ONE and protecting its resources.

Protecting Confluence in Xopero ONE requires a set of Atlassian permissions that allow secure authorization and read access to Confluence content, while also enabling the backup application to enumerate and retrieve site resources.


The following list describes the permissions your Atlassian account used for integration with Xopero ONE must have for Xopero ONE to access, download, and back up all spaces and related resources in the selected Confluence instance.

The Atlassian account must have the app admin and user access admin permissions.

The Atlassian account must have admin permissions to all Confluence spaces that are included in the backup.

The Atlassian account used for integration must be granted edit permissions for both open and restricted pages and blog posts.

General permissions

User management

Site permissions

Space permissions

Permissions in Confluence can be managed from multiple places, including per-space configuration. In Settings > Users, you can grant admin permissions to a specific user, but note that app admin permissions in user management do not always provide access to all spaces. The recommended approach is to manage permissions via Organization settings > Permissions > Space management.

Custom domains

Technical requirements for securing Confluence instances with custom domains.

Custom domains in Confluence allow organizations to use a branded URL instead of the default *.atlassian.net address. Even if a Confluence instance has a custom domain configured, proper protection requires adding the instance to Xopero ONE using the original Atlassian URL.


General information

Confluence instances that use custom domains can be integrated with Xopero ONE, but must use their original Atlassian URL instead of the custom domain. This limitation results from how Atlassian identifies and authorizes organizations.

Atlassian security and administration APIs are bound to the organization's original Atlassian-managed URL (e.g., yourcompany.atlassian.net), not the custom domain. The custom domain serves as a user-facing alias for access and branding purposes.

Internally, Atlassian recognizes, authenticates, and grants permissions only through the original URL registered in Atlassian Administration (https://admin.atlassian.com). Therefore, Xopero ONE must use the original Atlassian URL to identify the organization and its applications, authenticate API requests, and enforce security and access controls.

Using the custom domain would prevent proper authorization and could lead to failed connections or incomplete protection, which is why the original Atlassian URL is required even when a custom domain is configured.


You can find organization's original URL in > Apps > App URLs > Custom domains > Actions > Show details.

The original URL is listed in the Details section under Default URL (fallback).

Finding the original instance URL

https://admin.atlassian.com

Integration

Learn how to integrate Confluence with Xopero ONE to protect spaces and related resources.

Required permissions for integrating Confluence with Xopero ONE and protecting its resources.

Technical requirements for securing Confluence instances with custom domains.

Learn how to integrate Confluence with Xopero ONE using an API token.

Required permissions
Custom domains
Adding a Confluence instance to Xopero ONE
Cover
Cover
Cover

Adding a Confluence instance to Xopero ONE

Learn how to integrate Confluence with Xopero ONE using an API token.

Adding Confluence to Xopero ONE allows organizations to secure business documentation and knowledge base resources against accidental deletion, data corruption, ransomware incidents, and configuration issues while supporting automated backup operations, granular restore capabilities, and long-term data retention management across cloud environments.


Integration process

The below steps demonstrate how to quickly integrate Confluence with Xopero ONE using Xopero ONE Management Service.

For Confluence, use a classic token — Xopero ONE does not support scoped tokens.

Before adding Confluence to Xopero ONE, for all spaces you want to protect.

1

Open the DevOps tab on the left side of the window and select Confluence from the list.

2

Click the Connect button under Confluence Software.

3

In settings, enter the Atlassian organization address (for example, https://mycompany.atlassian.net) and add or select an API token from the Password Manager.

4

Configure the organization synchronization and the default worker. Specify the synchronization start time or set a time interval for automatic updates.

5

Click Proceed to complete the process of adding Confluence to Xopero ONE and granting it access to the specified resources.

6

Your Confluence instance has been successfully added to Xopero ONE. Click Custom policy to modify the backup policy settings, or click Run backup to start the backup immediately using the default policy configuration.


If you already have a Confluence instance added, click the + Add new button in the top-left corner first.

Xopero ONE can secure organizations that have a custom domain configured, but the organization must be added using its original URL, which can be found in > Apps > App URLs > Custom domains > Actions > Show details.

Learn more about custom domains in .

Useful links and items

Required permissions
check if your account has the required permissions
https://admin.atlassian.com
this article
Manage API tokens for your Atlassian account | Atlassian SupportAtlassian Support
Logo