Skip to end of metadata
Go to start of metadata

This page tells you how to configure the Confluence settings for a SharePoint site, in SharePoint. These instructions apply to the connector for SharePoint 2010.


Configuring the Confluence Administrative Settings for a SharePoint Site.

  1. Open your web browser and use one of the following methods to open the Confluence settings page of the appropriate SharePoint site collection:

    • Navigate to the top level site within the site collection, select 'Site Actions' (at the top left) -> 'Site Settings' -> 'Confluence Settings'.
      (info) The 'Confluence Settings' option is available only if the Confluence SharePoint web part was deployed to that SharePoint site.

      Screenshot: SharePoint Site Settings, including 'Confluence Settings' option

    • Or enter the URL for this page directly, using the format:
    • Or use the final step of the web part installer wizard which provides direct links to these pages. For more information, please refer to the instructions on installing the SharePoint feature.

  2. The Confluence administration screen appears:

    Screenshot: Confluence Administrative Settings in SharePoint

  3. Select where you want the settings to be saved.  If you select the 'Current Site Only' option, the settings will be available to any Confluence web parts used in the site, or its child sites. If you select the 'Entire SharePoint Farm' option, the settings will be stored in the Farm configuration database and will be available to any Confluence web parts used in any site.

    Note that the 'Entire SharePoint Farm' option is only available if you are logged in with a user account that has Farm administration privileges.

  4. Enter the base URL of the Confluence site in the 'Confluence Site' field.

  5. Under 'Authentication Selection', choose the method by which SharePoint will access the Confluence site. See our planning guide for help with the authentication options.
    • If you choose 'Access Confluence with a single master account':
      • Specify the Confluence username that SharePoint will use to access Confluence and enter the password recognised by Confluence for that username. This username must have full Confluence site administration permissions.
      • Optionally, you can also choose to customise the format of the username used to authenticate against Confluence. Select 'Customise the permission checking format'. The 'User Name Format' field will appear. Enter a format, such as this:
        This example will pass the domain as well as the username when authenticating a user to Confluence. This is useful if you have configured Confluence to connect to multiple Active Directory domains and you therefore need to distinguish between two users with the same username in different domains.
      • Optionally, you can also choose to set the format of the username used to authenticate against Confluence to be the SharePoint user's configured Active Directory email address. To do this, select the 'Authenticate with Confluence using email' field.
        This is useful if your users log in to Confluence with their email address, rather than their Active Directory username.
    • If you choose 'Access Confluence with the Microsoft Single Sign-On (SSO) Service':
  6. If your Confluence site is especially large, and your users report problems while waiting for the Confluence web parts to load, you can optionally choose to increase the timeout value for retrieving content from Confluence. The default is 100 seconds, but you can increase this to a longer timeout if desired. To do this, enter a new numerical value in the 'Web Service Timeout' field.
  7. Click the 'Test Confluence Configuration' button to test your configuration settings.
  8. Click 'OK' to save your changes.

Settings Inheritance

The Confluence settings are automatically inherited down the SharePoint site hierarchy. If no Confluence settings have been configured for a SharePoint site, the chain of parent sites will be checked for settings to use. If no parent site has any Confluence settings defined, then the Farm configuration database will be checked for farm-wide settings.

  • No labels