SMTP SSL Connections in Cloud Director: A Step-by-Step Guide

In this blog post, we will guide you through the process of setting up SMTP SSL connections to your mail server at Cloud Director organization. This feature allows you to send Email notifications with SMTP over SSL, ensuring secure communication between your mail server and Cloud Director.

Step 1: Get X-VMware-VCloud-Access-Token

To start, you need to get the X-VMware-VCloud-Access-Token for further queries as Bearer token. You can do this by sending a GET request to the API endpoint . The response will contain the token in the X-VMware-VCloud-Access-Token header.

Step 2: Get Organization Information

Next, you need to get organization information from Cloud Director. You can do this by sending a GET request to the API endpoint . The response will contain the UUID of the organization in the href header. In our case, the UUID is 9fc961d2-7939-496e-895b-e7c0137b86ba.

Step 3: Get Email Configuration Information

To get information about the current settings of Email configuration, send a GET request to the API endpoint . Add the Content-type header with value application/json. The response will contain the current settings of Email configuration in JSON format.

Step 4: Prepare SMTP SSL Settings Data

If you want to add information about the server that will use SSL settings, prepare the data that will be added to the JSON body. The data should include the sender’s email address, subject prefix, and the names of the email addresses to send notifications to. You can also specify the SMTP server name, port, and authentication settings.

Step 5: Add SMTP SSL Settings to API Request

Finally, add the prepared JSON body to the API request. Send a PUT request to the API endpoint with the JSON body. The response will contain the same data that was sent in the Body of the request to the API.

Testing Email Sending

To test email sending, use the TEST button provided by Cloud Director. If your settings are correct, you will receive an email at the destination email address. Congratulations! You’ve successfully set up SMTP SSL connections to your mail server at Cloud Director organization.

Alternative Method: HTML5 Interface and API Requests

As an alternative method, you can add all the settings except for the SSL SMTP options via the HTML5 interface, then get the settings from the API endpoint . Copy the settings to a notepad and make changes to the JSON body as needed. Finally, put the modified JSON body back into the API request.

Note: Warning! If you make some changes from the Web interface at the Email settings page, all the settings that belong to SSL SMTP will be lost, and you’ll need to add them with API requests one more time. Be careful!

Additional Documentation

For further information on the SMTP Server Settings type, refer to the official VMware Cloud Director API documentation .

Conclusion

In this blog post, we have provided a step-by-step guide on how to set up SMTP SSL connections to your mail server at Cloud Director organization. By following these steps, you can ensure secure communication between your mail server and Cloud Director and send Email notifications with SMTP over SSL. Remember to be careful when making changes to the settings, as any changes made from the Web interface will result in the loss of SSL SMTP settings.