Add or Edit a Source
- Amazon S3 Source
- Box (Personal) Source
- Box Business V2 Source
- Box Business Legacy Source
- Confluence Cloud Source
- Confluence Legacy Source
- Confluence Self-Hosted Source
- Database Source
- Dropbox (Personal) Source
- Dropbox Business Source
- Exchange Enterprise Source
- Exchange Online (Personal) Source
- File System Source
- Generic REST API Source
- Gmail for Work Source
- Gmail (Personal) Source
- Google Drive (Personal) Source
- Google Drive for Work Source
- Jira Software Cloud Source
- Jira Software Self-Hosted Source
- Jive Cloud Source
- Jive Server Source
- Lithium Source
- Microsoft Dynamics Source
- OneDrive for Business Source
- Push Source
- RSS Source
- Salesforce Source
- SharePoint Online Source
- SharePoint Online Legacy Source
- SharePoint Server Source
- Sitecore Source
- Sitemap Source
- Twitter Source
- Web Source
- YouTube Source
- Zendesk Source
Add or Edit a Confluence Cloud Source
Because you cannot install plugins in Confluence Cloud, Coveo cannot include permissions for this content and cannot perform source refreshes.
By default, a Confluence Cloud source starts a rescan every hour to retrieve Confluence Cloud item changes (addition, modification, or deletion).
If you change the name of a space in Confluence Cloud, the rescan detects the change only for pages created or modified following the change. You must thus rebuild the source to get the space name change on all space pages (see Refresh, Rescan or Rebuild Sources).
For clients migrating from Coveo Enterprise Search 7.0 (CES 7), the following source has the same specifications as the Confluence V2 connector (see Atlassian Confluence V2 Connector).
You can get the
CONFLUENCE_UNREACHABLE_SERVERerror message when your Confluence Cloud source rebuilds or is scheduled to perform a rescan during the Atlassian Cloud (1 AM to 3 AM daily) maintenance window during which Atlassian may block access to the API while performing maintenance tasks (see Maintenance windows).
If possible, schedule rescans to start and complete outside of the daily maintenance window (see Edit a Source Schedule). If not possible, simply ignore the errors. The next scheduled rescan outside the maintenance window shall complete normally.
Source Features Summary
|Confluence Cloud version||Latest cloud version|
|Searchable content types||
Spaces, pages (such as Wiki pages), blog posts, comments on pages and blog posts (included as metadata), and attachments (in pages, blog posts, and comments)
Rescan or rebuild needed to retrieve deleted, restored, and moved items, and items with modified comments or permissions.
Add or Edit a Confluence Cloud Source
If not already in the Add/Edit a Confluence Cloud Source panel, go to the panel:
To add a source, in the main menu, under Content, select Sources > Add source button > Confluence > Confluence Cloud.
To edit a source, in the main menu, under Content, select Sources > source row > Edit in the Action bar.
In the Configuration tab, enter appropriate values for available parameters:
A descriptive name for your source under 255 characters (not already in use for another source in this organization).
One or more Confluence Cloud Wiki site and space addresses including the protocol (http:// or https://) that you wish to make searchable.
Depending on your use case, use one of the following URL formats:
To index a complete Confluence Cloud site, add the Confluence server root URL:
To index specific Confluence Cloud spaces, add their URL:
where you replace
MyConfluenceServerwith your Confluence instance name, and
space2with the desired Confluence space keys.
Select who can see items from this source in a search interface that includes this source in its scope (see Source Permission Types):
Private: Only you, when you are authenticated to the search interface with the identity with which you create the source.
In the Authentication section, when you want to include secured Confluence Cloud content, you must set the appropriate authentication parameters:
The username of a dedicated Confluence Cloud account that has access to all the content that you wish to include.
Remember that Confluence Cloud permissions are not supported, so if you select the source content to be Shared, in search results, users can see all items that the dedicated account can access.
The corresponding password.
Advanced authentication options
Select this checkbox to specify how Coveo Cloud V2 should access your Confluence content, depending on the credentials you provided.
Select Use Kerberos authentication when the provided source credentials exist in both Confluence and Active Directory.
Select Bypass Single Sign-On to bypass your single sign-on authentication service in Confluence and authenticate with the provided native Confluence account.
In the Content to Include section, consider changing the default value of the parameters in this section when you want to fine-tune how your Confluence Cloud site is crawled:
Choose the Confluence Cloud space type(s) to include the content:
By default, only global spaces content is included and personal space content is excluded.
Select which spaces should be included, depending on their status:
Current (only non-archived spaces are retrieved)
Archived (only archived spaces are retrieved)
Both (both archived and non-archived spaces are retrieved)
Unselect one or more of the following Options when you want to prevent specific Confluence Cloud item types from being included:
Attachments (binary files attached to a page, blog post, or comment)
Comments (on blog posts and pages)
Comments are included as metadata of the page, not as items.
The regex to use to filter spaces when you want to include only a subset of a Confluence Cloud site.
This parameter is useful when you have a large number of spaces to include that have an element in common in their space keys.
You want to include all spaces with keys starting with an uppercase letter followed by a number, so you enter the following regex:
- In the Access tab, determine whether each group and API key can view or edit the source configuration:
- In the Access Level column, select View or Edit for each available group.
- On the left-hand side of the tab, if available, click Groups or API Keys to switch lists.
If you remove the Edit access level from all the groups of which you are a member, you will not be able to edit the source again after saving. Only administrators and members of other groups that have Edit access on this resource will be able to do so. To keep your ability to edit this resource, you must grant the Edit access level to at least one of your groups.
Optionally, consider editing or adding mappings (see Manage Source Mappings).
You can only manage mapping rules once you build the source (see Add or Edit a Source).
Complete your source addition or edition:
Click Add Source/Save when you want to save your source configuration changes without starting a build/rebuild, such as when you know you want to do other changes soon.
In the Sources page, you must click Start initial build or Start required rebuild in the source Status column to add the source content or make your changes effective, respectively.
Click Add and Build Source/Save and Rebuild Source when you are done editing the source and want to make changes effective.
Back in the Coveo Cloud administration console Sources page, you can review the progress of your Confluence source addition or modification (see Manage Sources).
Once the source is built or rebuilt, you can review its content in the content browser (see Inspect Items With the Content Browser).
Review the default refresh schedule in which a source rescan starts every hour (see Edit a Source Schedule).