Install the Confluence Plugin

Requirements

1. Confluence 2.6.1 or later.
    a. See http://www.atlassian.com/software/confluence/ to download
2. Windows SharePoint Services (WSS) v3 (free with Windows Server 2003).
     To check whether Windows SharePoint Services are installed, go to Start, All Programs, Admin, SharePoint 3.0 Central Administration. If you can see 'SharePoint 3.0 Central Administration', it is already installed.
    a. See http://office.microsoft.com/en-us/sharepointtechnology/FX100503841033.aspx?ofcresset=1 for information.
    b. To download, see this page.
3. (optional) Microsoft Office SharePoint Server (MOSS) 2007 (Standard or Enterprise)
MOSS is Required for the following features:
    a. Integrated Search
    b. Single Sign-On functionality from SharePoint using Windows Integrated Authentication to Confluence using Forms Based Authentication. See this page for information.
    c. To download a trial version of MOSS, see this page.

Installing the plugin

To install the plugin, do the following:

1. In Confluence, navigate to Administration -> Plugin Repository -> SharePoint Plugin.
2. On the row named SharePoint Plugin, click on 'install'.
   (if your Confluence server doesn't have an Internet connection attached, you can download the Confluence SharePoint plugin separately. Once installation is complete, move on to configuration.
3. If you're using the SharePoint web part features, then you need to install the Confluence permission check RPC plugin (follow link for instructions).
   1. If you're running Confluence 2.7+ you can do this from the Plugin Repository (see step 1).
   2. If you're running Confluence 2.6 or earlier, download the Confluence permission check RPC plugin to this directory:

      <confluence>/confluence/WEB-INF/lib

      Following this, restart Confluence.

Configuring the SharePoint plugin

Ensure you also read the next passage, entitled Important Conditions for Configuration Values. Otherwise, your configuration may fail.

Make sure you're logged in with Administration privileges.

1. Navigate to Administration -> SharePoint Admin (under the Administration list on the left)

Screenshot: The SharePoint Admin Screen

2. Set the theme. Navigate to Administration -> Themes and select the 'SharePoint theme'.

Screenshot: Choosing the SharePoint theme

3. Set the configuration values.

Sample values for configuration:

Server URL: atlassian-serv:80
username = ATLASSIAN-SERV\Administrator
password = *******
Search URL = http://atlassian-serv/_layouts/searchresults.aspx (for WSS, MOSS is slightly different)
Search Field Name = k (this is for MOSS)

Important Conditions for Configuration Values

1. 'Server Name' Value
The SERVERNAME value is especially important. Leaving out the SERVERNAME will cause failure. Notice also it is the backslash being used, \ not the forward-slash. It's very easy to accidentally get this wrong.

2. Username Format
The username must be of the format:

username=SERVERNAME\username

3. Setting Home Page URL
If your SharePoint home page has a URL like the following:

http://servername/site/confluence

then you will need to use a setting like this:

servername/site/confluence

4. User Attributes
The user specified must have either of the following attributes:

• Be a local user to the SharePoint server, as opposed to a domain user if the SharePoint server is running as a local user.
  OR
• If the SharePoint server is running as a domain user, then a domain user can be used for this setting. Otherwise it seems that SharePoint doesn't know how to resolve domain users coming in via a web service.

5. Configure SharePoint for 'Basic Authentication'
SharePoint must be configured to use either NTLM and/or Basic Authentication. The 'authentication type' should be 'Windows'. These settings are found on SharePoint under Central Administration -> Application Management -> Authentication Providers.
Other configurations may be possible but have not been tested. Kerberos will not work at this time.

6. Human-Readable Names Preferred
Editing SharePoint documents works better if the Server URL is a name or domain name (such as www.example.com) as opposed to an IP address (such as 204.106.74.12).

Version Info