GET Authorize/Verify

Verifies whether the caller's bearer token is still valid.

Requirements

Permissions: The caller is not required to have any special permissions.
Token scope: Any valid scope, such as Agent, Certificate, or SSH

Headers

Content type: Content-Type:application/json.
Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.

Parameters

None. However, in the request URL, specify vedauth. For example, GET https://tpp.venafi.example/vedauth/Authorize/Verify.

Returns

If the token is still valid, this API call returns HTTP 200 and a confirmation message. Otherwise Authorize/Verify returns a HTTP 401 and the following data:

Response description
Name	Description
HTTP 200	This method returns information about the bearer access token and grant. For valid requests, Authorize/Verify returns a HTTP 200 message; and the following data. All times reflect the VEDAuth server time. The length of time depends on Remote tree settings: access_issued_on: The time that Vedauth issued the access token. Appears in the .NET JavaScriptSerializer or JSON format. access_issued_on_ISO8601: The corresponding issuance time of the access token. Appears in the Universal Time Coordinated (UTC) format, including time zone. access_issued_on_unix_time: The corresponding issuance time of the access token. Appears in the Epoch format. application: Case sensitive. The value must match the Client ID in the API integration. For more information, see Setting up token authentication. expires: The grant expiration time—not the token expiration time. Appears in the .NET JavaScriptSerializer or JSON format. After this time, you can no longer refresh the token. expires_ISO8601: The corresponding grant expiration time. Appears in the Universal Time Coordinated (UTC) including time zone. expires_unix_time: The corresponding grant expiration time. Appears in the Epoch format. For example, the number of seconds since January 1st, 1970 at UTC. grant_issued_on: The grant authorization time. Appears in the .NET JavaScriptSerializer or JSON format. grant_issued_on_ISO8601: The corresponding grant authorization time. Appears in the Universal Time Coordinated (UTC), including time zone. grant_issued_on_unix_time: The grant authorization time stamp. Appears in the Epoch format. identity: The PrefixedUniversal identifier of the caller that can use the grant. scope: The access token scope that is the authorized range of resources that identity can use. valid_for: The number of seconds that VedAuth issued for this token. For example, 7776000 is 90 days. The value matches expires_in from an Authorize response, such as POST Authorize/Oauth.
HTTP 400	If the response is HTTP 400, a generic error appears with a customized description for this particular endpoint. Error invalid_client: Browser-based authentication is disabled. invalid_request: The client_id is missing or an internal error occurred. invalid_scope: The requested scope is missing, expired, revoked, malformed, or exceeds the scope from the API Integration in the UI. invalid_grant: Details vary based on the Authorize request. Reasons for this error include: The Authorize user ID and password was either invalid or missing. A scope is not allowed for the particular API integration. The device_code from POST Authorize/Device is expired or invalid. The client_id must match the Client ID in the UI API integration. unauthorized_client: The Venafi user is not authorized for this authorization grant type. Error_description: If available, additional information about how to retry the request.
HTTP 401	If the token is invalid or there are session errors, this API call returns: error: The type of error. error_description: The session error description.

Example: Is the caller's token still valid?

Request

GET https://tpp.venafi.example/vedauth/Authorize/Verify
Authorization:Bearer 4MyGeneratedBearerTknz==

Response

HTTP/1.1 200 Token is valid
{
   "access_issued_on":"/Date(1604956045163)/",
   "access_issued_on_ISO8601":"2020-11-09T21:07:25Z",
   "access_issued_on_unix_time":1604956045,
   "application":"TPP.Auto",
   "expires":"/Date(1636492045163)/",
   "expires_ISO8601":"2021-11-09T21:07:25Z",
   "expires_unix_time":1636492045,
   "grant_issued_on":"/Date(1604956045163)/",
   "grant_issued_on_ISO8601":"2020-11-09T21:07:25Z",
   "grant_issued_on_unix_time":1604956045,
   "identity":"local:{8e1bf110-8ef8-4a53-a6da-d5d29c983451}",
   "scope":"certificate:manage;configuration:manage;security:manage",
   "valid_for":7776000
}