Skip to main content

Access Tokens

To obtain an access token using Authentication Service, you must have already created at least one TSG and created a service account that has role-access assigned to it. When you did these things, you obtained:

  • A TSG ID, which you use to identify the scope of the access token.
  • A Client ID
  • A Client Secret

Using this information, you can use POST /oauth2/access_token to create an access token. Be aware that:

  • The FQDN for the authentication service is different from the rest of the Strata Cloud Managers APIs. It is:

    https://auth.apps.paloaltonetworks.com

  • This API uses basic auth. Use your Client ID for the username, and Client Secret for the password.

  • Use the scope field to provide the TSG ID.

For example:

curl -d "grant_type=client_credentials&scope=tsg_id:<tsg_id>" \
-u <client_id>:<client_secret> \
-H "Content-Type: application/x-www-form-urlencoded" \
-X POST https://auth.apps.paloaltonetworks.com/oauth2/access_token

Note: The service account that you use to authenticate this request must belong to the TSG that you identify on the scope field. See Acess Token Scopes for more information.

Access tokens have a lifespan of 15 minutes.

Check your access token credentials​

If your access token is incorrect, the API request may not go through, and the resulting error indicates an invalid authorization code.

You can check your access token's credentials by pasting the access token into https://jwt.io/ . This decodes the token to determine whether the actual set of credentials matches the set of credentials present in the access token.

The example below shows an encoded access token and the same access token decoded. The decoded access token shows that the TSG_ID is 1838006364.