Configuring Postman as a third-party client application for OAuth 2.0

Prerequisites

The following prerequisites must be met before you begin.

• You must install Postman. Postman may be downloaded from https://www.postman.com/downloads/.
• You must register Postman as a client application with the Hybrid Data Pipeline server to obtain a client ID and client secret. See Register the client application with the Hybrid Data Pipeline server for details.
• You must create an OData-enabled data source. See Create an OData-enabled Hybrid Data Pipeline data source for details.

Configure Postman as a client application

Take the following steps to configure Postman to access Hybrid Data Pipeline resources.

1. Open Postman.
2. Select the Authorization tab.
3. Select OAuth 2.0 as the authorization type.
4. Select Request Headers from the Add authorization data to dropdown.
5. Complete the Configure New Token form. For example:

   Grant Type: Authorization Code

   Callback URL: https://www.getpostman.com/oauth2/callback

   Auth URL: https://my-hdp-server-host/oauth2/authorize

   Access Token URL: https://my-hdp-server-host/oauth2/token

   Client ID: eeee5555-66dd-7777-9999-fffff333333c

   Client Secret: 9999tttt-gg22-1212-0606-bbbbb444444z

   Scope: api.access.odata

   Example Configure New Token form:

   
6. Press Get New Access Token.

   The Hybrid Data Pipeline login dialog appears.

   
7. Enter Username and Password in the dialog. Then press Authenticate.

   The consent dialog appears.

   
8. Press Allow to grant Postman access to your account.

   The Manage Access Tokens dialog appears.

   
9. Press Use Token to use the access token for access to Hybrid Data Pipeline.
10. Send the following request to obtain the metadata of your data source.

    GET https://my-hdp-server-host/api/odata4/Oracle_OData/$metadata

    The metadata on the OData endpoint is returned.