vCAC to vCO: Configuration

vCAC 5.1 introduces a new endpoint for vCO.  This enables vCAC to launch vCO workflows from a vCAC workflow.  vCAC 5.1 also introduces a new endpoint for vCloud that enables vCAC to perform basic provisioning and management capabilities for vApps in vCloud Director 5.1.

This document will demonstrate the configuration and basic use of the vCO integration point using the out-of-the-box menu operations extensibility capability of vCAC, with examples provided to obtain information within vCO on vSphere virtual machines and vCloud vApps provisioned and/or managed by vCAC.

vCAC provides much broader extensibility capabilities than discussed in this document, including the ability to launch workflows based on events, state transitions, and a recurring schedule.  For more information see the vCAC 5.1 Extensibility Guide.

Configure a vCO Endpoint in VCAC  

Steps:
1. Open the vCAC admin website (e.g.: http://hostname/DCAC)
2. By default, the vCAC Administrator role is required to configure endpoints.  Authenticate as a user holding the vCAC Administrator role.  

Note: By default, the BUILTIN\Administrators group will have the vCAC Adminstrator role.  

3. From the vCAC Administrator menu, select Endpoints.

 Choose Endpoint

 
4. Select New Endpoint, then vCO.  Choose vCO Enpoint
5. Configure the following fields on the Create an Endpoint screen: 
a. Name: a display name for the endpoint 
b. 
Address: the location of the vCO API (listens on port 8281 by default)  
6.
 Click on the ellipses button to the right of the Credentials field.

 

 Configure Endpoint

 

7. Click New Credentials.
8. Specify a credential for vCAC to use to communicate with the vCO API.  The account specified should have at least Execute permissions on the vCO workflows that vCAC will launch.  Click the green checkmark button to save, then click OK to select the credential for use by this endpoint.

Note: vCO should be configured to use LDAP authentication.  SSO authentication for vCO is not currently supported.  vCAC uses the REST version of the vCO API.

 

 New Credentials

vCO Credentials

 9. vCO endpoints must have a custom property to indicate the priority of each endpoint.  Click the New Property button to create a new custom property with the name VMware.VCenterOrchestrator.Priority and a value that is greater than 0.  Click the green checkbox icon to save the custom property. 
10.
 Click OK to save the endpoint.

 Set the Custom Property

Review Endpoints

Now that your vCO endpoint has been configured in vCAC, you are ready to determine when, as well as which vCO workflow will be called. We will explore this a bit more in Customize vCAC Workflow to Call vCO Workflow