How To connect Confluence to a MSSQL server using SSO (Windows Only)
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
The latest jdts driver have the ability to do SSO on MSSQL using the same service account that is running Confluence service, however the bundled version we ship on Confluence does not cover that area.
Step-by-step guide
To make Confluence use Single Sign On against MSSQL database you need to do the following:
- Go to JTDS download page and download the latest version of the driver (the zip file).
- Open the zip file, you will see two folder x64 and x86.
- Open the one that corresponds your Confluence installation.
- Now open the SSO folder and copy the ntlmauth.dll to a temporary directory.
- Click on Start > CMD and navigate to <Confluence Install>\bin directory.
- Follow steps 1 to 5 of this guide.
- In the java tab check the path under "Java Virtual Machine"
Navigate to your the JRE\BIN directory on above path and drop the ntlmauth.dll
In case your Confluence instance is not installed as a service just check the JAVA_HOME path and drop the ntlmauth.dll in the <JAVA_HOM>\bin directory.
- Shutdown Confluence.
- Make sure that the account that runs Confluence have all the proper permissions on Confluence database.
- Edit the <Confluence Home>\confluence.cfg.xml file.
Search for the following:
<property name="hibernate.connection.password">DbUserPass</property> <property name="hibernate.connection.url">jdbc:jtds:sqlserver://localhost:1433/dummy;</property> <property name="hibernate.connection.username">DatabaseUser</property>
Add ";useNTLMv2=true;domain=MyDomain" at the end of the connection URL. It will look like the following:
<property name="hibernate.connection.password">DbUserPass</property> <property name="hibernate.connection.url">jdbc:jtds:sqlserver://localhost:1433/dummy;useNTLMv2=true;domain=MyDomain</property> <property name="hibernate.connection.username">DatabaseUser</property>
Now remove the hibernate.connection.password and hibernate.connection.username lines. It will look like the following:
<property name="hibernate.connection.url">jdbc:jtds:sqlserver://localhost:1433/dummy;useNTLMv2=true;domain=MyDomain</property>
Save the file.
Start Confluence.
In case this is your first installation first follow this guide and once Confluence is full installed then try the steps listed in here.
Related articles
There is no content with the specified labels