7.3

Prerequisites
n
Secure a channel between the web browser and the vRealize Automation server. Open a browser
and enter the URL such as:
https://vra-appliance-name.company.com
The system warns that your connection is not private. Click through to confirm the security exception
and establish an SSL handshake.
n
Log in to vRealize Automation using the applicable credentials. For example, to assign a user to a
role, log in as a tenant administrator.
n
Verify that the appliance name and fully qualified domain name of the vRealize Automation instance
are available.
Procedure
1 Enter the command to request the HTTP bearer token.
curl --insecure -H "Accept: application/json" -H 'Content-Type: application/json' --data
'{"username":"[e-mail]","password":"vra-user-password","tenant":"company.com"}'
https://$vRA/identity/api/tokens
In this example, $vRA is an instance of vRealize Automation. The --insecure flag is included so that
the request will return a response even if the traffic is not secured with a trusted certificate.
2 Examine the response.
A successful request returns an HTTP bearer token that you include in subsequent API requests.
3 For convenience, store the token in a variable.
export token="EXAMPLE-TOKEN-TEXT"
Example: Token Request and Response
The following sample displays output based on the example request.
curl --insecure -H "Accept: application/json" -H 'Content-Type: application/json' --data
'{"username":"[e-mail]","password":"vra-user-password","tenant":"company.com"}'
https://$vRA/identity/api/tokens
{"expires":"2017-04-14T04:46:43.000Z","id":"MTQ5Mj ... M2RmMA==","tenant":"company.com"}
The id is the bearer token to store for future use.
export token="MTQ5Mj ... M2RmMA=="
Programming Guide
VMware, Inc. 15