Applies to ReadyAPI 2.7, last modified on June 25, 2019

In the Automated Token editor, you can use scripts to automate retrieval of OAuth 2.0 tokens. You can use JavaScript to create interactions with authorization pages provided by the authorization server.

How It Works

For each page involved in the authorization process, you add the corresponding field in the editor. In each field, you place the JavaScript code that performs the authorization actions required for that page.

The script specified in a field will run when the page is open in the browser. You can find an example of this script in the OAuth Automation Example topic.

Note: During the authorization process, the pages are called in the specified order. ReadyAPI neither recognizes the called pages nor does it interact with them. To ensure that you are on a proper page, use scripts.

In the Auth Manager

The Automated Token editor becomes available on the Automation Scripts tab after you select an OAuth 2.0 profile in the Auth Repository:

Auth manager

Click the image to enlarge it.

On the Auth Tab

In requests, you can access the Automated Token editor from the Auth inspector:

Auth manager

Click the image to enlarge it.

  1. Select an OAuth 2.0 Profile.

  2. Click Get Token.

  3. Click Automation.

Automating Token Retrieval on Request

By default, ReadyAPI does not check if a token has expired even if automated retrieval is enabled. You can use Groovy scripts to check if a token is up-to-date and retrieve a new token, if necessary. For this purpose, call the requestAccessToken method and specify the consoleMode parameter as described in the Automating Token Retrieval Example topic.

Additionally, on headless machines where the browser window is inaccessible, you can use this approach to retrieve a token.

See Also

Using the Automated Token Script Editor
OAuth Automation Example
Automating Token Retrieval

Highlight search results