Manage Okta through API’s with Postman

The GUI in Okta is powerful in itself, but like many other products there is a lot more under the hood. This post will show you how to access your Okta organisation (instance) through the integrated API’s with Postman.

As the developer of Postman states: “Supercharge your API workflow with Postman! Build, test, and document your APIs faster. More than a million developers already do.…”  and it can be downloaded here.

Basically you need to do 3 things:

  1. Generate a Token in Okta
  2. Install and configure Postman
  3. Download API collection packs from Okta

​​

Here is how you do it:

1. Generate a Token in Okta

  • Log in on your Okta webpage with an administrator
  • Navigate to the Admin console
  • Click Security and then API
  • Click the ‘Generate Token’ button
  • Enter a name and click Create Token
  • Here after the Token is shown as below:

  • Copy the token value and save it somewhere safe. Once you click ‘OK, got it’ you won’t be able to see the token value again!

2. Configure Postman

  • Start Postman (from Google Chrome or from the Start Menu)
  • In the top right corner click ‘No Environments’ and then click ‘Manage Environments’

  • In the next window click Add
  • Create two new rows. “url” with your Okta web address and “apikey” with your Token value:

  • Click submit
  • Hereafter select your new environment from the dropdown box:

3. Download API collection packs from Okta

  • Okta have provided 9 collections available for download here:

Postman Collection

Authentication API

Sessions API

Users API

Factors API

Groups API

Admin Roles API

Apps API

Schemas API

Events API

  • To import them (one at the time) click the Import button in top
  • Then click “download from Link” and past the link. E.g.

  • The collections will show up on the left hand side:

  • Select one and click Send to verify that it works. From here you are ready to take full advantage of Okta’s APIs.
Advertisements
This entry was posted in Uncategorized and tagged , , , , . Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s