This topic describes how to establish single sign-on between an Atlassian Crowd OpenID server and Collaborator. To learn general principles of how single sign-on operates, see Single Sign-On.
Single sign-on servers mostly use HTTPS connections, so you will likely need to enable it for Collaborator server as well. For instructions, please see Configure HTTPS. Do not forget to restart the Collaborator server to apply changes.
Install Atlassian Crowd server.
Log in to your Crowd server as an administrator.
Add new application integration: Select Applications from the main menu and then click Add Application. This will display the application settings.
Specify the setting values:
|Application type||Defines the type of application you are adding to Crowd. For Collaborator integration select the Generic Application option.|
|Name||The name of the client application. Must be unique across the server.|
|Description||A short description of the application.|
|Password and Confirm password||A password application will use when it authenticates against the Crowd server. Retype the password to confirm it.|
Specify the URL and the remote IP address of your Collaborator server. Specify port number, if you are not using a proxy. You can click Resolve IP Address, which prompts Crowd to resolve the IP address for your application.
|Your Collaborator server must be accessible to SSO server and vice versa. Configure a firewall or enable tunneled connections to do so.|
Select one or more directories that this application can use for authentication and authorization:
Specify the users who are authorized to access the application.
Do one of the following: either select Allow all users to authenticate, to grant application access to all users defined in the directory, or select one or more groups you wish to have access, and click Add Group.
Confirm the details for your application and click Add Application.
If you use proxy server, switch to the Remote addresses tab of application settings and add the proxy server's IP to the list.
Open the Collaborator login page in a browser and log in to Collaborator as an administrator.
In Collaborator, go to Admin > Single Sign-On.
In the New SSO Configuration section select CROWD SSO configuration type and click Create. This will display the configuration settings.
Specify the setting values:
|OpenID endpoint URL||
The URL where to redirect users for single sign-on procedure, if a session is not already established.
The endpoint typically has the following format:
|Crowd server URL||
The URL of your Crowd server (including port number).
The Crowd server URL typically has the following format:
|Crowd application name and Crowd application password||
The name and password of Crowd application for Collaborator integration.
This is the application that we have created on the Crowd server earlier.
|Enable Crowd group sync||
Specifies whether Collaborator should synchronize its native groups with group information from the Crowd server.
Once enabled, on every logging-in, Collaborator will check user membership in groups on the Crowd server, create new groups (if needed), and automatically add this user to the corresponding groups on the Collaborator server. This operation could be time-consuming, if there are multiple groups on your Crowd server. If you have any problems, check the server log.
|Automatic group creation filter||
A Java-style regular expression used to filter Crowd groups before automatic group creation. Any group name that does not match the pattern will be excluded.
After you specified the values, click Save. This will create a Crowd OpenID configuration.
If you have multiple configurations, press Make Active to mark current configuration as active.
Scroll the Admin > Single Sign-On screen up to the Single Sign-On (SSO) Status section and change the Enable Single Sign-On setting to Yes.
Now the integration between Collaborator and Crowd OpenID server is configured and running. Further attempts to log into Collaborator server will be processed by the sign-on server.
If you experience troubles with Crowd OpenID single sign-on authentication, please check the following:
http(s)://yourcrowdserver:8095/openidserver/(even when they are already logged-in on Crowd server), please verify that the OpenID endpoint URL value is specified correctly. Namely, that the URL ends with
If the problem persists, you can disable single sign-on authentication via the
-Dcom.smartbear.server.sso.disable=true Java VM option.