vCloud Air requires login requests to be authenticated. Begin the workflow with a login request that supplies user credentials in the MIME Base64 encoding format as specified in RFC 1421.

Log in and Accept Terms of Service Sequence Diagram
Log in and Accept Terms of Service Sequence Diagram

You have signed up and registered for Virtual Private Cloud OnDemand and received an email with a user name and password for an Account Administrator.

See Create Your Account in vCloud AirVirtual Private Cloud OnDemand Getting Started for information.

Using the URL in the confirmation email, you have logged in to Virtual Private Cloud OnDemand using the Web UI, set your password, and accepted the Terms of Service.

POST a request that includes your user name and password in a MIME Base64 encoding:

POST https://vca.vmware.com/api/iam/login

The initial POST requires that you enter the Authorization header with an encoded Base64 username:password value as shown:

Authorization: Basic HelloUser@example.com:password

Wherein HelloUser@example.com:password is encoded.

If the request is successful, the server returns HTTP response code 201 Created and a response that contains the vchs-authorization.

Tip:

Alternatively, you can submit the following POST request if the request in this step is unsuccessful:

POST https://iam.vchs.vmware.com/api/iam/login

Request Header

POST https://vca.vmware.com/api/iam/login 
Accept: application/json;version=5.7 
Authorization Basic cHhzdXNlcjFAdm13YXJlLmNvbTpQYXNzQDEyMw==…

Request body not required.

Response

HTTP/1.1 201 Created 
Header: 
   Content-Type: application/json;version=5.7 
   vchs-authorization: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJmOTF…
Body:
   {"serviceGroupIds":["89a6da00-0d15-48e9-8fed-6c87dfca5c0e"]}