The following information is required to validate an access token:
NOTE: Some client IDs may not have the permissions required to validate tokens. When requested, this permission is granted on a case by case basis.
An access token is validated by making an HTTP GET to our validation endpoint. The specific endpoint used will depend upon your instance’s environment type:
http://tngo-prod-oauth-ping-validator.cloudhub.io
http://tngo-qa-oauth-ping-validator.cloudhub.io
To validate an access token, the following query parameters need to be passed with this GET request:
Query Parameter | Description | Example |
---|---|---|
access_token | The access token to be validated. | jf8ANPs5ETFT1RPnfJnZpbcWjz2f |
The following is an example of a GET request to validate a token:
https://oauthqa.tangoe.com/as/token.oauth2?grant_type=urn:pingidentity.com:oauth2:grant_type:validate_bearer&token=8jmFdZdww2h3FDYNJEHXgvtnXbdc&client_id=286ff94127c8801e9227d89337c14351&client_secret=72g30d2857fo4a41A9525345572AC72LK
The following is an example of a response that might be returned:
{
"scope": "MOBPROC",
"expires_in": 7186,
"client_id": "286ff94127c8801e9227d89337c14351",
"access_token": {
"platform": "command",
"tenant": "XYZ",
"multitenant": "false",
"domain": "*",
"identityProvider": "pcv_edge",
"identifier": "api.account.xyz"
}
}
The following properties are returned in the token validation response:
Property | Description | Example |
---|---|---|
scope | OAuth scopes that are associated with the access token being validated. | MOBPROC |
expires_in | Number of seconds that the access token will be valid. | 7188 |
client_id | Tangoe-assigned client ID for the API client application that requested the access token being validated. | a98b70cddd5f1432221360bd732f5ec1 |
platform | Source system that is associated with the access token. | command |
tenant | The Tangoe-assigned code that identifies the client account. | ABC |
multitenant | Boolean to indicate that caller has access to data for more than one tenant. | false |
identityProvider | Identifies the authenticating entity. | pcv_edge |
identifier | Identity that was authorized by security provider (e.g., Ping). | api.account.xyz |