Get Access Token

Get Access Token

This token endpoint complies with the OAuth 2.0 specifications and must be used by client to obtain an access token with client authentication.

Request
URI
POST
https://{api_host}//acs/t/{TENANT}/token
COPY
Path Parameters
string
TENANT
Required

TENANT


Request Body
TokenFormData of mimetype application/x-www-form-urlencoded
Optional
string
client_id
Optional

This is the identifier of the OAuth 2.0 client that was registered in VMware Identity Manager.

string
client_secret
Optional

client_secret

string
scope
Optional

The list of scopes of the authorization request separated by a space and is URL encoded. The scopes must be equivalent or a subset of the scopes defined in the OAuth2.0 client.

string
redirect_uri
Optional

Specifies the callback endpoint in your application that will receive the authorization code. It must match the redirect_uri defined in your OAuth2.0 client registration in VMware Identity Manager. When sending the redirect_uri as a URL parameter it has to be URL encoded.

string
domain
Optional

Specifies the user's domain. If this parameter is specified, the login screen will skip the domain selection page. This can be used when it is known that a single domain is used or the domain information can be inferred automatically (from the username for example). This is a VMware Identity Manager optional parameter and is not in the OAuth 2.0 specification.

string
username
Optional

The username, UTF-8 encoded. Required only when grant_type is 'password'

string
password
Optional

The password, UTF-8 encoded. Required only when grant_type is 'password'

string
grant_type
Optional

Specifies the OAuth grant type the client is making. VMware Identity Manager supports the following grant types from the OAuth specifications: authorization_code, password, client_credentials, and refresh_token. VMware Identity Manager also supports the grant type urn:ietf:params:oauth:grant-type:jwt-bearer for using JWTs for authorization as described in the JWT Bearer Token Profiles for OAuth 2.0 specifications.

string
code
Optional

The authorization code received from the authorize request. Required only if the grant_type is 'authorization_code'

string
refresh_token
Optional

The refresh token, which can be used to obtain new access tokens using the same authorization grant

string
assertion
Optional

The assertion being used as an authorization grant.If an assertion is not valid or has expired 'invalid_grant' error code is returned

string
subject_token_type
Optional

subject_token_type

string
subject_token
Optional

subject_token

Authentication
This operation uses the following authentication methods.
Responses
200

Successful

Returns OAuth2Token of type(s) application/json;charset=UTF-8
{
    "scope": "\"admin openid\"",
    "access_token": "\"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9xxxxHVcA76zjsGN2w...\"",
    "token_type": "\"Bearer\"",
    "expires_in": 21599,
    "refresh_token": "21599",
    "id_token": "string"
}
string
scope
Optional

the scope of the access token issued. The value is expressed as a list of space- delimited, case-sensitive strings.

string
access_token
Optional

the requested access token. This token can now be used to call VMware Identity Manager APIs. For example, with the 'Bearer' token type, use 'Bearer <this access token value>' as the 'Authorization' header. The access token is a JSON web token (JWT).

string
token_type
Optional

the access token type. It provides the client with the information required to successfully utilize the access token to make a protected resource request. For example, the 'Bearer' token type is utilized by simply including the access token string in the request: Authorization: Bearer mF_9.B5f-4.1JqM

integer As int64 As int64
expires_in
Optional

the time (in seconds) this token expires. If the return value is positive, the access token is going to expire in that many seconds. If the return value is 0, the access token already expired.If the return value is -1, token state could not be determined, since the access token doesn't contain expiration value.

string
refresh_token
Optional

the refresh token associated with the access token, if any. This refresh token can be used to request a refresh for the associated access token.

string
id_token
Optional

ID Token value as defined by OpenID Connect 1.0


400

The error can be any of those: the provided grant type is not supported, the request is missing a required parameter, the provided authorization grant is invalid, the authenticated client is not authorized to use this authorization grant type. The error description will contain 'error' and 'error_description' fields. See the OAuth2.0 spec for further details.

Operation doesn't return any data structure

401

Client authentication failed (e.g., unknown client, no client authentication included, or unsupported authentication method). Check the 'Authorization' header.

Operation doesn't return any data structure

405

The HTTP method might be incorrect, make sure you use the POST method.

Operation doesn't return any data structure

500

The grant_type is incorrect or absent.

Operation doesn't return any data structure