Delegation

Obtains delegation evidence

Used to obtain delegation evidence from an Authorization Registry. The response is a signed JSON Web Token. Please refer to the models ‘jwt_header’ and ‘jwt_payload_delegation_evidence_token’ which indicate what the decoded response will look like. Please refer to the iSHARE language of delegation in order to understand the decoded response data model.

post

/delegation

Authorizations

Body

delegationRequestobjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://isharetest.net/delegation' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"delegationRequest":{"policyIssuer":"text","policySets":[{"policies":[{"rules":[{"effect":"text"}],"target":{"actions":[null],"resource":{"type":"text","identifiers":[null],"attributes":[null]}}}],"target":{"environment":{"licenses":[null]}}}],"delegation_path":[null],"previous_steps":[null],"target":{"accessSubject":"text"}}}'

200

{
  "delegation_token": "eyJ4NWMiOlsiTUlJRCtEQ0NBdUNnQXdJQkFnSUlBanRmMEdYM0JiUXdEUVlKS29aSWh2Y05BUUVMQlFBd1BERTZNRGdHQTFVRUF3d3hWRVZUVkNCcFUwaEJVa1VnUlZVZ1NYTnpkV2x1WnlCRFpYSjBhV1pwWTJGMGFXOXVJRUYxZEdodmNtbDBlU0JITlRBZUZ3MHlNekF5TWpjd09URTNOVFJhRncwek16QXlNalF3T1RFM05UTmFNSUdETVNzd0tRWURWUVFERENKcFUwaEJVa1VnVkdWemRDQkJkWFJvYjNKcGVtRjBhVzl1SUZKbFoybHpkSEo1TVJ3d0dnWURWUVFGRXhORlZTNUZUMUpKTGs1TU1EQXdNREF3TURBME1SUXdFZ1lEVlFRTERBdFVaWE4wSUdGdVpDQlJRVEVUTUJFR0ExVUVDZ3dLYVZOSVFWSkZWR1Z6ZERFTE1Ba0dBMVVFQmhNQ1Rrd3dnZ0VpTUEwR0NTcUdTSWIzRFFFQkFRVUFBNElCRHdBd2dnRUtBb0lCQVFDaGd5dTVXK1Y4UGc4KzVCcStHVHREdUZ3Qi9ZUlRraDdRbTV0SWhyaTgxNlFQVitRU2ZRYW1mZ01iSGV0WmNrS2NBcThaaUVGQVNLTjRIVzkxU3FTMU9sTUYyeFVpaHZYYWpBQ3ZyTDJwRU5PK05pcURNSVE1Q3E2c1h6T3U3anVKejlyUCtpWUo1R0dpWmQ3YlpLemZGenlWcTZZUVZjaitHNUpSazY0ZWxkYzQvcTN2NE9XZnpIdkZnWUV5Y2EvZmt0SXVjZUZ2SnZ4QTEzZmozRDJSQUcybHNHVkRZQUt4by9rSFBkSVczUTMrRzJXcnlBTGk0Wm9GanZ5YTQ5N0ZUNE9aaGlGSnBqdURzaG9xY1hzWldacEZEUGNINHUveVZTck84bkZxNmlqVXU1UzRSTTNJMEhUWk5HeUk4eWVKQ0pVc0dIYWNIeFhYTHRHeGJROVZBZ01CQUFHamdiVXdnYkl3SHdZRFZSMGpCQmd3Rm9BVWJjVmxpY3Zma1ZUUmF6eTNBcVV1ellwb2tCMHdKd1lEVlIwbEJDQXdIZ1lJS3dZQkJRVUhBd0lHQ0NzR0FRVUZCd01FQmdnckJnRUZCUWNEQVRBM0JnZ3JCZ0VGQlFjQkF3UXJNQ2t3Q0FZR0JBQ09SZ0VCTUFnR0JnUUFqa1lCQkRBVEJnWUVBSTVHQVFZd0NRWUhCQUNPUmdFR0FqQWRCZ05WSFE0RUZnUVU5VGdVRTViYmk0SnBCSm9yK205SU8wY2l0NWN3RGdZRFZSMFBBUUgvQkFRREFnYkFNQTBHQ1NxR1NJYjNEUUVCQ3dVQUE0SUJBUUJDSGx4UG1QdmlNeVdFaFRhRFBIVlpyVklpTkJ6SHZ3My9qMGdrZWRFbGowOFV4dUk1NW45WmFzUTVqMEZKRzk2aDFic244cFJ4bUFaNk4wVFJVTE9TS3E4UzFqeHR0ZmlYOVBKNWwxQ1kxRFZWakI5U0tBcXRiamFtanBXVFMzREtubkUxSDBpc1czVkxxOGRCOTZyWWVLMUpaTE1LdnB1Q1hVYVd1TzlwRmhPREQ0RVMvR3F5Qkp6TGhEQmhXaUNtNUVTMW5hZXFXZW9vSEs4bzVXWUYyZ29LSVdoUEJ4Q3NUOURxZVJ3MXV2WVNOaHZZaVZmb3ZiWVBGZno0ZG5kODBYRUwxeDM1NDB4Nmw1VytJOFVXSzNTZWs0SnJabVIyVlFZYlBLaUZaYmpKejJFVFduK3FYNE90bE92cVl1QkF5WFBnWE91MUdsWmYyNEpBdjR0eSIsIk1JSURTRENDQWpDZ0F3SUJBZ0lJU3hSM0ltekcxQmN3RFFZSktvWklodmNOQVFFTEJRQXdKekVsTUNNR0ExVUVBd3djVkVWVFZDQnBVMGhCVWtVZ1JtOTFibVJoZEdsdmJpQmxTVVJCVXpBZUZ3MHhPVEF5TWpJeE1EQTBNekZhRncwek9UQXlNVGN4TURBeU5EbGFNRHd4T2pBNEJnTlZCQU1NTVZSRlUxUWdhVk5JUVZKRklFVlZJRWx6YzNWcGJtY2dRMlZ5ZEdsbWFXTmhkR2x2YmlCQmRYUm9iM0pwZEhrZ1J6VXdnZ0VpTUEwR0NTcUdTSWIzRFFFQkFRVUFBNElCRHdBd2dnRUtBb0lCQVFESEIyQUJRTDd6d21pMXhJa08wYTJxNmpJSmRuM1FBbTBzMWxTZVFldjlGMkYzTTVaOHFpcVFKYXVyTVp5d1pmZE52ZzkrSXFHSE9qRGU2aElodVJ6em9BbzBBYk80TjlPZGYyUkREVTk1Tjd0b0ptQXlDaVlHZ1pmWnQ3QnNLRkllUTZwNkNzZ0tjUlhQaTBmZFhkVlNIcDRiWmZRT1FkY2xNYnRJVGlybkZ0VTA2TlBBaG9ZNjc2WXo5NnhGQUUwem9tNmVNVlBQT0ltMEc4Z2Q0NFhsbmJMMHcwbWNjQ2kyVlVaanZDSUw1OU82MU84dmxWeUxzQnFOTlRDdmY5QzJDTVlhRWF0WFp5ei9sd2dINkpZSHREMHVzWHQvK00wcUtZZTFvZW9MazBaaWNGWlhjazFpUzA5a0ZkZ2dLNUJsTm9kb1dKYURCUnJvNTFXaFkyV25BZ01CQUFHall6QmhNQThHQTFVZEV3RUIvd1FGTUFNQkFmOHdId1lEVlIwakJCZ3dGb0FVbFpNa3lieWhDeks1SE9CRkhLUk8rTUxTUi80d0hRWURWUjBPQkJZRUZHM0ZaWW5MMzVGVTBXczh0d0tsTHMyS2FKQWRNQTRHQTFVZER3RUIvd1FFQXdJQmhqQU5CZ2txaGtpRzl3MEJBUXNGQUFPQ0FRRUFaSDVRanVxK085RnB2NjM3ZzBjRjZuMUlMWUJMejFlTlpqRUIzZG9BZXh2aTVDelN3M29zd0pDU2VkR1czaGgwcUhPVEsyZ0k4M2poMFcyRUFuMmlzRmd3aE1vRzJqZDJZU0ZTa204US8yZU9mYzZNZ0dTQzVzT1RMNzVKN2J5TENvcmRxZC9ONGVhajNFcUtMYVdxN3I3dXN0UDgxUDhFSWx6MEQ4YTdsZmYxRlNvMjNIV1hUV1gyK20ydm9MQUU1bDk3YUdUR1JTMVVieGhQMmpGS1lKOVh6aUtlOU1RSlNaRWxUUThqcWcya1BGa0V4L1hxQVdxbEcxZGwxeXdMSnE1aWVQdksxUjRBWU5JL1liWlFrOXNsajh2K1AvNk03RXRFcnNmMnVJU2dld0xUY1dsMjR4M25HNXhiUVp4clA4bDJqU0dZbU9USW5nS09RU25iZmc9PSIsIk1JSURNekNDQWh1Z0F3SUJBZ0lJQkxVMmNaQVpxTEV3RFFZSktvWklodmNOQVFFTEJRQXdKekVsTUNNR0ExVUVBd3djVkVWVFZDQnBVMGhCVWtVZ1JtOTFibVJoZEdsdmJpQmxTVVJCVXpBZUZ3MHhPVEF5TWpJeE1EQXlORGxhRncwek9UQXlNVGN4TURBeU5EbGFNQ2N4SlRBakJnTlZCQU1NSEZSRlUxUWdhVk5JUVZKRklFWnZkVzVrWVhScGIyNGdaVWxFUVZNd2dnRWlNQTBHQ1NxR1NJYjNEUUVCQVFVQUE0SUJEd0F3Z2dFS0FvSUJBUUNyRFAyRFdYMy9iOHVNYXB6RUJBVFNhNmlaZnZnZ3pJQlVFeGtXRWJHOWUxblZ5L2pRazIwbmZTRk1VbVJUNk5oWWNka1NZTy9XcmtpOVk0RXBDeTF4dlpIcUwrNFk2UzlKTFp3Sjc2MExwWWxlK05hVnU3bWluTVVRY3VvajVuS3pDbHZhemIwMEF4NWdrSlVmUjN2M1g1R1hxUXJrV2F6TXQrazVUTk02VFd1SjMwcU9md3JIeDV2VExtVFVVaWgrQnNHTDNmNUdPczFWVFlJQ05oaVRqTjc0bjJXcXAya1VMV0llKy9YNlJaL2hLc3BhSEdabktEVlR3SSs4Wm1XRmVqdXhBNkRPWDdSc1lMS3ZRTzIxRm1iSUJvU3M5QXp2NTkvUnhXVUpWTU8wV2hEaEtwUWdDR2p3Z1YzMm9mTmRrRmdtZFZ1bHpOUElEMlJOYlRUTEFnTUJBQUdqWXpCaE1BOEdBMVVkRXdFQi93UUZNQU1CQWY4d0h3WURWUjBqQkJnd0ZvQVVsWk1reWJ5aEN6SzVIT0JGSEtSTytNTFNSLzR3SFFZRFZSME9CQllFRkpXVEpNbThvUXN5dVJ6Z1JSeWtUdmpDMGtmK01BNEdBMVVkRHdFQi93UUVBd0lCaGpBTkJna3Foa2lHOXcwQkFRc0ZBQU9DQVFFQWx6YUJWYUZoWm1IOXV4c0xTdjNGa2t4V1Z3QlIxR2hBeHdjSmxWNHgra3FYOHRjaEo0U0RMRXVXUnJGNEROdHZTUjNyNjlLejhlWUk1WHVXMWVHMTJZakdHVmxZaWpkeHJHMUFOekduMnZkbzl2TDdkRUZVRU1LMUFLeFJzdGJUZEU3eXd6SVYvQzYxdzhKcnh3THR0OU9qZFVFVVBIdUdUanV2NW5GQlBkRnpPY3Z1K0RUTWw3M0NKUDJ6ZVpVRmd1ajU1TXNYWTQ1TXJYcmJndCtMSnFVdTRwa0IyYkx1OUZiZVJMV1pKdWtuWVNyVzRmeVFCWjJpK01zR2RpQktRY2YzZkxYanBjaDQ4L3A3U2lUazR1ZmxvQmFxVENsdC9FdFdYRFNtRmN2NFFqQmsxbVVQdTl2eGlrY0hEa0F2SnJPWEdnMGIrM2VJNGE3T1RmQWIxZz09Il0sImFsZyI6IlJTMjU2IiwidHlwIjoiSldUIn0.eyJpc3MiOiJFVS5FT1JJLk5MMDAwMDAwMDA0Iiwic3ViIjoiRVUuRU9SSS5OTDAwMDAwMDAwMSIsImp0aSI6IjdmYTFlYzM5YmFjMzRmZmZhMmNhNDgyMDFlNDhmMDNhIiwiaWF0IjoxNzExNDY2OTg1LCJleHAiOjE3MTE0NjcwMTUsImF1ZCI6IkVVLkVPUkkuTkwwMDAwMDAwMDEiLCJkZWxlZ2F0aW9uRXZpZGVuY2UiOnsibm90QmVmb3JlIjoxNTQxMDU4OTM5LCJub3RPbk9yQWZ0ZXIiOjIxNDc0ODM2NDcsInBvbGljeUlzc3VlciI6IkVVLkVPUkkuTkwwMDAwMDAwMDUiLCJ0YXJnZXQiOnsiYWNjZXNzU3ViamVjdCI6IkVVLkVPUkkuTkwwMDAwMDAwMDEifSwicG9saWN5U2V0cyI6W3sibWF4RGVsZWdhdGlvbkRlcHRoIjowLCJ0YXJnZXQiOnsiZW52aXJvbm1lbnQiOnsibGljZW5zZXMiOlsiSVNIQVJFLjAwMDEiXX19LCJwb2xpY2llcyI6W3sidGFyZ2V0Ijp7InJlc291cmNlIjp7InR5cGUiOiJHUzEuQ09OVEFJTkVSIiwiaWRlbnRpZmllcnMiOlsiMTgwNjIxLkFCQzEyMzQiXSwiYXR0cmlidXRlcyI6WyJHUzEuQ09OVEFJTkVSLkFUVFJJQlVURS5FVEEiXX0sImVudmlyb25tZW50Ijp7InNlcnZpY2VQcm92aWRlcnMiOlsiRVUuRU9SSS5OTDAwMDAwMDAwMyJdfSwiYWN0aW9ucyI6WyJJU0hBUkUuUkVBRCJdfSwicnVsZXMiOlt7ImVmZmVjdCI6IlBlcm1pdCJ9XX1dfV19fQ.nYMmDQVLaRWKWNWsxL2G3xg2nvxA2yfi5B7F0NBjx73C3yhnfroNtci-0uZYyXEog5S6RWl6AdGCaDVIjOcAreBxV5gjgGXBSyEu6sM6mpjRpX62vyqoe6b9Or-Y9liW8zQzqsC7SdGqX-_f9Aj32fZDKqDyKJnR3TIi_gjj6CB7mLrfy1P6PKWkVfd28h1RwWlNZD_OPczW_JbLaNTHI_I6bLY4lH48t3vLNHACUCsrq6zupJM-mQEN9x-InH_QgIHwQ_mu7hOaFRCoI4HQwoXKq3fZ_XdycJ5Dzgs9m5_YTfeaX5YFQbeHzVrkVEvLXESfnyrSUZY6_P-HrsANeA"
}

Request

Headers

Authorization String. OAuth 2.0 authorization based on bearer token. MUST contain “Bearer “ + access token value. How to retrieve the access token can be found at Access Token Endpoint section.
Content-Type String. Defines request body content type. MUST be equal to application/json.

Parameters

Request parameters are explained at Delegation Mask section.

Response

Decoded delegation_token JWT payload is explained at Delegation Evidence section.

Note

This page must be considered part of the iSHARE Trust Framework

PreviousAccess token (M2M)NextCapabilities

Last updated 7 months ago