iredmail-doc/en_US/cloud/cloud-setup.ad.ssl.md

# Setup SSL support for Windows Active Directory

[TOC]

## Summary

Windows Active Directory requires secure connection for updating user password
from another host via LDAP protocol. In this tutorial, we will show you how to
setup SSL support for Active Directory with a self-signed ssl cert.

This tutorial has been tested on:

- Windows Server 2012

If it works for you on different Windows Server version, please let us know.

## Enable Active Directory Certificate Services

- Click `Start` on bottom-left corner of your Windows OS, click `Server Manager`.

![](./images/setup.ad.ssl/start-server-manager.png)

- Click `Manage` on top-right corner, click `Add Roles and Features`.

![](./images/setup.ad.ssl/server-manager-add-roles-and-features.png){:width="1024px"}

- Click `Next`:

![](./images/setup.ad.ssl/setup_ad_ssl_1.png)

- Choose `Role-based or feature-based installation`. Click Next.

![](./images/setup.ad.ssl/setup_ad_ssl_2.png)

- Select your server from the server pool. Click Next.

![](./images/setup.ad.ssl/setup_ad_ssl_3.png)

- Choose `Active Directory Certificate Services` from the list, and click Next.

![](./images/setup.ad.ssl/setup_ad_ssl_4.png)

- Click Next directly without choosing any item from list on the `Features` page.

![](./images/setup.ad.ssl/setup_ad_ssl_5.png)

- Click Next.

![](./images/setup.ad.ssl/setup_ad_ssl_6.png)

- Toggle on `Certificate Authority` and click Next.

![](./images/setup.ad.ssl/setup_ad_ssl_7.png)

- Click `Install` to install selected roles/features.

![](./images/setup.ad.ssl/setup_ad_ssl_8.png)

- It may take some time to finish, after finished, close the wizard window.

![](./images/setup.ad.ssl/setup_ad_ssl_9.png)

## Create a self-signed certificate

Now let’s create a certificate using AD CS Configuration Wizard. To open the wizard, click on “Configure Active Directory Certificate Services on the destination server” in the above screen. And then click Close. We can use the currently logged on user azureuser to configure role services since it belongs to the local Administrators group. Click Next.

![setup_ldaps_10](./images/windows_ad/setup_ldaps/setup_ldaps_10.png)

11. Choose Certification Authority from the list of roles. Click Next.

![setup_ldaps_11](./images/windows_ad/setup_ldaps/setup_ldaps_11.png)

12. Since this is a local box setup without a domain, we are going to choose a Enterprise CA. Click Next.

![setup_ldaps_12](./images/windows_ad/setup_ldaps/setup_ldaps_12.png)

13. Choosing Root CA as the type of CA, click Next.

![setup_ldaps_13](./images/windows_ad/setup_ldaps/setup_ldaps_13.png)

14. Since we do not possess a private key – let’s create a new one. Click Next.

![setup_ldaps_14](./images/windows_ad/setup_ldaps/setup_ldaps_14.png)

15. Choosing SHA1 as the Hash algorithm. Click Next.

![setup_ldaps_15](./images/windows_ad/setup_ldaps/setup_ldaps_15.png)

16. Click Next.

![setup_ldaps_16](./images/windows_ad/setup_ldaps/setup_ldaps_16.png)

17. Specifying validity period of the certificate. Choosing 99 years. Click Next.

![setup_ldaps_17](./images/windows_ad/setup_ldaps/setup_ldaps_17.png)

18. Choosing default database locations, click Next.

![setup_ldaps_18](./images/windows_ad/setup_ldaps/setup_ldaps_18.png)

19. Click Configure to confirm.

![setup_ldaps_19](./images/windows_ad/setup_ldaps/setup_ldaps_19.png)

20. Once the configuration is successful/complete. Click Close.

![setup_ldaps_20](./images/windows_ad/setup_ldaps/setup_ldaps_20.png)

21. Restart system.

### Test LDAPS
After restart system, we can connect to the LDAP server over SSL.
Now let us try to connect to LDAP Server (with and without SSL) using the ldp.exe tool.

Connection strings for:
- `LDAP:\\ad.iredmail.org:389`
- `LDAPS:\\ad.iredmail.org:636`

1. Click on Start --> Search ldp.exe --> Connection and fill in the following parameters and click OK to connect:

![test_ldap_1](./images/windows_ad/setup_ldaps/test_ldap_1.png)

2. If Connection is successful, you will see the following message in the ldp.exe tool:

![test_ldap_2](./images/windows_ad/setup_ldaps/test_ldap_2.png)

3. To Connect to LDAPS (LDAP over SSL), use port 636 and mark SSL. Click OK to connect.

![test_ldaps_1](./images/windows_ad/setup_ldaps/test_ldaps_1.png)

4. If connection is successful, you will see the following message in the ldp.exe tool:

![test_ldaps_2](./images/windows_ad/setup_ldaps/test_ldaps_2.png)