Configuring the Salesforce SSO 1-click Button

Salesforce.com Pre-requisites

There are a few requirements:

  • Salesforce must be in Classic view for SSO 1-Click to function correctly. Lightning Experience is currently not supported. 

  • API must be enabled for the organization.

  • API must be enabled for the user that you want to use this plugin for, this is assigned via the permissions and roles in administration.

Configuring the Link

The automatic authentication into Confluence is achieved via a link from Salesforce.com (either in the Customer Portal or the Admin Portal) which also includes details of the current user's session details, this can be achieved by appending the following to the end of any link to Confluence in a Salesforce.com component (which can be a Button, Link or VisualForce page):

?session={!$Api.Session_ID}&domain={!$Api.Partner_Server_URL_520}

So, taking the "my.confluence.com" dashboard as an example, you could configure a Link in Salesforce.com with the following template:

http://my.confluence.com/dashboard.action?session={!$Api.Session_ID}&domain={!$Api.Partner_Server_URL_520}

The session and domain parameters are used to validate the user's session, after which, the user is automatically authenticated into the respective system.