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

HTTPcURLJavaScriptPython

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