šŸŽ‰ Postman: Incoming Fixes and Improvements! šŸŽ‰

Announcements Community Updates
1

postman
postman1200Ɨ630 92.5 KB

:bangbang:We sincerely apologize to those of you who may have received 100+ emails from Postman about the updates to the workspace/collection. Unfortunately this was out of our control and a ā€œfeatureā€ of the Postman platform. We will reach out to Postman about a solution to this for future updates.

We love all the feedback weā€™ve received over the last 5 months on how youā€™ve all been using our official Postman workspace and the different ways youā€™ve made changes or improvements. Today, weā€™ve made some improvements to the IdentityNow workspace that require your attention! We will retroactively update the Postman guide on this, but weā€™ll let you know here as well.

As always, let us know your thoughts here!

Changes

  • Pre-request script now works in the browser
  • Pre-request script no longer fails the first time a request is ran
  • Endpoint versions were moved from from a collection variable to each endpoint
  • You can now fully utilize Postman environments for each IdentityNow environment you have (no more workarounds needed)
  • Added consistency to variable naming conventions
  • Added official environment to the IdentityNow Postman workspace

How to Update Your Postman Environment

Youā€™ll notice that some of these changes were ā€œbreaking changesā€ to your Postman environment. Hereā€™s what you need to do to get your Postman collection back in order:

Pull the Latest Changes

Right-click on your collection, and click Pull Changes to update your collection.

image
image844Ɨ970 55.2 KB

Update Your Postman Environment(s)

With this update, weā€™ve added an environment to the postman workspace which you can fork in the same manner that you did the collection. This will allow you to get updates to the environment in the future as we continue to add new capabilities to our workspace. In case you decide to keep your own, these fixes/improvements mean youā€™ll need to update your environments. You will need the following environment variables in your Postman environment:

:bangbang:Be sure you do not have baseUrl in your environment variables.

Environment Variable Required Description
tenant * This is your IdentityNow tenant, typically your companyā€™s name.
clientId * This is the client ID for the API client or personal access token.
clientSecret * This is the client secret for the API client or personal access token.
domain This field is optional and is only needed for a select few who may have a domain in their API URL that differs from ā€œidentitynowā€.
7 Likes
2

This is great @derek_putnam!
I had a question on the way the APIs will update when we hit ā€œPull Changesā€ on the Postman collection. If my APIs have been saved with some data like the JSON body, some query parameters etc., do they have to be reconfigured again after the update, or will the changes not affect that?

Also wanted to understand what happens to an existing JSON body when, say, the newer versions make changes to the JSON body syntax/structure. Iā€™m guessing that would need some manual changing, but I could be wrong.

3

Hey Sushant,

Thatā€™s a really great question. Iā€™m going to see if I can find a way to test this with Postman today, because Iā€™m not actually sure what would happen there. In the meantime, what I can tell you is that we did not make any changes to any request bodies or query parameters. We only made changes to:

  • collection-level auth
  • collection-level variables
  • collection pre-request script
  • URLs for each endpoint
4

Got it, thanks Jordan.
Iā€™m sure this is really going to save a ton of time and simplify testing on multiple tenants! :tada:

1 Like
5

Absolutely! Let us know what you think :slight_smile:

6

Promising start, but hit a question pretty quick. New variable on the Beta {{accessToken}} is not defined anywhere from what I can tell. Where/How is the {{accesstoken}} supposed to be defined and populated? Thanks!

7

That will be created by the pre-reqeust script the first time you run a call. Give it a run and let me know what happens.

8

Hello @sushant1,

I just tested this out and the ā€œPull Changesā€ will not overwrite any post JSON bodies or query parameters.

If there are any conflicting parameters, for example if we updated the offset parameter to 5 from 0 on one of the GET calls. Postman would recognize the difference and ask you if you would like to merge in the new changes.

Let us know if you have any other issues!

2 Likes
9

Thanks @tyler_mairose @derek_putnam!

Iā€™m also working on a collection runner on Postman that we can use to semi-automate deployments with IdentityNow APIs. For now, the API calls have to be made manually (unless an external app is built which leverages the APIs) and that can sometimes be time consuming during large deployments/migrations.

I have a thread added here, and will keep you posted if I could make any progress on that front! But please let me know if you have any ideas, as this has potential to reduce a ton of unintended human errors.

10

I canā€™t figure out how to authenticate now that Iā€™m using your latest greatest in Postman. Previously, in Postman, I would open the top level (IdentityNow Beta APIs) and use options on the page that opened to ā€œGet New Access Tokenā€; the individual endpoints had ā€œInherit from parentā€. And everything worked.

Now with the forked collection that specifies ā€œBearer Tokenā€, I have the client/secret on the enviornment still, but on the collection there is not a ā€œGet New Access Tokenā€ button. When I run the ā€œList Latest Invocation Statusesā€ endpoint, I get the error

{
    "error": "invalid_token",
    "error_description": "Cannot convert access token to JSON"
}

Unfortunately with Event Triggers, logs are only available for 24 hours so I only have until ~9pm EST to get the logs or we will have to complete another load test. So even though this is ā€œDeveloper Daysā€ I sincerely hope someone has time to point me to guidance. Thanks!

11

Hello Jordan,
Can I get the link to the most recent postman collection? I am unable to generate an access token despite setting up the environment credentials witht the tenant name & client ID and client secret.

There was an error in evaluating the Pre-request Script:Error: Unexpected token u in JSON at position

12

Hey Zenia,

Someone from my team will reach out to you in a direct message to help :slight_smile:

13

Hi @derek_putnam ,

I have created a global variable with tenant, clientID and Secrete but still gets same error:

I am getting below error in Postman console:

~ POST https://undefined.api.identitynow.com/oauth/token

Error: getaddrinfo ENOTFOUND undefined. api.identitynow.com

~ Request Headers

User-Agent: "PostmanRuntime/7.32.3'

Accept: "*/*"

Postman-Token: "5404099d-b300-4189-a6d0-d8e84b0819c8'

Host: "undefined.api.identitynow.com

Accept-Encoding: "gzip, deflate, br"

Connection: "keep-alive"

ā€¢ Request Body
14

why am i getting host as undefined.api.sailpoint.com?

15

Hey @dheerajk27,

This would indicate that the tenant variable is not being parsed correctly.

Can you share how exactly you configured that variable?

16

Hi @LukeHagar ,

Thankys for the response, below is my Global environment entry:

image
image2880Ɨ1800 297 KB

And below is the postman call:

image
image1895Ɨ1155 142 KB

17

Hi @LukeHagar,

Looks like issue was with my environment which is fixed now.

1 Like
18

Good morning. Iā€™m getting deeper into APIs, and Iā€™m setting up my workspace. Iā€™m getting the following error when running GET List Transforms:

There was an error in evaluating the Pre-request Script:Error: Unexpected token u in JSON at position 0

19

I am facing the same issue. How did you fix it, please ? what was with your environment ?

20

Hi and Hello,

It seems like the error youā€™re encountering in Postman is due to a JSON parsing issue in your pre-request script. The message Unexpected token u in JSON at position typically indicates that the parser expected a valid JSON token but found ā€˜undefinedā€™ instead. This usually happens when trying to parse something that isnā€™t properly formatted as JSON, or when a variable expected to contain JSON data is actually undefined .

Can you give more info? @aghzere

You can also:
Here are a few steps you can take to troubleshoot and resolve this issue:

  1. Check the Variable Values:
  2. Validate JSON Content:
  3. Debugging the Script: Add console.log()

Regards,
Adam

2 Likes