Installing the Connector on Windows
Download the installer
The Connector is packaged as a standard Microsoft Installer file (MSI). Download from here:
Run the installer
Run the installer and follow the instructions:
The AD/LDAP Connector in Windows is installed as a Windows Service:
Link to Auth0
Once the installation is complete, you will see the following screen in a browser pointing to localhost:
Enter the TICKET URL provided when you provisioned the connection.
The TICKET URL uniquely identifies this connector in Auth0. The Connector will use this to communicate with Auth0 Server and automatically complete the configuration.
Link to LDAP
Once you have entered the TICKET URL, you must enter the LDAP settings:
- LDAP Connection String (eg: ldap://ldap.internal.contoso.com): This is the protocol + the domain name or ip address of your LDAP server. The protocol can be either
ldaps. If you need to use
ldapsmake sure that the certificate is valid in the current server.
- Base DN (eg: dc=contoso,dc=com): This is the base container for all the queries performed by the connector.
- Username (eg: cn=svcauth0,dc=services,dc=contoso,dc=com): The full distinguish name of a user to perform queries.
- Password: The password of the user.
Once you submit the above information, the connector will perform a series of tests:
Make sure that all tests are in green.
Congratulations, your connector is installed and ready to use.
After clicking "Save", the AD/LDAP Connector configuration console will perform a series of tests to validate the entered information. The results of the tests are displayed under the "Configuration log" heading in the console screen. An explanation is provided below of the tests performed.
Test 1: Attempts to establish a TCP connection to the LDAP server and port specified.
If Test 1 fails, check basic network connectivity and firewall settings that might prevent such a connection.
Test 2: Attempts to perform an LDAP bind on the LDAP server and port specified and with the username and password provided.
If Test 2 fails, check the LDAP connection string, search path, username and password.
Test 3: Attempts to perform an LDAP search against the directory to check the privileges of the specified username.
If Test 3 fails, check the privileges of the username in the target directory.
Test 4: Attempts to establish a connection to the Auth0 server.
If Test 4 fails, check network connectivity and firewall settings that might prevent such a connection.