Confluence
How to set-up your Confluence connection on Dust
Heads up
The initial user’s Confluence permissions bind the synchronization between Dust and Confluence. If permissions are edited by another user, the synchronization scope may change, potentially breaking connections to data no longer in the new user's scope.
Dust does not ingest private spaces. Dust does not access pages with view limitations and will not capture any content from a restricted page. This restriction also applies to all the child pages of such pages.
Overview
Dust synchronizes with Confluence to bring your workspace documentation into Dust, enabling easy access and retrieval of information directly through your Dust workspace.
Setting up the Connection
Initial Connection Setup
To connect Confluence with Dust:
- Identify an Admin: Choose an admin with comprehensive access to Confluence global spaces and also a Dust admin. This ensures a broad and relevant data scope for synchronization.
- Connect to Confluence: Navigate to
Build
>Connections
in Dust, select Confluence, and follow the prompts to authenticate and grant Dust access to Confluence.
![Confluence redirect to authorize and configure Dust.](https://files.readme.io/6a15506-Untitled_39.png)
Confluence redirect to authorize and configure Dust.
- Select Global Spaces: During the connection setup, the admin can choose which global spaces in Confluence to synchronize with Dust. Only those selected will be accessible in Dust.
![Dust modal to enable global spaces synchronization.](https://files.readme.io/2124f72-Untitled_40.png)
Dust modal to enable global spaces synchronization.
About the admin user
Dust recommends using a single, identified admin (or a virtual user like [email protected]) for managing Confluence permissions to ensure consistent access and avoid accidental permission overwrites.
Managing Permissions
To manage or update the permissions:
- Add/Remove Global Spaces: The identified admin can add or remove global spaces for synchronization in Dust without resetting the entire connection.
Updating the Connection
If you need to update the connection, such as adding more global spaces or changing the admin permissions, follow the same steps under Initial Connection Setup. Remember, changes in permissions might affect the data scope available in Dust.
Data Synchronization
- Scope: Dust synchronizes content from the selected global spaces in Confluence. Private spaces and pages with view restrictions are not included.
Best Practices
- Limit permission management to a single identified admin to maintain consistent synchronization scope.
- Regularly review and update the selected global spaces to ensure the most relevant and up-to-date information is available in Dust.
Refresh and Sync Details
- Immediate Sync: Changes within selected global spaces are synchronized with Dust almost immediately, with a slight latency of a few seconds to minutes.
- Hourly Check: Dust checks for new or updated content in Confluence approximately every hour to ensure data freshness.
Updated 11 days ago