Troubleshooting the SharePoint Configuration in Confluence (v 1.3)

Owned by Almuth Boehme [Communardo]
Aug 19, 2016
2 min read

When the SharePoint Connector configuration is set up properly it just works. However when it does not work it can be tricky to diagnose the problem, given the two different platforms trying to authenticate, authorise, and communicate across different servers. Here are some things to check on the Confluence side.

On this page:

Using a SharePoint Domain User Account or Local User Account

You can log in to SharePoint with any user authorised to use SharePoint. Microsoft recommends that you use Active Directory domain accounts. However, you can only use domain accounts if the SharePoint server(s) are part of the domain.

Checking the Permissions for SharePoint Account used by Confluence

Make sure the account provided on the Confluence 'SharePoint Admin' screen is a SharePoint site administrator for the lists in all sites that the sp-list macro will access. For example, use a site collection administrator account.

Checking your SharePoint Server URL

Does your SharePoint URL resolve to something else? For example, if you type this into your browser:
http://my-sharepoint-server
Does it then resolve or get forwarded to something like this:
http://my-sharepoint-server/site

If yes, then the 'SharePoint Site URL' setting on your Confluence 'SharePoint Admin' screen needs to be: *my-sharepoint-server/site

See the forum discussion thread.

Making Sure You have Matching Versions of the Connector on Confluence and on SharePoint

To see the latest version of the plugin, check the latest release notes.

To see the version installed on your Confluence server:

  1. Go to 'Confluence Admin' and click 'Plugins'.
  2. Find and click the 'SharePoint Connector'.
  3. The version information will appear at the top of the screen in the middle.

To find out which version of the SharePoint Connector you have installed in SharePoint, go to the 'Confluence Administrative Settings' page in SharePoint:

  1. Go to the top level site within the site collection.
  2. Select 'Site Actions' (at the top-right) -> 'Site Settings' -> 'Modify All Site Settings'.
  3. On the 'Site Settings' page, choose 'Confluence Settings'.
  4. On the 'Confluence Administrative Settings' page, copy the value for the 'Connector Version' (in the section labelled 'Confluence Site').