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:
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:
|
HTTP 400 |
If the response is HTTP 400, a generic error appears with a customized description for this particular endpoint.
|
HTTP 401 |
If the token is invalid or there are session errors, this API call returns:
|
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 }