Setting up Azure AD SAML based authentication for vCloud

This guide runs through how to configure Azure AD SAML based authentication within vCloud director to provide SSO access with your Azure AD users

Overview

You have the ability to configure SAML or LDAP based authentication within the vCloud Director portal to allow you to manage your users in your existing Azure AD or Active-Directory on-prem deployment.

This guide will cover how to configure SAML Authentication to Azure AD, to do this you will need the below information/access.

  • Administrative access to your vCloud Director Tenant

  • Administrative access to your Azure Active-Directory Tenant

Steps

To configure Azure AD SAML authentication in vCloud Director follow the bellow steps. This will require you to switch between Azure AD and vCloud Director a few times.

Step 1. Login to your vCloud Director Tenant (the URL should be similar to https://vdc.syd.mhn.net.au/tenant/contoso)

Step 2. Navigate to Administration and then click on "SAML" under the Identity Providers in the menu on the left

Step 3. On the SAML Configuration page click on the URL next to "Metadata", this will download a file we need to upload to Azure AD

Now that we have the metadata file we can switch to Azure AD

Step 3. Login to https://portal.azure.com and login with your Admin credentials

Step 4. Click the three horizontal lines in the top left of the page and then click on "Azure Active Directory"

Step 5. In the list of items along the left of the page click on "Enterprise Applications"

Step 6. Click on "New Application"

Step 7. Click on "+ Create your own application"

Step 8. In the little window that opens, name your application (e.g. vCloud Director) and ensure "Integrate any other application you don't find in the gallery" is selected. Click "Create" once done

Step 9. On the page that loads click on "Assign Users and Groups" and add the user or group you want to have access. Once done click on "Overview" on the left

Step 10. Click on "2. Set up single sign on"

Step 11. Click on the "SAML" option

Step 12. At the top of the page click on "Upload metadata file" and select the file you downloaded from vCloud Director

Step 13. In the window that appears enter your vCloud Tenant URL into the "Sign On URL" field. (e.g. https://vdc.syd.mhn.net.au/tenant/contoso), click "Save" at the top once done

Step 14. Under the "SAML Signing Certificate" section, click the download button next to "Federation Metadata XML". We need to upload this to vCloud Director

Now that the Azure AD side is configured we need to go back to vCloud Director and finish the SAML configuration

Step 15. Go back to vCloud and to the section where you downloaded the metadata file. Click on "Edit" on that page

Step 16. Click on the "Identity Provider" tab at the top of the page, then click the slider to enable the SAML Identity Provider and upload the XML file you downloaded from Azure. Click "SAVE" to apply the settings

Step 17. Last step is to give users access, click on either Users or Groups on the left side of the page. Then click on "Import Users" or "Import Groups"

Step 18. Enter the Users (Email address) or Groups as they would appear in Azure AD, select the permission level then click Save

Step 19. Now test logging in via SSO in an Incognito window, you should be directed to the Azure Login Portal instead of vCloud Director

If you encounter any issues with this guide please contact our support team at [email protected] or via phone on 1300 781 148