Delegation

Obtains delegation evidence

post

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.

Authorizations
Body

The model used for request body in /delegation endpoint, for obtaining delegation evidence.

Responses
200Success
application/json
post
POST /delegation HTTP/1.1
Host: isharetest.net
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 341

{
  "delegationRequest": {
    "policyIssuer": "text",
    "target": {
      "accessSubject": "text"
    },
    "policySets": [
      {
        "target": {
          "environment": {
            "licenses": [
              "text"
            ]
          }
        },
        "policies": [
          {
            "target": {
              "resource": {
                "type": "text",
                "identifiers": [
                  "text"
                ],
                "attributes": [
                  "text"
                ]
              },
              "actions": [
                "text"
              ]
            },
            "rules": [
              {
                "effect": "text"
              }
            ]
          }
        ]
      }
    ],
    "delegation_path": [
      "text"
    ],
    "previous_steps": [
      "text"
    ]
  }
}
200Success
{
  "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

Last updated