Configuring the SharePoint Web Part on SP 2010

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.

On this page:

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'.
     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:
     http://<sharepoint-site-collection>/_layouts/Atlassian/ConfluenceSettings.aspx
   • 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. You should only attempt to save the settings with the 'Entire SharePoint Farm' option when you are logged in to the SharePoint Central Administration site.

   
   
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:

       {domain}\{username}

       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':
     • Select the Confluence SSO application in the dropdown box. This is the application that you have already set up when configuring access to Confluence via the Microsoft 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.