Password Synchronization with Microsoft SQL Server

ADSelfService Plus’ Real-time Password Synchronizer helps ensure users have only one password between different applications to reduce password related issues. This means, every time a user resets or changes their Active Directory password, the new password will automatically be synced with the user’s MS SQL account.

Before you begin:

Make sure that the SQL user account that is to be configured has either the 'sysAdmin' or 'Alter any Login' privilege.

Configuration steps:

1. Log in to ADSelfService Plus console with admin credentials.

2. Go to Configuration → Self-Service → Password Sync/Single Sign On.

3. In the dashboard presented, click the Microsoft SQL Server link. You’ll now be redirected to the Microsoft SQL Server Database Configuration page.

    

   

4. Enter the System Name/IP Address of the server on which Microsoft SQL Server instance is deployed.

5. Enter an appropriate Display Name of the Microsoft SQL Server instance.

6. Enter the Port Number used by the MS SQL server.

7. Based on the configurations in your Microsoft SQL Server instance, select SSL or Non-SSL in the Protocol field which would define the connection type.

8. Select either Windows or SQL as the Authentication Type.

9. If you have selected SQL as an authentication type, enter the User Name and Password of the SQL user account (from Before you begin).

10. If you have selected Windows as an authentication type, enter your domain login credentials.

11. Enter an appropriate Description.

12. From the Available Policies drop-down list, select the policies for which the synchronization of passwords must occur.

13. Click Save.

Possible errors and their troubleshooting steps.

1. Error: Connection refused or Invalid System Name or Port Number

   Troubleshooting steps:

   • Ensure that you have typed the port number specific to the targeted MS SQL server instance.

   • Check the status of the MS SQL server. If it is shutdown, start it. Check if the MS SQL server is reachable. If it is unreachable, check the network connections using the telnet command.

     telnet hostName/ipaddress portnumber

   • If you've forced SSL in MS SQL server, make sure you've selected SSL from the Protocol drop-down in ADSelfService Plus' MS SQL configuration page.

2. Error: SQL Server Certificate is not trusted by JVM, need to import it in JVM.

   Troubleshooting steps:

   • Either copy or export the SSL certificate that you applied, and paste it under <Install Directory>\jre\bin folder (Default location:C:\ManageEngine\ ADSelfService Plus\jre\bin).

   • Open an elevated command prompt and execute the following command:

     Keytool -importcert -alias myserver -keystore ..\lib\security\cacerts -file mymssql.cer -keypass changeit -storepass changeit -noprompt

   • Restart ADSelfService Plus.

   • Now, try establishing the SSL connection.