SharePoint Connector for Confluence

[Downloads (PDF, HTML & XML formats)]
[Other versions]

This documentation relates to SharePoint Connector 1.9
If you are using an earlier version, please view the [previous versions of the SharePoint Connector documentation] and select the relevant version.

Skip to end of metadata
Go to start of metadata

The Confluence SharePoint Connector provides a federated search, allowing SharePoint to issue search requests to Confluence and display the results it gets back from Confluence. Federated searches use Confluence's own search engine to retrieve up-to-date and relevant results. These instructions apply to the connector for SharePoint 2007.

On this page:


  • Microsoft Office SharePoint Server (WSS is not enough): Only Microsoft Office SharePoint Server ('MOSS') supports the new federated search. Plain Windows SharePoint Services ('WSS') does not support federated search.

    The federated search feature in SharePoint Connector 1.1 and later relies on new functionality in SharePoint. At least one of the following updates to SharePoint must be installed on your MOSS Server(s):
  • The Confluence OpenSearch plugin and MOSS search configuration: Your Confluence installation must include the OpenSearch plugin and must be configured to share search results with MOSS. Optionally, you can also configure Confluence to use the SharePoint Decorators theme. See the guide to installing the Confluence SharePoint plugins.

SharePoint Configuration

Step 1: Configure the Federated Search Location

  1. Go the SharePoint central administration section and select the shared services for which to add the federated search:

  2. Choose 'Search Administration':

  3. Choose 'Federated Locations'. Note that this will only be present if the infrastructure update has been installed:

  4. Add a federated location:

  5. Enter the information for the federated location. Here are some guidelines on the mandatory fields:

Field Name


Example Value

Location Name

The name of this location. We suggest 'Confluence'


Display Name

The name of the location which will be displayed to users

Development Confluence Wiki


A description of this location


Location Type

The type of search to perform. We need OpenSearch.

OpenSearch 1.0/1.1

Query Template

This is the URL which will be used to perform the actual search. This URL depends on the authentication used by Confluence:
* Standard (forms) authentication: http://<CONFLUENCE_SERVER>/plugins/servlet/opensearch?query={searchTerms}&format=rss_1.0&os_authType=basic
* NTLM: http://<CONFLUENCE_SERVER>/plugins/servlet/opensearch?query={searchTerms}&format=rss_1.0



{searchTerms}&format=rss_1.0&os_authType=basic (



"More Results" Link Template

The link which users will go to if they click the "More Results" link:




Specify Credentials

This specifies how Sharepoint will send the credentials for the searching user to Confluence. Make sure that you set the credentials in the 'User' section, not the 'Common' section. The actual credentials depend on the authentication used by Confluence:
* Standard (forms) authentication: choose "Basic Authentication"
* NTLM: choose "NTLM Authentication"

If you use Microsoft SSO, check "Use SSO" and select the Confluence SSO application, if you do not use Microsoft SSO then leave it unchecked.


Federated Search Results Display Metadata: XSL

This specifies how to display the results. This can optionally be changed using the example XML to use Confluence icons for Confluence search results.

Step 2: Add Web Part to Search Results

  1. Go to the main Sharepoint site and go to the search results screen:

  2. Click 'Site Actions', then 'Edit Page':

  3. Click 'Add a Web Part'. You can add the web part anywhere on the page. This is where the Confluence results will appear:

  4. The 'Add Web Parts' screen appears. Select the web part:
    • With SSO: If you are using SSO and checked 'Use SSO' when setting up the federated location, then select 'Federated Results'.
    • Without SSO: If you are not using SSO and did not check 'Use SSO' when setting up the federated location, then select 'Confluence Federated Search Results WebPart'.

  5. Click the 'Add' button.

  6. Open the 'Edit' menu for the web part which you have just added and select 'Modify Shared Web Part':

  7. The panel at the side opens up. Select 'Confluence' (or whatever you named the federated location) from the dropdown menu:

  8. Click 'OK', then 'Exit Edit Mode'. Setup is complete.

Installing and Configuring the SharePoint Feature on SP 2007
Installing the SharePoint Connector