IdentityNow (IDN) Postman Collection

SailPoint V3 API Postman Collection

Postman is a popular tool for testing out APIs via a graphical interface. This guide will show you how to import our SailPoint Identity Security Platform Postman collection and configure it to work with your IdentityNow tenant.

Importing the Collection

To import our V3 APIs Postman collection, open up your Postman app and click the “Import” button in the top left. Select the “Link” tab and paste the following URL: https://www.getpostman.com/collections/c824c8e69dcea280088f

image

Select “Continue” and then “Import” to import the collection into your Postman library.

Configuring the Environment

Once you have imported the collection, you will need to setup an environment and configure a few variables. These variables are referenced throughout the collection, and will need to be configured for your specific IDN tenant.

To create the environment, click “New” in the top left and select “Environment”. Give your environment a name and create three variables:

  • clientId: The client ID of your personal access token
  • clientSecret: The client secret of your personal access token
  • tenant: Your specific IDN tenant (i.e. https://{tenant}.identitynow.com)

If you don’t have a personal access token, you can generate one by following this guide. Your environment should look like this:

Make sure your environment is selected by using the environment dropdown in the top right.

image

Generating an Access Token

Access tokens generated from a Personal Access Token are valid for 12 hours. When using this collection for the first time, or when your token is expired, you will need to perform the following steps to generate a new access token.

  1. Edit the Collection
  2. Under the “Authorization” tab, click the “Get New Access Token” button.
  3. If successful, you should be presented with the following screen. Click “Use Token” to use the access token in your requests.
  4. Finally, click the “Update” button in the bottom right of the “Edit Collection” screen to update all of the requests in the collection to use the new token.

Using the collection

The V3 API endpoints are organized in folders by the type of resource they manage. To test your access, click on the “public-identities” folder and click on the “Get a list of public identities” endpoint. You will see a list of available query parameters. Uncheck all of them except for the “limit”, and set the “limit” to 3.

Click the “Send” button and you should receive a 200 OK response from the server with an array of JSON objects in the body.

5 Likes