Creating an extended integration for Postman users

Let Oomnitza be your single source of truth!

You'll get complete visibility of your users as data from Postman is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Postman in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key user information
• Configurable reports to share information about users with your colleagues and management
• Configurable user workflows that you can easily create such as:  
  • Workflows for deactivating and reactivating user accounts
  • Workflows for deactivating SaaS users

Navigation

Add credentials

Create the user integration

Create workflows

Before you start

To stream Postman user data into Oomnitza, you must add the token name, which is X-Api-Key, and the API key for your Postman API to the credentials vault in Oomnitza.

The Postman integration with Oomnitza is available for Enterprise and Business accounts.

Useful links

Generate Postman credentials

Add credentials to the vault in Oomnitza

To authorize connections between Oomnitza and Postman , complete these steps:

1. Log into Oomnitza.
2. Click Configuration > Security > Credentials, and then click Add new credential (+).
3. Add the information details.
4. Click the AUTHORIZATION tab.
5. As authorization type, select API Key.
6. Enter X-Api-Key as the token name.
7. Enter the API key.
8. Ensure that Add to Header is selected.
9. Click CREATE.

Next

You use the credentials that you added to create and customize your Postman integrations with Oomnitza.

Create the user integration

Info and connect details

1. 1. 1. Click Configuration > Integrations and then click Integrations List View .
      2. On the Integrations page, scroll down to the Extended section for User Integrations.
      3. Click NEW INTEGRATION.
      4. In the New User Integration sidebar, click Postman. 
      5. Click APPLY and then click NEXT twice.

Connect page

Best practice
To ensure that only live user records are streamed from Postman to Oomnitza, choose Update only as your integration preference. When you run the integration, you can check the error logs to see which user records weren't uploaded and why they weren't uploaded. You can then decide whether to upload the user records that were skipped by changing your integration preference to create and upload. See Access error logs.

1. Enter a descriptive name for the integration such as Postman Users. That'll be the name of the user integration that is shown on the Integrations page.
2. From the User Selection list, select User plus SaaS User or User only.
3. If you select User plus SaaS User and you have multiple instances of the same SaaS application, select the application from the SaaS Selection list. If you have a single instance of the SaaS application, skip this step.
4. From the installation type list, select Cloud.
5. From the Credentials list, select the credentials for Postman.
6. From the Integration Preferences list, select Update only.   
7. Enter the name of the user of the integration.
8. Click Next.

Mappings

Map the Postman fields to Oomnitza fields and create custom mappings to get the user information that you need.

Complete these actions:

1. Click SMART MAPPINGS.
2. Create custom mappings to map the Postman fields that you want to add to Oomnitza:
   1. Click the down arrow on the field that you want to map.
   2. Select Add new Oomnitza users field.
   3. Change the name of the field. For example, you can change the name of the ID field to Postman ID.
   4. Click CREATE. 
3. Assign an Oomnitza role to the users such as Employee.
4. Assign the sync key to the Username field as this is the email address of the user.
5. Click NEXT.   

Custom Postman to Oomnitza mappings

The following Postman fields can be mapped to Oomnitza:

• • • Connector Sync Time
    • Created
    • External Id
    • Id
    • Family Name
    • Given Name
    • Is Active
    • Last Modified
    • Last Modified
    • Resource Type
    • Username

Want to map more fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping the Postman to Oomnitza fields, click NEXT.

Schedule

By default, user data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Create workflows

To reduce your workload and automate complex and repetitive tasks, you can use the following API presets:   

• Deactivate user. Users are removed from the teams they are a member of and can no longer log into Postman. Their accounts aren't permanently deleted.
• Reactivate user. Users are added back to the teams they were a member of, and their login is reactivated.

1. Click Configuration > Workflows > SaaS Users.
2. Click Add (+). The Begin and End blocks are automatically added to the sandbox.
3. Enter the name and a description of the workflow. 
4. Edit the Begin block by choosing a schedule and adding the rules that will trigger the workflow. For example, add the rule Name equals Postman, and a rule to trigger the workflow.
5. Click the Blocks tab, and  drag and drop the API block onto the canvas.
6. Click the Edit button.
7. Enter Postman in the search field and and choose one of the following presets:
   • Postman Deactivate user
   • Postman Reactivate User
8. Click SAVE.
9. Connect the blocks.
10. Validate, launch, and save your workflow.

Use the SaaS User Role Retrieval block to deactivate users

1. Click Configuration > Workflows > SaaS Users.
2. Click Workflow and select SaaS Users.  
3. Click Add workflow (+).  The Begin and End blocks are automatically added to the canvas.
4. Enter the name of the workflow and a description.
5. From the Integrations section, drag and drop the SaaS User Role Retrieval block onto the canvas.
6. Edit the SaaS User Role Retrieval block.
   1. To find the preset, type Postman.  
   2. Click the right arrow (>) next to Postman SaaS User Role.
7. Edit the Begin block.
   • Create a schedule for running the workflow.
   • Use a rule to identify the SaaS software 
   • Add rules to trigger the workflow . For example, you can add a rule to deactivate users who haven't logged in for a number of days. 
8. Connect the workflows.
9. Validate, save, and launch the workflow.

 Understanding workflows

 Workflow block overview 

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your users and software
• Configure custom reports about your users and software
• Create workflows to automate tasks

 Getting started