Postman Collections

This section contains various Postman collections, which can be used to manually test iSHARE APIs. In these collections, you as a user are impersonating Test participant ‘ABC Trucking’.

In order to impersonate ABC Trucking, these Postman collections contain the private key of ABC Trucking. For non-dummy parties, private keys should never be shared with the Scheme Owner or other iSHARE Parties

Each collection contains all API endpoints of a specific Test participant, and as ABC Trucking you are able to consume these API endpoints.

Downloads

In order for the collections to work, please download iSHARE environment and globals. Then download the following Postman collections:

• ABC Trucking and the Scheme Owner (only for iSHARE framework version 1.x)

• ABC Trucking and the Satellite (from iSHARE framework version 2.x onwards) and its releated environment

• ABC Trucking and Warehouse 13

• ABC Trucking and the Authorization Registry

• ABC Trucking and Awesome Widgets

• End-2-End flow: ABC Trucking gets container data from Warehouse 13 (Service Provider requests Delegation Evidence)

• End-2-End flow: ABC Trucking gets container data from Warehouse 13 (Service Consumer provides Delegation Evidence) (Service Provider requests Delegation Evidence)

Instructions

To request an access token:

• Open the /token request

• The client_assertion is generated in the background

• Run the request without making additional changes, the response should contain (among others) an access token value

To request a service:

• Open a service request

• The access token is automatically copied.

• Run the request, the response should contain (an encoded) response

• If the response is encoded, decode the token via jwt.io and inspect the results

Tip

For /delegation service requests please view the demo in the next section, this will explain how authorization in iSHARE can work and Postman examples are shown.