Introduction

This is the NetFoundry Auth service

Overview

HTTP verbs

NetFoundry adheres closely to standard HTTP and REST conventions in its use of HTTP verbs.

Verb Usage

GET

Used to retrieve a resource

POST

Used to create a new resource

PUT

Used to update an existing resource, full updates only

DELETE

Used to delete an existing resource
The PATCH method is not used (yet).

HTTP status codes

NetFoundry adheres closely to standard HTTP and REST conventions in its use of HTTP status codes.

Status code Usage

200 OK

The actual response will depend on the request method used. In a GET request, the response will contain an entity corresponding to the requested resource. In a POST request, the response will contain an entity describing or containing the result of the action.

201 Created

The request has been fulfilled and resulted in a new resource being created.

202 Accepted

The request has been accepted and is being processed asynchronously Standard response for successful HTTP requests which invoke back-end services.

204 No Content

The server successfully processed the request, but is not returning any content.

400 Bad Request

The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).

401 Unauthorized

The request lacks valid authentication credentials for the target resource.

403 Forbidden

The request is authenticated with valid credentials however that set of credentials is not authorized to access this resource.

404 Not Found

The requested resource could not be found but may be available again in the future. Subsequent requests by the client are permissible.

Pagination

Paginated services will accept the following optional request parameters:

Table 1. Request parameters
Path Type Optional Description

page

Integer

true

Page you want to retrieve, 0 indexed and defaults to 0.

size

Integer

true

Size of the page you want to retrieve, defaults to 1000.

sort

String

true

Properties that should be sorted by in the format property,property(,ASC|DESC). Default sort direction is ascending. Use multiple sort parameters if you want to switch directions, e.g. ?sort=firstname&sort=lastname,asc.

Pagination response has following structure:

Table 2. Response structure
Path Type Optional Description

content

Array[Object]

false

Actual items.

totalElements

Integer

false

Total count.

totalPages

Integer

false

Total pages with current page size.

last

Boolean

false

If this page is the last one.

numberOfElements

Integer

false

Actual size of content array (number of items).

first

Boolean

false

If this page is the first one.

sort

Object

true

Sort information object.

size

Integer

false

Requested size of the page.

number

Integer

false

Page number.

empty

booloean

false

If this page is empty.

Authorization

Authorize

POST /auth

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

identityId

String

false

audience

String

false

claims

Map

false

Response fields

Path Type Optional Description

token

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/auth' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI4NGNVeHpzMTVKb2tqMEd2bzhkWnZBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjcyNzMzNGY3LWJhYzMtNDQyOC05N2RmLTM2ZWQyZTJiMzU5NyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDgwNDkxLCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcImRkNzI5MjVlLWYxMWEtNDU2Zi1hYTIxLWE1Y2FhY2VkNzY0MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5MX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.NMzVQtDnHaHMwIR_O26ZvTFSctIfBsw-KoVklllbBmbSBCsPhoQ0kBkSqDvspxkB44nlArNm3QWqTK4ZQM8tV_FIYXNJYY1_gzJebN8G5bLZnT79Lmxd8RYl0wk7btOgCym5t5Cr95HRtdi-zOzQORBIMjut5-r7S96zJ1j5Na_lHwJH06UKsU2MnBU9FQluXtFyxxXTRTUhIxOMQobgQ1nonD152jBoolQn8jT2bszcGoUYGPUHgMiIzm1E4s43FxenhPSnS8AegDl1QtqR-I4cIhKm3Zl7YVwzouk8en9vgFv65kZm7_cA1q243B_BaoU17Ibmej41daZFvuq6cQ' \
    -H 'Content-Type: application/json' \
    -d '{"identityId":"5a2f2b28-b001-4b32-9c63-c8692c27a768","audience":"io.netfoundry.test","claims":{}}'

Example response

HTTP/1.1 200 OK
Content-Length: 1807
Content-Type: application/json;charset=UTF-8

{
  "token" : "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImsxIn0.eyJqdGkiOiJqaDg2REJBTnpHc1dDNEtVbXZZNWtRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjVhMmYyYjI4LWIwMDEtNGIzMi05YzYzLWM4NjkyYzI3YTc2OCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkudGVzdCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDc3MTkxLCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjA1ODZlMWQyLTllZjEtNGVmMy04NzIwLWNmZWNmMDg1ZmQ0OVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSIsInBvbGljaWVzIjpbeyJyZXNvdXJjZXMiOlsibmZybjp0ZXN0czoqOmZvb3M6KiJdLCJhY3Rpb25zIjpbInRlc3RzOmNyZWF0ZS1mb28iXX1dfQ.dizDQQqGMtXHwLIEkhBUUw1s_UUui0S5w4J0vnz_8nTkXQ2LBR_DJE8zCcafbLUTXLpyK7mc6J-CBhEZ0pDFToMXATS-ceZk6x69ZbNriLEv5X3k8cJtRoDmFoyTpn7P4-r-bldHcvUh01cTiNORspuDI2_XxmE_uXPaxzigSIK4rnwBBtZKurJoit8ge_eE4CCUjSY8NRRFCsCH9hH44KVWmM48bIxlY71KEFLGJ0oxgvZOPM-r16lhrQq-VhmVR1bSbtLayC9ItQCDYNKyi97wz_0_4WbnfyJPIDYpAhuxy3yX3M01z13YMVX7bEb3KTQJGyIwDowLZJU8S9t6nw"
}

Core Authorization Resources

Domains

Find Domains

GET /domains

Returns a set of {@link Domain}s that the client is authorized to read.

Authorization

This endpoint requires read action on the domain resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].name

String

false

A human friendly name which can be used for UX purposes.

Size must be between 1 and 256 inclusive.

[].code

String

false

A globally unique value that can be used by code to namespace other values which only have to be unique within a domain, such as a resource’s key. This value must be formatted as an inverse domain name. For example, "io.netfoundry.authorization" for the colloquial 'authorization' domain.

Must match the regular expression [0-9a-zA-Z.]+.
Size must be between 1 and 128 inclusive.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link Domain} was created.

[].updatedAt

String

false

The date-time at which this {@link Domain} was updated. The only supported 'update' on this bean is to mark it as deleted.

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/domains' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJJUkJnZlp3ME9nOEhDQV84b0ZrVVB3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImY5OGNmYzJlLWMyYWUtNDFjNy1hNzFiLTlkYzVkMjA0MmVkZiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4NywiZXhwIjoxNjExMDgwNDg3LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMmUzNGI2MjYtN2E3ZS00ODk5LWIyNGUtNjhhMTliMjBlMmQ4XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg3fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.JL4eP8trMRuaUyPaD9J0p-ymeDNN2McgPRgwA66tU34NBMslGEpmADNcU0pREDF0ReNXRD7hQosgsv_H7iSqAfbAd0jXgHyDgVSf1XokO9H3hRykVnNnnBZ0Vfm-N8fdNeBo2XWyg20gTEXrPTLquRrPd7uqQ_EQThs_LIQZ2OQte9i5PyTy0-9bNXkY4kBR87BD78IJCVNHHNni4TUUefJzvll4nxOp8o5_0cv8FO45zPe_QZxQ7dc1xRthQZfiLjoEQqljxzERhTn7l1efe4TKiy2hEPCs_oiZZQ6dG3IN_hMmO8LOlamRSVEFUoTw6YlOfb3flC2yknAzxMfvfw'

Example response

HTTP/1.1 200 OK
Content-Length: 914
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "f0ae3b0a-8957-4cb0-93e2-78b6295d2720",
  "name" : "Organizations and Identities",
  "code" : "io.netfoundry.identity",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:21.897493Z",
  "updatedAt" : "2021-01-19T17:21:21.897493Z",
  "_title" : "Organizations and Identities"
}, {
  "id" : "c2db5ec6-8433-4221-9166-a4f5550b88ac",
  "name" : "Test Domain",
  "code" : "io.netfoundry.test",
  "createdBy" : "0f0ffecc-79a5-43d5-98e7-a73e789a108a",
  "createdAt" : "2021-01-19T17:21:25.697886Z",
  "updatedAt" : "2021-01-19T17:21:25.697886Z",
  "_title" : "Test Domain"
}, {
  "id" : "fd255885-1e9f-45bf-88cd-2e753f70f6d2",
  "name" : "Authorization",
  "code" : "io.netfoundry.auth",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.274334Z",
  "updatedAt" : "2021-01-19T17:21:22.274334Z",
  "_title" : "Authorization"
} ]

Get Domain

GET /domains/{idOrCode}

Authorization

This endpoint requires read action on the domain resource type.

Path parameters

Parameter Type Optional Description

idOrCode

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

false

A human friendly name which can be used for UX purposes.

Size must be between 1 and 256 inclusive.

code

String

false

A globally unique value that can be used by code to namespace other values which only have to be unique within a domain, such as a resource’s key. This value must be formatted as an inverse domain name. For example, "io.netfoundry.authorization" for the colloquial 'authorization' domain.

Must match the regular expression [0-9a-zA-Z.]+.
Size must be between 1 and 128 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link Domain} was created.

updatedAt

String

false

The date-time at which this {@link Domain} was updated. The only supported 'update' on this bean is to mark it as deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/domains/c2db5ec6-8433-4221-9166-a4f5550b88ac' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwcGVzZ0pKRjl5bkw1TXNpMkUzYzl3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjRkMmRkMGE2LTRjMDEtNDViMy05N2IwLTk4YzEyYjMyYmI2OCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OCwiZXhwIjoxNjExMDgwNDg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNTlkNDY4NDEtNjA2My00M2Q0LThjZmItOGU1Y2JjNDU1MDgyXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.CZCgRMNDFOH3RvgbkkvjCZG4VhmgxFhBevvViJxi0CbuKiKrJEZeWUEVLih9xhjYLds7ORUWXoVo8XY0fCiMQXval_nIFlDly_7dmb1peYuJmQ3QLw9n4FIPidGcY2O-imtjfEfuHHGru_LLrnj6p5q7x4y6Lpkh4881ekLwhUxUgurjHnJuGbLEdBUGrznKo_luOkJG-f_B27jnpPusr7NY6fmqWlEI0-2iWLPuQv1FM8fJrMT0wa7JbNvP7F7QwbxubNyzJpy5vqnXzulJsr5H4_kBXwpTXnSUK3vEnEXh1B74rEeiD9uRg5lGsswQSFB7VH7lFLjTfTTDhvhTPw'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 288

{
  "id" : "c2db5ec6-8433-4221-9166-a4f5550b88ac",
  "name" : "Test Domain",
  "code" : "io.netfoundry.test",
  "createdBy" : "0f0ffecc-79a5-43d5-98e7-a73e789a108a",
  "createdAt" : "2021-01-19T17:21:25.697886Z",
  "updatedAt" : "2021-01-19T17:21:25.697886Z",
  "_title" : "Test Domain"
}

Get Domain

GET /domains/{idOrCode}

Authorization

This endpoint requires read action on the domain resource type.

Path parameters

Parameter Type Optional Description

idOrCode

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

false

A human friendly name which can be used for UX purposes.

Size must be between 1 and 256 inclusive.

code

String

false

A globally unique value that can be used by code to namespace other values which only have to be unique within a domain, such as a resource’s key. This value must be formatted as an inverse domain name. For example, "io.netfoundry.authorization" for the colloquial 'authorization' domain.

Must match the regular expression [0-9a-zA-Z.]+.
Size must be between 1 and 128 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link Domain} was created.

updatedAt

String

false

The date-time at which this {@link Domain} was updated. The only supported 'update' on this bean is to mark it as deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/domains/io.netfoundry.test' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJlazREeUViclFMaUVvVUZwODVrS3d3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImVmNzc3YTA1LWI1M2YtNGE2OS05M2Y0LTc2NjU1MjY3YTI5MCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OCwiZXhwIjoxNjExMDgwNDg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYTk4N2NkZjItNDNkYS00MmY3LTkxZTMtZmUwYmQ3M2YxZjkzXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.Ik3nqIVe_fQexer0JKyy45NZyBnJHjouWWI9-0dFSgy2T5bugBuvY-cyhTi5uHC_aiZG5DLJKYWX9HZ9Uikfq8RTN6o4B7PodpBgif1RSNyyvnMbxu7uBcLSUP_fYkAf1NlT8d_zVWMmjzrBsOgsg5uaKzm4M4yNvWAHYLy8pi1tFjMnU0ELyqrMOXQCZjEdXAki-YJhTm1d_zQY05scCT5QEzla46SCW7LXQz0hdvTB3rWgRYLDLAXlWwQVUMPFnJepNPfW47hwiK8NXknaFh_8zuHMUxE_cU6Fi42pzI4G91mGaMbfYMvBazhoMLZKYic4KEBuU4ziFdqKeKJrhA'

Example response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json;charset=UTF-8
Content-Length: 288

{
  "id" : "c2db5ec6-8433-4221-9166-a4f5550b88ac",
  "name" : "Test Domain",
  "code" : "io.netfoundry.test",
  "createdBy" : "0f0ffecc-79a5-43d5-98e7-a73e789a108a",
  "createdAt" : "2021-01-19T17:21:25.697886Z",
  "updatedAt" : "2021-01-19T17:21:25.697886Z",
  "_title" : "Test Domain"
}

Create Domain

POST /domains

Authorization

This endpoint requires create action on the domain resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

false

Size must be between 1 and 256 inclusive.

code

String

false

Must match the regular expression [0-9a-zA-Z.]+.
Size must be between 1 and 128 inclusive.

Response fields

Path Type Optional Description

id

String

false

name

String

false

A human friendly name which can be used for UX purposes.

Size must be between 1 and 256 inclusive.

code

String

false

A globally unique value that can be used by code to namespace other values which only have to be unique within a domain, such as a resource’s key. This value must be formatted as an inverse domain name. For example, "io.netfoundry.authorization" for the colloquial 'authorization' domain.

Must match the regular expression [0-9a-zA-Z.]+.
Size must be between 1 and 128 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link Domain} was created.

updatedAt

String

false

The date-time at which this {@link Domain} was updated. The only supported 'update' on this bean is to mark it as deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/domains' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJsYkxaRHZfaUc3QU0wd2xrQVo2ek9RIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImU2OGUwNzZjLTBhNDQtNDkyOC1iMmM0LTUxNWZkOTI3MjM3MCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OCwiZXhwIjoxNjExMDgwNDg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMzg5YzE2MWMtMDhlYS00NzJkLWEzODgtODI0ZTZlN2MxMjY2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.nHxtqI6WFNBV87ohht_wUU39AHL1Uhtte-RxeroWlBMHcNTp66nXYRKzjErI6huYuNuCrx2_1uZx50Bwxt4P-u3mkfAcn0VCjX5MnBcUHOKS4PiyBGszYK5v2KzTh3auj-6qVyDJbofhIjoOvheP1JksO5mLatLURtTi9p7YykN0Cm4hBvNZiu_S1k6Qwo9jqIEfDfk7ipfg7bM7--nZ2YDcqwqpq007EYLCBz-PNBtfa-w6LozLgoW0loHB7c08a5QAuD5rubKpK4JIx-UNLH5kKJQlRAmqdiNWVIc8rhklpJWUiKZwTy0JO8iQj3ekn8Kcuk64qbDZmUBfskYS5w' \
    -H 'Content-Type: application/json' \
    -d '{"name":"Other Test Domain","code":"other.test.domain"}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 299

{
  "id" : "031e1651-0b2f-4f65-9da2-6e174a13cd6f",
  "name" : "Other Test Domain",
  "code" : "other.test.domain",
  "createdBy" : "e68e076c-0a44-4928-b2c4-515fd9272370",
  "createdAt" : "2021-01-19T17:21:28.235176Z",
  "updatedAt" : "2021-01-19T17:21:28.235176Z",
  "_title" : "Other Test Domain"
}

Resource Types

Find Resource Types

GET /resource-types

Returns a set of {@link ResourceType}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the resource-type resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

domainId

Object

true

Filters results to those that are in one of the specified {@link Domain}s.

code

Object

true

Filters results to those matching one of the specified codes.

parentId

Object

true

Filters results to those that are an immediate child of one of the specified {@link ResourceType}s.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].domainId

String

false

The id of the domain within which this {@link ResourceType} exists.

[].name

String

false

The human friendly name of this {@link ResourceType}.

Size must be between 1 and 256 inclusive.

[].code

String

false

A unique value (within the domain) that can be used by code as a reference to this resource type. These values should almost always be the simple type name of the resource class, such as "BillingAccount".

Must match the regular expression [0-9a-zA-Z-]+.
Size must be between 1 and 64 inclusive.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link ResourceType} was created.

[].updatedAt

String

false

The date-time at which this {@link ResourceType} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].parentId

String

true

Returns the id of the parent {@link ResourceType} or null if this is a root.

[].childrenIds

Array[Object]

true

Returns the id of {@link ResourceType}s that are children of this.

[].depth

Integer

true

Returns the depth of this {@link ResourceType} within the tree, where a root {@link ResourceType} has a depth of 0.

[].root

Boolean

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resource-types' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJRazBVRllxeXd0a0tNT3NFeTBqZ2V3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImIzMmZjOWY5LTgzNzQtNGYwYS05YzI5LTg5Mjg0NDAyZTlkYiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYjE4MjY0NjUtZDgwYS00MTg3LThjYjItMTM2MDhmYWY5YTQ1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.o1GOTJxOd4EvGb4TSB_Qf0WUR1buz118NkS151n9IpeY-OWErZn4jZRXPAMuGDoeYg8JSi48pJHyKQBcbH22NI9K3riuQgopQ5PMiDt49qJAhvviEz2_udTzLKQmBxgekS7mbRFuWxeym5Ee1jqlXrueNunS-NOFK4E_w37Yk-OEuGOTvOsz4ws05a8-hNPkXaqlE6OzernIcrf8Mg_gjgiiQC4O_TbNLgygjRh_LrMxIULmmdHPUhvVnfitsoNQ2oGRbQyS1ZQiUjLeKpnNBuhpU47n86YJbt1RKXT4Firu57hyaXVPouOFgxU8lNIgciDlxVFMamYTzu7XqG1daQ'

Example response

HTTP/1.1 200 OK
Content-Length: 1309
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "9151af7a-e9dc-400c-a5da-cba1c9463e6d",
  "domainId" : "3b10a06f-25a8-47bc-9e0a-3ef9556b2aa7",
  "name" : "Test Type 4",
  "code" : "Test-Type-4",
  "createdBy" : "3c7bd9b4-e021-4855-abdb-646a89a44457",
  "createdAt" : "2021-01-19T17:21:28.769457Z",
  "updatedAt" : "2021-01-19T17:21:28.769457Z",
  "parentId" : null,
  "childrenIds" : [ ],
  "depth" : 0,
  "root" : true,
  "_title" : "Test Type 4"
}, {
  "id" : "46018e54-0350-45a9-b01c-896f6f07691e",
  "domainId" : "fd255885-1e9f-45bf-88cd-2e753f70f6d2",
  "name" : "Super User",
  "code" : "super-user",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.275624Z",
  "updatedAt" : "2021-01-19T17:21:22.275624Z",
  "parentId" : null,
  "childrenIds" : [ ],
  "depth" : 0,
  "root" : true,
  "_title" : "Super User"
}, {
  "id" : "44ce40a7-ffdc-44a5-8754-75e132f364a0",
  "domainId" : "fdf0f34d-ee16-48a0-9b09-44bf60a5abfa",
  "name" : "Azure Virtual WAN Site",
  "code" : "azure-virtual-wan-site",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:21.936979Z",
  "updatedAt" : "2021-01-19T17:21:21.936979Z",
  "parentId" : "381e8822-0568-4068-b26f-39f27cd37a31",
  "childrenIds" : [ ],
  "depth" : 2,
  "root" : false,
  "_title" : "Azure Virtual WAN Site"
} ]

Get Resource Type

GET /resource-types/{id}

Authorization

This endpoint requires read action on the resource-type resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

domainId

String

false

The id of the domain within which this {@link ResourceType} exists.

name

String

false

The human friendly name of this {@link ResourceType}.

Size must be between 1 and 256 inclusive.

code

String

false

A unique value (within the domain) that can be used by code as a reference to this resource type. These values should almost always be the simple type name of the resource class, such as "BillingAccount".

Must match the regular expression [0-9a-zA-Z-]+.
Size must be between 1 and 64 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link ResourceType} was created.

updatedAt

String

false

The date-time at which this {@link ResourceType} was updated. The only supported 'update' on this bean is to mark it as deleted.

parentId

String

true

Returns the id of the parent {@link ResourceType} or null if this is a root.

childrenIds

Array[Object]

true

Returns the id of {@link ResourceType}s that are children of this.

depth

Integer

true

Returns the depth of this {@link ResourceType} within the tree, where a root {@link ResourceType} has a depth of 0.

root

Boolean

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resource-types/b5e45843-2145-475b-8bd9-01a80c299b62' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJubTJJSER3clc3M0VTNTdyQkdHOGd3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImUwOWNjNmM2LTM5OTMtNDllMi1hZGRhLTdlYWNmNDg3NDgwMSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNmRhNzZkNmMtODVkNy00NGQ1LTg2NTYtMjA3N2NiZDk0OWVhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.Ux8wn1o2Dx6iYMdlOq8OfWBcz2HQHimPX4FT0byH425QBkSr_HHkrhhtDK5OB3WxeIK-xJisy-XNt7GPiNamd2GUvQ7h6FeuPYxwuq8XP_23CnXL4Y_fU61sDtE3e4q41-plFBeUbBDiQR3Mya0bvNoRCXHmMLcXCELs-c_H8ZhMT_xagmc7BNXjllUwVeyn0mpqm9HnXhS0QHPFzVJjja-hwoEUCjcURVN9Bocm-nNOlVXiyl4aE71C2paquMNGvQiweI3De5cbNe5Gp_dmqqq5ExReYuxPj6wfr0JzYCbofMXFpV3O2eD8rEBtmFs_d-nWBeexhJ7PjsBqp42bgw'

Example response

HTTP/1.1 200 OK
Content-Length: 406
Content-Type: application/json;charset=UTF-8

{
  "id" : "b5e45843-2145-475b-8bd9-01a80c299b62",
  "domainId" : "c2db5ec6-8433-4221-9166-a4f5550b88ac",
  "name" : "Test Type",
  "code" : "test-type",
  "createdBy" : "0a07627b-5b59-44c6-a76b-c692a32e80d6",
  "createdAt" : "2021-01-19T17:21:25.718004Z",
  "updatedAt" : "2021-01-19T17:21:25.718004Z",
  "parentId" : null,
  "childrenIds" : [ ],
  "depth" : 0,
  "root" : true,
  "_title" : "Test Type"
}

Create Resource Type

POST /resource-types

Authorization

This endpoint requires the following actions:

  • create action on the resource-type resource type

  • read action on the domain resource type

  • read action on the resource-type resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

domainId

String

false

Client must have create action under the annotated resource.
Client must have read action on the annotated resource.

parentId

String

true

Client must have read action on the annotated resource.

resourceType

Object

false

resourceType.name

String

false

Size must be between 1 and 256 inclusive.

resourceType.code

String

false

Must match the regular expression [0-9a-zA-Z-]+.
Size must be between 1 and 64 inclusive.

resourceType.children

Array[Object]

true

Response fields

Path Type Optional Description

id

String

false

domainId

String

false

The id of the domain within which this {@link ResourceType} exists.

name

String

false

The human friendly name of this {@link ResourceType}.

Size must be between 1 and 256 inclusive.

code

String

false

A unique value (within the domain) that can be used by code as a reference to this resource type. These values should almost always be the simple type name of the resource class, such as "BillingAccount".

Must match the regular expression [0-9a-zA-Z-]+.
Size must be between 1 and 64 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link ResourceType} was created.

updatedAt

String

false

The date-time at which this {@link ResourceType} was updated. The only supported 'update' on this bean is to mark it as deleted.

parentId

String

true

Returns the id of the parent {@link ResourceType} or null if this is a root.

childrenIds

Array[Object]

true

Returns the id of {@link ResourceType}s that are children of this.

depth

Integer

true

Returns the depth of this {@link ResourceType} within the tree, where a root {@link ResourceType} has a depth of 0.

root

Boolean

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resource-types' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzY3VfUHZ4ZzA3YnJpeG1GeFczMDBRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImIwNjIxYWNhLWYzOWMtNDEyNy05NmE0LWE3OTA4ZDM0ODdhYSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYjYwZmUyMjItYjhlMC00ZjMzLTkyNGItMjYwNDY4ZGE5NDEwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiYzdiNGQzOTMtOGMwYy00MmVkLTliMTYtODQ2YzI0MzU0NTNhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiZDQxMzEwYzUtODdiMi00ZWJlLTk4OTAtOGIyYTQ3ZDE0OTYxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.E0tZJYbL_hbBPIwMHOvgsn0ufAuJVqoLgMyG4lovmL4ym1YMLrqfwTEC-EwASvnZ0vM0Q5P0XIonQof6TrcUG8aQHC31DkrF2Gvj3D_iIvn7edWAWWvLFqur0bpfhorOeaVJjY7IlfiAGISbN-0iyeDw1xUDIs41ZrTvRho1PdloXq7y9dlUIIGAY80Pzu47SIE5JQCLkgC0PIH235szBPq_KpBWn60I2m-olODbyrOAfu8jpBCzWDdVxmpY7C0bWEjKXi1gDqMSXSU30aLh9ce72j34P9JCQp3-TRWFlxoh4QQQo4J2jXVGhqHj4SL9mCquuK0xGhlHSxf1el6ziw' \
    -H 'Content-Type: application/json' \
    -d '{"domainId":"c2db5ec6-8433-4221-9166-a4f5550b88ac","parentId":"b5e45843-2145-475b-8bd9-01a80c299b62","resourceType":{"name":"Another Test Type","code":"anoter-test-type","children":[]}}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 464

{
  "id" : "bb461688-6965-438e-9ca6-98bee16d1061",
  "domainId" : "c2db5ec6-8433-4221-9166-a4f5550b88ac",
  "name" : "Another Test Type",
  "code" : "anoter-test-type",
  "createdBy" : "b0621aca-f39c-4127-96a4-a7908d3487aa",
  "createdAt" : "2021-01-19T17:21:33.221133Z",
  "updatedAt" : "2021-01-19T17:21:33.221133Z",
  "parentId" : "b5e45843-2145-475b-8bd9-01a80c299b62",
  "childrenIds" : [ ],
  "depth" : 1,
  "root" : false,
  "_title" : "Another Test Type"
}

Resource Actions

Find Resource Actions

GET /resource-actions

Returns a set of {@link ResourceAction}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the resource-action resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

code

Object

true

Filters results to those matching one of the specified codes.

resourceTypeId

Object

true

Filters results to those that apply to one of the {@link ResourceType}s specified.

domainId

Object

true

Filters results to those that are in one of the specified {@link Domain}s.

customRoleId

Object

true

Filters results to those that are granted by one of the specified {@link CustomRole}s. Only non-deleted {@link CustomRoleAction}s are considered.

standardRoleTypeId

Object

true

Filters results to those that are included in one of the specified {@link StandardRoleType}s.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].resourceTypeId

String

false

The type of resource that this {@link ResourceAction} applies to.

[].name

String

false

A human friendly name for this action. This should be a verb only, such as "Create", "Grant", "Remove", "Activate", "Update", "Delete", etc. This can contain more than one word, and spaces are permitted and encouraged if more than one word is present. Words should be initial-caps. This value will be appended with the names of other entities, such as a resource type name, in order to compute names for the composition of this with another entity. For example, if this action is "Create" and it is composed with a resource type named "Network", then the resulting composition may be named "Create Network".

Size must be between 1 and 256 inclusive.

[].code

String

false

Used by code as a reference to this action. These values should almost always be a simple verb such as "create", "update", "grant", "fetch", etc. Lower-case and hyphen separation of words is encouraged. Since this is used by code, the key value have a limited alphabet of letters, numbers, and hyphens. This value must be unique among the set of {@link ResourceAction}s targeting the same resource type.

Must match the regular expression [0-9a-zA-Z-]+.
Size must be between 1 and 64 inclusive.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link ResourceAction} was created.

[].updatedAt

String

false

The date-time at which this {@link ResourceAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].standardAction

Boolean

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resource-actions' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyUTRuN3VJVnJ6QTZCQVN4VkJfVkZRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImE5MThlZjE0LTQyOWItNGJjMC05ZTIwLWZhNjc3MzY0ZmRmZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MCwiZXhwIjoxNjExMDgwNDkwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMzhjNjcyNDMtMTU5OC00ZDdhLTk5MTEtYTdiNGM3MzBjNzc4XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.GHiujns6kGcz7n73Rmvxj5hwC8WaczEL0oopnWsDGEB6BVtKcuWV6Exa-dhmldKqDV46Mg2R5He-0MtkHHbt6-rW6VB-QMAd4XtkbvByMLfB-c0-rk6i8vH7iSHKZgzTeH_hozdKOMqsXD0BG8KSlzE9jty28IqwGJDDOAs1EASoyKzuqXUR9xBVnK74_Xcdcaj4DIZ6keFv5BE7v3YIUaksVhvRBw86ijjkCzk0f5LAUOIhgVlldZAvKmIf6R1jZ6aPmMKywnMcUWNm774uquhOdMHZTsc9yRo3LJy8ybSXjI44WPaT8M_wuAh4lcrdrz72ZMRCAf0UgQRbsGvdqA'

Example response

HTTP/1.1 200 OK
Content-Length: 1097
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "8d8771c9-12ba-48d0-8e10-fc286f261597",
  "resourceTypeId" : "3a62dafe-f59f-475f-8fbe-555302f6f3e3",
  "name" : "Delete",
  "code" : "delete",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:21.948919Z",
  "updatedAt" : "2021-01-19T17:21:21.948919Z",
  "standardAction" : true,
  "_title" : "Delete Transfer Node"
}, {
  "id" : "e0ae5332-e7ba-45ab-ac3f-06f9fa64fa7a",
  "resourceTypeId" : "47c4da17-a8a2-4c1f-aa6d-5bde9dd0dc9e",
  "name" : "Read",
  "code" : "read",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:23.145875Z",
  "updatedAt" : "2021-01-19T17:21:23.145875Z",
  "standardAction" : true,
  "_title" : "Read Config Type"
}, {
  "id" : "c0b4cb53-5248-4452-b632-921b1379923b",
  "resourceTypeId" : "647ac2c5-06a5-4f4d-a299-fc29629f49fc",
  "name" : "Update",
  "code" : "update",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:21.947519Z",
  "updatedAt" : "2021-01-19T17:21:21.947519Z",
  "standardAction" : true,
  "_title" : "Update AppWan"
} ]

Get Resource Action

GET /resource-actions/{id}

Authorization

This endpoint requires read action on the resource-action resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

resourceTypeId

String

false

The type of resource that this {@link ResourceAction} applies to.

name

String

false

A human friendly name for this action. This should be a verb only, such as "Create", "Grant", "Remove", "Activate", "Update", "Delete", etc. This can contain more than one word, and spaces are permitted and encouraged if more than one word is present. Words should be initial-caps. This value will be appended with the names of other entities, such as a resource type name, in order to compute names for the composition of this with another entity. For example, if this action is "Create" and it is composed with a resource type named "Network", then the resulting composition may be named "Create Network".

Size must be between 1 and 256 inclusive.

code

String

false

Used by code as a reference to this action. These values should almost always be a simple verb such as "create", "update", "grant", "fetch", etc. Lower-case and hyphen separation of words is encouraged. Since this is used by code, the key value have a limited alphabet of letters, numbers, and hyphens. This value must be unique among the set of {@link ResourceAction}s targeting the same resource type.

Must match the regular expression [0-9a-zA-Z-]+.
Size must be between 1 and 64 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link ResourceAction} was created.

updatedAt

String

false

The date-time at which this {@link ResourceAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

standardAction

Boolean

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resource-actions/78b980a3-7c96-40c2-ba6e-d54a14b6d065' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ6YjN5RENZTjNIclF6VVoyMmZjQjlnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjQ0MmZlZmQ0LTAxYjUtNGExOS1hZDRkLTM4ZThmMmI4NGRhYSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MCwiZXhwIjoxNjExMDgwNDkwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiODU1ZmY2NGItMWMxNS00OTEzLTkzMDMtOWY3ODkxZmY0NTEzXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.a7P8QNnxVp4kXY0VmPVgI_GO3nh7ip6ZzAWHRsBdW2EuxzCmfbfKIDyXcCGYvBjl8Q1cVcpomSTVfFNo8OYbhADbM3yLndmZq22_YMUkamI48IDamTyz6PUQK5Rxx6ukrE6P1rIjwmmc-TdH5bLPlk6MuONLYPrmzeBjyqA5BXJyKcj7Po2MeKVI8NQ9SsJH15ktLPqz3FYa0TZFW6i7tsw4cqNJxbX-uli6i4pZUdm0aSsj0kBB_qZlSG2hl3IND8MpFGbf_tyNApBVUK-r_t4qqiSsj3YbPiBrZYGN5082AA_NyW_vYyMQTxoMrVcIZqhi8XgZx03S192uanBfPQ'

Example response

HTTP/1.1 200 OK
Content-Length: 380
Content-Type: application/json;charset=UTF-8

{
  "id" : "78b980a3-7c96-40c2-ba6e-d54a14b6d065",
  "resourceTypeId" : "b5e45843-2145-475b-8bd9-01a80c299b62",
  "name" : "Test Action",
  "code" : "test-action",
  "createdBy" : "706a6449-0a41-4f04-a6eb-7feb89f49dda",
  "createdAt" : "2021-01-19T17:21:25.722405Z",
  "updatedAt" : "2021-01-19T17:21:25.722405Z",
  "standardAction" : false,
  "_title" : "Test Action Test Type"
}

Create Resource Action

POST /resource-actions

Authorization

This endpoint requires the following actions:

  • create action on the resource-action resource type

  • read action on the resource-type resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

resourceTypeId

String

false

Client must have create action under the annotated resource.
Client must have read action on the annotated resource.

actions

Array[Object]

false

actions[].name

String

false

actions[].code

String

false

Response fields

Path Type Optional Description

[].id

String

false

[].resourceTypeId

String

false

The type of resource that this {@link ResourceAction} applies to.

[].name

String

false

A human friendly name for this action. This should be a verb only, such as "Create", "Grant", "Remove", "Activate", "Update", "Delete", etc. This can contain more than one word, and spaces are permitted and encouraged if more than one word is present. Words should be initial-caps. This value will be appended with the names of other entities, such as a resource type name, in order to compute names for the composition of this with another entity. For example, if this action is "Create" and it is composed with a resource type named "Network", then the resulting composition may be named "Create Network".

Size must be between 1 and 256 inclusive.

[].code

String

false

Used by code as a reference to this action. These values should almost always be a simple verb such as "create", "update", "grant", "fetch", etc. Lower-case and hyphen separation of words is encouraged. Since this is used by code, the key value have a limited alphabet of letters, numbers, and hyphens. This value must be unique among the set of {@link ResourceAction}s targeting the same resource type.

Must match the regular expression [0-9a-zA-Z-]+.
Size must be between 1 and 64 inclusive.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link ResourceAction} was created.

[].updatedAt

String

false

The date-time at which this {@link ResourceAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].standardAction

Boolean

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resource-actions' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJCdWUxY0hiS3ZUMkZ6WjVUY2RUTDNnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6Ijk1NzVkMDg1LTQwNzgtNDdiOS1hZmZhLTNlODViNzdhNDEyMyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MCwiZXhwIjoxNjExMDgwNDkwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNDY1MmJmM2YtOTljZC00MGJiLThlOGYtYjIxODYxOTJkY2E5XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfSx7XCJpZFwiOlwiMmRkZjQ3YzctODU3NC00OTc0LTk5NGQtM2RhY2U0Y2U5ZmUwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.asiqYSUS_wnrbktE1R-3V8p98rIc798C_z_-Qzl3HJGTpMmn1sYXoApRMX7GWWCP-GfCo-DWETbBwAFrC5ERw9QNrTZYzemyuASC47KOKuRX4W6BxwIO2FulTJhvWwWqOTWGztqE7wLgGeco9Ubao_5SYfpMebuIPr4VgwQltbhaTK3GZ5qUn9U2-A5LnE_rVctAsTc4nOqhReaN4gpYdvX6UzexUp4JWcQcDIHxpIMpMEnWR7k1XMr3OPeUGyL3c8Uz8pkBWYYG0UWcuvnD53ok09r2kH-nM1QBz22nGfgbSp7Ckt6_L2daC8BRlQnVM-hYOmVtnCPuIsVUvRDweQ' \
    -d '{"resourceTypeId":"b5e45843-2145-475b-8bd9-01a80c299b62","actions":[{"name":"Update Custom","code":"update-custom"}]}'

Example response

HTTP/1.1 200 OK
Content-Length: 390
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "df161d7f-60d0-44e2-bbfc-7e12ca73c294",
  "resourceTypeId" : "b5e45843-2145-475b-8bd9-01a80c299b62",
  "name" : "Update Custom",
  "code" : "update-custom",
  "createdBy" : "9575d085-4078-47b9-affa-3e85b77a4123",
  "createdAt" : "2021-01-19T17:21:30.490233Z",
  "updatedAt" : "2021-01-19T17:21:30.490233Z",
  "standardAction" : false,
  "_title" : "Update Custom Test Type"
} ]

Authorization Grants

Grants (abstract)

Find Grants

GET /grants

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

grantType

Object

true

identityId

Object

true

resourceActionId

Object

true

path

Object

true

Request fields

No request body.

Response fields

Path Type Optional Description

[].grantType

String

true

The concrete type that this virtual {@link Grant} is based upon. Never null.

Must be one of [CustomRole, IdentityResourceAction, PublicGrant, SuperUser].

[].grantId

String

true

The id of the concrete grant resource on which this virtual {@link Grant} is based. If the grant type has separate resources for the grant and the privileges, then this will reference the grant resource (the resource with an identity id.) Never null.

[].privilegeSourceId

String

true

The id of the concrete {@link PrivilegeSource} from which this grant is based. Some grant types combine the grant and privilege aspects into a single resource. For example, a {@link SuperUser} is both a grant (it specifies an identity id) and a privilege source. In other cases, such as a {@link CustomRole} and {@link CustomRoleGrant}, they are separate. When they are the same resource, this value will match the grantId value. Never null.

[].identityId

String

true

The identity id of the holder of this grant. Almost never null, with the one exception of a grant made to all users (or all authenticated users.).

[].privileges

Map

true

The set of privileges that this grants. These are organized as a stack of 3 Maps where the keys are the domain code, then the resource type code, then the action code, and the leaf value is a set of paths on which that action can be performed.

[].createdBy

String

false

The identity id that created the grant.

[].createdAt

String

false

The date-time at which the grant was created.

[].deletedAt

String

true

The date-time at which the grant was deleted. This will be null for an grant that has not been deleted. If this property is not null, then the grant is 'marked' as being deleted.

[].deletedBy

String

true

The identity id that deleted the grant. This will be null until the resource is marked deleted.

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/grants' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJhTjgtYllicTkwUjVCZlpjdHdvOEVBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImFhZmEzNTJlLWJjZWUtNGIyMy1iM2ZkLTU0YTdlODVjZDZkMyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjdhMGU2MTMyLWRiNzEtNDhjMS1hZTI2LWE1MWZjN2Q3YTgyY1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M31dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.PS0Lo-ta8C6txkL8ZCrZECsIwDVN_eouh3G1TVU6tHaxCAsP9-aIy_bqSi7pWvITcGdDNy8Sf5bYJd9U7xgYSMjdbbPtaz0XmEigknojoSgcPmbaH0_SQH9OPUY0_Sba4Fx52Ugzsq6aGS_JAZiwCc0S-XmZMALc_kNrlYn8pMoLoSL_CGI3UjVswyDvR7RufyUb331VXf3vzVZJclduhJuRED1wV71PSz327UT7kIbKvWtYf69GQPtNAgi5jTeu_EBQPvj1RX_Rq94qbVJFA1nNIwOilifFFXxn0YDZbx8L8NphBdbGBjWnc276FZmVWlZsje3-5MD0XHogTZe4_A'

Example response

HTTP/1.1 200 OK
Content-Length: 1773
Content-Type: application/json;charset=UTF-8

[ {
  "grantType" : "IdentityResourceAction",
  "grantId" : "ca48ad35-a67d-4887-8a25-ff90eed18ea2",
  "privilegeSourceId" : "ca48ad35-a67d-4887-8a25-ff90eed18ea2",
  "identityId" : "98839836-7f26-4f07-8f61-ad8c29f4cdb6",
  "privileges" : {
    "io.netfoundry.auth" : {
      "standard-role-grant" : {
        "create" : [ [ ] ]
      }
    }
  },
  "createdBy" : "4b380dfe-a076-42b7-bcf8-a4bf4793449d",
  "createdAt" : "2021-01-19T17:21:30.072548Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Create Standard Role Grant, All to identity 98839836-7f26-4f07-8f61-ad8c29f4cdb6"
}, {
  "grantType" : "IdentityResourceAction",
  "grantId" : "8e195947-123f-4fe5-bb2d-e7b0455f3207",
  "privilegeSourceId" : "8e195947-123f-4fe5-bb2d-e7b0455f3207",
  "identityId" : "a17fffad-b448-4fc0-8e16-60baadc1d5ee",
  "privileges" : {
    "io.netfoundry.network" : {
      "endpoint-group" : {
        "create" : [ [ ] ]
      }
    }
  },
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.225016Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Create Endpoint Group, All to identity a17fffad-b448-4fc0-8e16-60baadc1d5ee"
}, {
  "grantType" : "IdentityResourceAction",
  "grantId" : "80624179-168a-4b1c-8077-02d519413f65",
  "privilegeSourceId" : "80624179-168a-4b1c-8077-02d519413f65",
  "identityId" : "fa06a740-21f8-480a-9e7a-1f759b506e0b",
  "privileges" : {
    "io.netfoundry.network" : {
      "network-group" : {
        "read" : [ [ ] ]
      }
    }
  },
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:23.000854Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Read Network Group, All to identity fa06a740-21f8-480a-9e7a-1f759b506e0b"
} ]

Super-User Grants

Find Super Users

GET /super-users

Returns a set of {@link SuperUser}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the super-user resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

identityId

Object

true

Filters results to those that grant to an identity specified in this set.

domainId

Object

true

Filters results to those that grant access to one of the specified {@link Domain}s. To search for {@link SuperUser}s that explicitly grant access to all domains (ie, the domainId is null), include this query parameter with no value.

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].identityId

String

false

The id of the identity to whom super-user access has been granted.

[].domainId

String

true

An optional {@link Domain} id, which when set indicates that this super-user is limited to {@link ResourceAction}s in the corresponding {@link Domain}. When not set, this super-user applies to all {@link Domain}s, present and future.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link SuperUser} was created.

[].updatedAt

String

false

The date-time at which this {@link SuperUser} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link SuperUser} was deleted. This will be null for an {@link SuperUser} that has not been deleted. If this property is not null, then the {@link SuperUser} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[].type

String

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/super-users' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJzclBtWnVEeFVfTjlDZDllVDREUW5nIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImM5YjM2ZjU3LWRlMjAtNDI2OS05NjMyLWI5ZTVjODY2YzQ1OCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5NCwiZXhwIjoxNjExMDgwNDk0LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNmY1OGU2ZDQtMWVlYi00MDgyLWFjNzgtNGI5YjI5NzI4NDAwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODk0fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.QAvfKEiXkZp_Ma13qajWwWOPSPM4vKZZcm5BlG1erBAYoBsR0864nVdx3w4RT-2iKaf6-2XgOoxHhf_NibTmBsX8wZOvp1hudHWGkhxnDT3mPkSyVDL1SnvmIn8IfAWWtzMe52V6nmPL9tRzXm_Wp4cP5RlT4x_heKmm7W46O1QTJlvQIq7Cb77CkrHWhZkPuAb-jD6LJTF-U7H7a49UMUjsetT2qFZu0tNof4XmDROwXoDgJdyJWXLjxMrZuBivGDwyHPmosfsZqWkwERtf_kcIkpcDgexZA7ak0jS2xCX0sJCRDwo99lEhesy5oNaZNXzwr_jU8rmFQmJi-h_HSQ'

Example response

HTTP/1.1 200 OK
Content-Length: 1565
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "7a0e6132-db71-48c1-ae26-a51fc7d7a82c",
  "identityId" : "aafa352e-bcee-4b23-b3fd-54a7e85cd6d3",
  "domainId" : null,
  "createdBy" : "70614f7d-c43e-4f14-b422-1be4a1d81eec",
  "createdAt" : "2021-01-19T17:21:33.310677Z",
  "updatedAt" : "2021-01-19T17:21:33.310677Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.superuser.SuperUser",
  "_title" : "Grant All Actions (SU) in All Domains to identity aafa352e-bcee-4b23-b3fd-54a7e85cd6d3"
}, {
  "id" : "19c4b69b-cad7-40bf-afd1-e257beb46932",
  "identityId" : "b7fe95c8-62a7-4f10-ad22-d4c268062b38",
  "domainId" : null,
  "createdBy" : "40437127-e863-4bb6-b2f5-0a347965ef6a",
  "createdAt" : "2021-01-19T17:21:29.261805Z",
  "updatedAt" : "2021-01-19T17:21:29.261805Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.superuser.SuperUser",
  "_title" : "Grant All Actions (SU) in All Domains to identity b7fe95c8-62a7-4f10-ad22-d4c268062b38"
}, {
  "id" : "07a5020f-354c-4866-af58-939c48897c74",
  "identityId" : "80585785-c7a4-4af5-97b5-c9aed4c72463",
  "domainId" : "20bc550a-aebd-45e3-a478-e67c6821a481",
  "createdBy" : "43cd33a2-5178-437e-bc24-b90ecea636a7",
  "createdAt" : "2021-01-19T17:21:34.272159Z",
  "updatedAt" : "2021-01-19T17:21:34.282241Z",
  "deletedAt" : "2021-01-19T17:21:34.281Z",
  "deletedBy" : "818a7e4f-03be-49e7-b8d6-586316a25d65",
  "type" : "io.netfoundry.auth.domainv2.superuser.SuperUser",
  "_title" : "Grant All Actions (SU) in Test Domain 73 to identity 80585785-c7a4-4af5-97b5-c9aed4c72463"
} ]

Get Super User

GET /super-users/{id}

Authorization

This endpoint requires read action on the super-user resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

The id of the identity to whom super-user access has been granted.

domainId

String

true

An optional {@link Domain} id, which when set indicates that this super-user is limited to {@link ResourceAction}s in the corresponding {@link Domain}. When not set, this super-user applies to all {@link Domain}s, present and future.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link SuperUser} was created.

updatedAt

String

false

The date-time at which this {@link SuperUser} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link SuperUser} was deleted. This will be null for an {@link SuperUser} that has not been deleted. If this property is not null, then the {@link SuperUser} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/super-users/0586e1d2-9ef1-4ef3-8720-cfecf085fd49' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJVY1FpTzVrSTFYdVk1Yzk3SW1LQzJBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImQ0YzYzY2QyLTNiMTAtNDk0OC04NTNjLWEwN2QwZjVlZDgyMiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5NCwiZXhwIjoxNjExMDgwNDk0LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNDI1MzI3YWMtMTFjMy00YmIwLTg0ZDAtZTkyNGUwNzg2NWU5XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODk0fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.PLvZ3GiG5aW6DyR7CKI0ojG6LZxXzIU1fAemoJ_vOQla8DfkMOahfOF_2xcuhtoJe9b5J2cfkYuTyWDY1GiEJGf9tG0IA6k72IEZTuDMaXbcKBI88fyzMTmv0ftgNu1RUhLsUVrKwc9QwmNGvx5VyiZRP_cPrOz2xXTOFw1Lr3550Z8gYzlVOlkqjv7nVyzfy0uLeZW49euBSsk3R4MUbcFZ7HjmLQY_gTH_QvPnOlBQVI43iPyxiCrCyiCIBoWstbKFPlzl1vASFJQ8DbbC1upWMFwqtmOvLBMFYLFVDteCuPtGKTOEKnfwMAlx0GVzCZ00Z8K7Yxbt-DLhrduCJQ'

Example response

HTTP/1.1 200 OK
Content-Length: 522
Content-Type: application/json;charset=UTF-8

{
  "id" : "0586e1d2-9ef1-4ef3-8720-cfecf085fd49",
  "identityId" : "5a2f2b28-b001-4b32-9c63-c8692c27a768",
  "domainId" : "c2db5ec6-8433-4221-9166-a4f5550b88ac",
  "createdBy" : "e2b635b7-13ea-41d1-916f-b74b983400ac",
  "createdAt" : "2021-01-19T17:21:25.731683Z",
  "updatedAt" : "2021-01-19T17:21:25.731683Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.superuser.SuperUser",
  "_title" : "Grant All Actions (SU) in Test Domain to identity 5a2f2b28-b001-4b32-9c63-c8692c27a768"
}

Create Super User

POST /super-users

Authorization

This endpoint requires the following actions:

  • create action on the super-user resource type

  • read action on the domain resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

identityId

String

false

domainId

String

true

Client must have read action on the annotated resource.

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

The id of the identity to whom super-user access has been granted.

domainId

String

true

An optional {@link Domain} id, which when set indicates that this super-user is limited to {@link ResourceAction}s in the corresponding {@link Domain}. When not set, this super-user applies to all {@link Domain}s, present and future.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link SuperUser} was created.

updatedAt

String

false

The date-time at which this {@link SuperUser} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link SuperUser} was deleted. This will be null for an {@link SuperUser} that has not been deleted. If this property is not null, then the {@link SuperUser} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/super-users' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJzSmFPQkFGZ2c3NEpGM1h1TUc3Zk5nIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImViMDA1YmYzLTllMzctNDAwNS1iNjNhLWFjYzMyOWExNDdiNSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5NCwiZXhwIjoxNjExMDgwNDk0LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYjdmMjQxMjMtMjcwZi00ODg3LTlmOWYtZWFhNzBkZjlhZTI5XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODk0fSx7XCJpZFwiOlwiNTNlMzA4ODMtZTQ0Yy00YmYyLThlM2ItNzJlMmExOWNkMGU1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODk0fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.bim7FLYAABN1ogDdxhBsjUat6IpisUsycfkv3W9Zx012heFfh1kkLUG3r6TR3m45Y1vpCCG7RmBGLxWtmMP9ov616ug281QHTSzy0L3Nx4NzEe1B83o5uijyjrf5IAKmYkYxwUFAjwVKSSdlmR2a_E-mFR8oNH-K6ARxpmGzPZjUxTG_5-fLOb_vRe5APmjuKjwhYPic2VZV4ZeD8RLCSdtlgEzKNgwuK08Je0ADxfIzXnGWgRaZhuXUzyqkBliass22ifyKGB20RYtOHfZuh8L0hZ7WQ-1-dSOChwRTaP47ZIuFW8RTNj2oQloWbNzwdHZhNruR6uPrfkAkdZOb6g' \
    -d '{"identityId":"5a2f2b28-b001-4b32-9c63-c8692c27a768","domainId":null}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 488

{
  "id" : "2b4ae70b-25fe-42da-85af-f4099012287b",
  "identityId" : "5a2f2b28-b001-4b32-9c63-c8692c27a768",
  "domainId" : null,
  "createdBy" : "eb005bf3-9e37-4005-b63a-acc329a147b5",
  "createdAt" : "2021-01-19T17:21:34.120416Z",
  "updatedAt" : "2021-01-19T17:21:34.120416Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.superuser.SuperUser",
  "_title" : "Grant All Actions (SU) in All Domains to identity 5a2f2b28-b001-4b32-9c63-c8692c27a768"
}

Delete Super User

DELETE /super-users/{id}

Authorization

This endpoint requires delete action on the super-user resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/super-users/07a5020f-354c-4866-af58-939c48897c74' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJrc1RZTU5MWW03WUdENFZoSjZabDJBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjgxOGE3ZTRmLTAzYmUtNDllNy1iOGQ2LTU4NjMxNmEyNWQ2NSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5NCwiZXhwIjoxNjExMDgwNDk0LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMTA1ZTlmNjktMDNmNi00ZjRmLThiN2QtZDZkZDlmZjc4ZDcxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODk0fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.QPx8_OVG-1NL6soEwq-mzXuh0y6dL13cB7h6-x7idVzATHpaIQh7lFqcy_ZnDZK0-TpoRlBOyAHdFwshe0jV-G8-9YLeewXIkKJz1q40kvBuKcMwjj1awlZMQ1dQ2z3fVKq0K3xroTE6zB7he9P7mi3Ut9i_91FBwq0SIo2heQbUwE36xNZuSPlIEl-FaCXT3Saymus9R5mE4ITLNQVBhZYG-CHf8H_LZrw63iFTKFDFIL2etwMkBUk1Ql9sOYEd_Wl06alhMy0YATajilaX01nVzrKw6ez5VxU0DepzpWlKNaFOdh_uPhxxg0_ZFYL7Z54xpNWp42ukkIq1rFfavg'

Example response

HTTP/1.1 200 OK

Public Grants

Find Public Grants

GET /public-grants

Returns a set of {@link PublicGrant}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the public-grant resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

resourceActionId

Object

true

Filters results to those that grant one of the specified {@link ResourceAction}s.

isAnonymous

Boolean

true

When true, filters results where the isAnonymous property is true. When false, filters to those with the isAnonymous property is false. When not specified, the results will include those with both true and false values for this property.

path

Object

true

Filters results to those that target any resource along the specified path. For example, if the path is to Network X which is under Network Group Y, this would restrict the results to {@link IdentityResourceAction}s that grant an action on any resource under Network X, an action on Network X itself, or an action on Network Group Y. Combine this query parameter with resourceActionIds to limit the results to the types of actions along the path that are of interest.
The path value must start with a domain code followed by a colon. It may then have a comma delimited sequence of colon separated resource type code and resource id pairs. The path structure must match that of the server defined resource tree for the specified resources in the specified domain.

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].resourceActionId

String

false

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link PublicGrant} was created.

[].updatedAt

String

false

The date-time at which this {@link PublicGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link PublicGrant} was deleted. This will be null for an {@link PublicGrant} that has not been deleted. If this property is not null, then the {@link PublicGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[].path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link PublicGrant} targets.

[].path[].resourceId

String

false

[].path[].resourceTypeId

String

true

[].anonymous

Boolean

true

If true, then any client may perform the linked action even if not authenticated. If false, then a client must be authenticated in order to perform the linked action. The actual identity id of the client does not matter for {@link PublicGrant}s.

[].type

String

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/public-grants' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJCbW1VSXk2SG90YVlSNDFaaHVnaThBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjU0MDE0OWQzLTc4MzYtNDc1Zi1hMWUyLWYyZjk2ZmQxNzc3YyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNzVmYjViNGEtOTAwMy00ODU4LTg3MDQtNDY5Y2YyODU2ZGVjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.Gu4z2O0kBqhQVb3QmbanPbpws_NrwBuRsKHh8vZCcsd7gAkCWvRJFcrusZIIe8kvvY1b0cKy3FfqCB6eTA-fJ6lYsR-AjbgXqMbtbL63d6cFFpBpSfvBD-9A34reQHcf4VBiqQdsd1dHibMZE1zy8LSI36oJPO1tI7vm8vdhSXEIQ7BmFoOAGgiFqGUaFUQabfSIWRSD01oSpbIXWe6mRMCepFfZLXCzGnLbJXYS6bC72tnilVXrv0xzQ_NoGIBMTAQmEC4AZIr3vgHOtJ9c7UyTREXLY834akrUvzfqJ4f0RUY2rjaQDCxwo6sp0ds5eObniCDuuEU4Z_R3ORnaDg'

Example response

HTTP/1.1 200 OK
Content-Length: 1486
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "cba0768d-cf16-48d8-808e-57b098244ffa",
  "resourceActionId" : "c9bc89c1-a4eb-4fa6-8b8b-5c3fa5183a46",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.492391Z",
  "updatedAt" : "2021-01-19T17:21:22.492391Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "anonymous" : false,
  "type" : "io.netfoundry.auth.domainv2.publicgrant.PublicGrant",
  "_title" : "Grant Read Network Configuration Metadata, All to All Authenticated Clients"
}, {
  "id" : "9b866056-1a6b-49d5-a497-cede5249117c",
  "resourceActionId" : "7ff28865-2226-46ec-bb93-991644d2b726",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.369090Z",
  "updatedAt" : "2021-01-19T17:21:22.369090Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "anonymous" : false,
  "type" : "io.netfoundry.auth.domainv2.publicgrant.PublicGrant",
  "_title" : "Grant Read Resource Type, All to All Authenticated Clients"
}, {
  "id" : "6f3856b5-0400-44cd-97b7-f5650b5fe275",
  "resourceActionId" : "c8a86da5-16ee-4e88-bee0-8b1b59e04bbf",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.149950Z",
  "updatedAt" : "2021-01-19T17:21:22.149950Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "anonymous" : false,
  "type" : "io.netfoundry.auth.domainv2.publicgrant.PublicGrant",
  "_title" : "Grant Read Geo Region, All to All Authenticated Clients"
} ]

Get Public Grant

GET /public-grants/{id}

Authorization

This endpoint requires read action on the public-grant resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

resourceActionId

String

false

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link PublicGrant} was created.

updatedAt

String

false

The date-time at which this {@link PublicGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link PublicGrant} was deleted. This will be null for an {@link PublicGrant} that has not been deleted. If this property is not null, then the {@link PublicGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link PublicGrant} targets.

path[].resourceId

String

false

path[].resourceTypeId

String

true

anonymous

Boolean

true

If true, then any client may perform the linked action even if not authenticated. If false, then a client must be authenticated in order to perform the linked action. The actual identity id of the client does not matter for {@link PublicGrant}s.

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/public-grants/97ed0e21-07e0-4fd0-9edd-df45c66395b2' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJpbGFBNk1BYnViTXR6bndabWo4RnJnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImUxMzQ5OTZjLWZkNjAtNGY2MC1hNDg0LWY5OGVkNDllYzU4NCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNzBlNDQzMGItYmY4Zi00OGQ4LWFkZjUtZGM3YzU4NzliZDNjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.CcUvqDsO7oBV0aqNdHyoxCrRa5XzrepLtS_KveuspIrYtVd5XH6etb9pFVvsAps_7nziA8zywgMCV2GHkEAirylCGmGwn_Ij8tFIdO-jY8xRJoDobiGixhChNysm3ZhiOdJY14GtzEiCcbW6jeAKyND4DO53zgNQL5X83r07tfdVbBgDceSkVLvDW6YE1RPdg3WRa0rAzm5EyLZjOdikWwPa8LcGse5IA0S0K-DZ8ZbZY8RNuNZp9tNp5jUQxN9iJqV4PUoFZiqCrYHO90dpfGzaXODGs21kGQx8PZzW6sqv7fv5g9yLMh6Vq5-Ekc60gIvL18i8RIBKjgYRpVggIA'

Example response

HTTP/1.1 200 OK
Content-Length: 678
Content-Type: application/json;charset=UTF-8

{
  "id" : "97ed0e21-07e0-4fd0-9edd-df45c66395b2",
  "resourceActionId" : "76a72cec-b016-4aaf-827c-e00e6fcf3a07",
  "createdBy" : "1d37b3ea-846d-4441-9b6e-1e7730a38f03",
  "createdAt" : "2021-01-19T17:21:33.468179Z",
  "updatedAt" : "2021-01-19T17:21:33.468179Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "d43f12b2-6520-40ae-9d55-d12c637e0f45",
    "resourceTypeId" : "54a2af26-d6fa-44d8-b238-987b054f9d03"
  } ],
  "anonymous" : false,
  "type" : "io.netfoundry.auth.domainv2.publicgrant.PublicGrant",
  "_title" : "Grant Test Action 63 Test Type 62 on/under Test Type 62 d43f12b2-6520-40ae-9d55-d12c637e0f45 to All Authenticated Clients"
}

Create Public Grant

POST /public-grants

Authorization

This endpoint requires the following actions:

  • create action on the public-grant resource type

  • read action on the resource-action resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

resourceActionId

String

false

Client must have read action on the annotated resource.

path

Array[Object]

false

path[].resourceId

String

false

path[].resourceTypeId

String

true

anonymous

Boolean

true

Response fields

Path Type Optional Description

id

String

false

resourceActionId

String

false

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link PublicGrant} was created.

updatedAt

String

false

The date-time at which this {@link PublicGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link PublicGrant} was deleted. This will be null for an {@link PublicGrant} that has not been deleted. If this property is not null, then the {@link PublicGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link PublicGrant} targets.

path[].resourceId

String

false

path[].resourceTypeId

String

true

anonymous

Boolean

true

If true, then any client may perform the linked action even if not authenticated. If false, then a client must be authenticated in order to perform the linked action. The actual identity id of the client does not matter for {@link PublicGrant}s.

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/public-grants' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2TFBMdGV3NGpEYVk3a2xkQW1FTW13IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImM4NDFiMWFkLTZkMWItNDQ1MS1iZmVlLTI4MWYyNTE4ODJmOCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNzExZDM4ODYtNWJlZC00ZTlhLTg0ZjQtZWMyNTRhOWIxYmVmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiOTVhOGMzODUtNjY1NC00ZTU1LWI3MWMtNzM3N2RmOTk5MTk1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.KjagDpEGmzNpS5I-5nlF-6oVLGiHPEia2-REFPoobcCjmQihWsgQVsRTQ2LJ0WwPUhsv37Ghc4DFCuFcW4IsdksV81f1gYHpuC5M2BhvgQ6-U7jzLEBOFZDVU8Gm431cCMB1FiyjOCuA9NjWXT7swjLyi1Jg4Ylvt3uWlN35-iJ-iaHkaRuWjbRbEzf4d_oqcQ5dpIxAkj4krihyCErCS5KpepmHpPQ0ZSh10GwPfWRmEUsLaLuQGxjsTahYBx1OA0Lj7ZVuDyN_xiKjuNuIH50I9Y0DTMpOLTgDayyBUDMtQF2GZ6siE4bRfzvNZHtkxquaJHiWAPhHOfOu2IK_jA' \
    -H 'Content-Type: application/json' \
    -d '{"resourceActionId":"78b980a3-7c96-40c2-ba6e-d54a14b6d065","path":[{"resourceId":"e92a4a04-e639-491a-8de1-531998ad8b84","resourceTypeId":"b5e45843-2145-475b-8bd9-01a80c299b62"}],"anonymous":false}'

Example response

HTTP/1.1 200 OK
Content-Length: 669
Content-Type: application/json;charset=UTF-8

{
  "id" : "3248b98c-3710-40e1-9faf-f5ace6fb884b",
  "resourceActionId" : "78b980a3-7c96-40c2-ba6e-d54a14b6d065",
  "createdBy" : "c841b1ad-6d1b-4451-bfee-281f251882f8",
  "createdAt" : "2021-01-19T17:21:33.603832Z",
  "updatedAt" : "2021-01-19T17:21:33.603832Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "e92a4a04-e639-491a-8de1-531998ad8b84",
    "resourceTypeId" : "b5e45843-2145-475b-8bd9-01a80c299b62"
  } ],
  "anonymous" : false,
  "type" : "io.netfoundry.auth.domainv2.publicgrant.PublicGrant",
  "_title" : "Grant Test Action Test Type on/under Test Type e92a4a04-e639-491a-8de1-531998ad8b84 to All Authenticated Clients"
}

Delete Public Grant

DELETE /public-grants/{id}

Authorization

This endpoint requires delete action on the public-grant resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/public-grants/a786b213-d1f0-4591-b789-711c1dce14b3' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI4YzlkSGpYRXB2NUluemF4VHZZTDl3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImNiYjM4NWUxLTdlY2QtNGU3Yi04MzNhLWI2M2FmOTY5MmI0MCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImE3ODZiMjEzLWQxZjAtNDU5MS1iNzg5LTcxMWMxZGNlMTRiM1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMTI5ZGUzNDUtNWZmOS00YmNkLWFmZmEtYzBiMjI4MTU3ZjRiXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.hDJKBf8pF43B0K0h-HSZaU-TPwlp6-5ihHmioH_b10kAFasl9kzLiNQNQOuPS-eodLmwBr_WFG-dzwx1-8bUQorxjIpv_wKF5NLMTXRA6Q_nVbkI0pCqsBmr-a1ftBgOZd2LnVE6HjyowVaEygtUnuWeMOZw1TRnLCLY7egw_cAJvlzgmh4waoXJMBH-6GHwv69rDrAc6UDMKlm23GWjCRpOm9IuPbckJ_DewFpHvLb5dpl_CvRYqtsUF6_sKL1wQ0IHh4oS9QHf7nRjdEnzaKaxC7UFfbI_IZv6F50Rt3tVaCGORlYK4SLq4H-jqRBNL3_sWjCFl9IsfRyNShAHxw'

Example response

HTTP/1.1 200 OK

Identity - Resource Action Grants

Find Identity Resource Actions

GET /identity-resource-actions

Returns a set of {@link IdentityResourceAction}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the identity-resource-action resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

identityId

Object

true

Filters results to those that grant to an identity specified in this set.

resourceActionId

Object

true

Filters results to those that grant one of the specified {@link ResourceAction}s.

path

Object

true

Filters results to those that target any resource along the specified path.
For example, if the path is to Network X which is under Network Group Y, this would restrict the results to {@link CustomRoleAction}s that grant an action on any resource under Network X, an action on Network X itself, or an action on Network Group Y. Combine this query parameter with resourceActionIds to limit the results to the types of actions along the path that are of interest.
The path value must start with a domain code followed by a colon. It may then have a comma delimited sequence of colon separated resource type code and resource id pairs. The path structure must match that of the server defined resource tree for the specified resources in the specified domain.

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].identityId

String

false

The id of the identity to whom this {@link IdentityResourceAction#resourceActionId} has been granted.

[].resourceActionId

String

false

The {@link ResourceAction} that possession of this {@link IdentityResourceAction} grants to the linked identity for resources under the specified path.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link IdentityResourceAction} was created.

[].updatedAt

String

false

The date-time at which this {@link IdentityResourceAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link IdentityResourceAction} was deleted. This will be null for an {@link IdentityResourceAction} that has not been deleted. If this property is not null, then the {@link IdentityResourceAction} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[].path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link CustomRoleAction} targets. For example, if this {@link CustomRoleAction} is "Update Widget Service" then this property defines the (id) path of/to the "Widget Service" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to the {@link ResourceAction#getResourceTypeId()}. Both must target the same {@link ResourceType}.

[].path[].resourceId

String

false

[].path[].resourceTypeId

String

true

[].type

String

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/identity-resource-actions' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkYVhNOHY0Qnlrc0VBNEY0MmxoQ0ZBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImEwYjFkMTdkLTU0ODUtNDJlZS1hMmQ3LTNlNzBhNjcwYmEzNSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYjQ1MjI1NDEtYzRiNC00OWNlLTg4MDAtMzhlYTcxMGU3Y2JlXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg5fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.cn703UrOBxtFwVvz8Rx3GHoSZTLsQgqnL8603u90BUVHznfehWVclrQ5U4xEhGF930oaVPpAqg2k7h66NIOFRl-nFklgK0pcIiDboLHiIiqWrvwRrAaBPjdwsHBGdKjQ9qUpYLd79o44ph8qNCuR_QYw6UZRFb9zBrrqxE21qkt6L3ayc_SjrFqzVx89sy-HfIvGRkzf_or022MRQueR2WOVtcF7GWnj2-6jGy9I7ML-4UY2QXDcdYYMIZtd3Rus2RbgrNspqNcKs1-x7McckA_7UIYEA52GgSi7eIviSDZHP7uvRzok0dmGTCZ0ZoAx_r4Gs5HKlmHgnfaiXe5NWA'

Example response

HTTP/1.1 200 OK
Content-Length: 1708
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "a987cdf2-43da-42f7-91e3-fe0bd73f1f93",
  "identityId" : "ef777a05-b53f-4a69-93f4-76655267a290",
  "resourceActionId" : "3bcc0806-2ee6-4ad7-ab5b-28e94dddb70f",
  "createdBy" : "b9ca5935-dbd3-44c3-a239-df80dd41fbc1",
  "createdAt" : "2021-01-19T17:21:28.094659Z",
  "updatedAt" : "2021-01-19T17:21:28.094659Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "type" : "io.netfoundry.auth.domainv2.identityresourceaction.IdentityResourceAction",
  "_title" : "Grant Read Domain, All to identity ef777a05-b53f-4a69-93f4-76655267a290"
}, {
  "id" : "2e786695-75ef-4421-908b-1d6ba7016643",
  "identityId" : "944946fd-e23f-4b88-bc8c-558e8df5e979",
  "resourceActionId" : "debeac7e-6f52-4ea4-a85d-78f96e96ee1f",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.324361Z",
  "updatedAt" : "2021-01-19T17:21:22.324361Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "type" : "io.netfoundry.auth.domainv2.identityresourceaction.IdentityResourceAction",
  "_title" : "Grant Create Identity Resource Action, All to identity 944946fd-e23f-4b88-bc8c-558e8df5e979"
}, {
  "id" : "5cdd17a3-1300-436c-91e7-98f72a5a46f6",
  "identityId" : "944946fd-e23f-4b88-bc8c-558e8df5e979",
  "resourceActionId" : "889f2475-20b7-4d41-a13a-55c26d99549f",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.325284Z",
  "updatedAt" : "2021-01-19T17:21:22.325284Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "type" : "io.netfoundry.auth.domainv2.identityresourceaction.IdentityResourceAction",
  "_title" : "Grant Create Standard Role, All to identity 944946fd-e23f-4b88-bc8c-558e8df5e979"
} ]

Get Identity Resource Action

GET /identity-resource-actions/{id}

Authorization

This endpoint requires read action on the identity-resource-action resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

The id of the identity to whom this {@link IdentityResourceAction#resourceActionId} has been granted.

resourceActionId

String

false

The {@link ResourceAction} that possession of this {@link IdentityResourceAction} grants to the linked identity for resources under the specified path.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link IdentityResourceAction} was created.

updatedAt

String

false

The date-time at which this {@link IdentityResourceAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link IdentityResourceAction} was deleted. This will be null for an {@link IdentityResourceAction} that has not been deleted. If this property is not null, then the {@link IdentityResourceAction} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link CustomRoleAction} targets. For example, if this {@link CustomRoleAction} is "Update Widget Service" then this property defines the (id) path of/to the "Widget Service" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to the {@link ResourceAction#getResourceTypeId()}. Both must target the same {@link ResourceType}.

path[].resourceId

String

false

path[].resourceTypeId

String

true

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/identity-resource-actions/eb6d54eb-3695-446c-92df-8b77f9a3e0cd' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJPSWpPU2ItNHFMNnlJZG1IS3kza3NnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImU0M2VmMDJkLTA4ZTctNDgzNy1hMzBiLTg3MzIyNWYyN2I4MyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiZmZmMjU0ZWMtNmQwNi00MGMzLWE3NWItMDI5MWViYWNjZTkzXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg5fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.HcP5ySku_M2ddo9h0-WYixDTDg3GPQlmNwJ58zs5hUaTWG6CoTqgNyQBpaTsYo26TuT8IF3TVsUjYos6y5TALdBZyNbtHJERvHsZPLeg-PKueoFqpzgtCklBIEC_pwqc1EaKGFrgMf3zF1eGDpFsidAS96SXWc23J1CsbMFt_Xl7RrYCASwZu9dAyeppmUQtxhDKbLqXX7YqGByIeF4SO4ESdM0l4ZtAAPPj1ZTvJsAX4wLbi_lQKHO_wP9OX3uezvuTk-_4roVamRzvtWlKBi-4YAeekvF7gB6Qmc-8lOd3lABBEiO40G7ui_-85A8FBygTxDRNG_8yKs39zReGDg'

Example response

HTTP/1.1 200 OK
Content-Length: 754
Content-Type: application/json;charset=UTF-8

{
  "id" : "eb6d54eb-3695-446c-92df-8b77f9a3e0cd",
  "identityId" : "945e7edb-f4f9-4b63-992e-8d330d0b0033",
  "resourceActionId" : "3cfe9fb8-b029-4bc8-8bdc-f21c81e8f5ca",
  "createdBy" : "92ae770b-3b83-481f-bc3a-67b1ac5253ca",
  "createdAt" : "2021-01-19T17:21:29.883008Z",
  "updatedAt" : "2021-01-19T17:21:29.883008Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "5b1f38fc-f75d-4027-8972-cda6a3c23c8f",
    "resourceTypeId" : "4f9ea24f-a9b6-43c8-b094-53d34ab30322"
  } ],
  "type" : "io.netfoundry.auth.domainv2.identityresourceaction.IdentityResourceAction",
  "_title" : "Grant Test Action 28 Test Type 27 on/under Test Type 27 5b1f38fc-f75d-4027-8972-cda6a3c23c8f to identity 945e7edb-f4f9-4b63-992e-8d330d0b0033"
}

Create Identity Resource Action

POST /identity-resource-actions

Authorization

This endpoint requires the following actions:

  • create action on the identity-resource-action resource type

  • read action on the resource-action resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

identityId

String

false

resourceActionId

String

false

Client must have read action on the annotated resource.

path

Array[Object]

false

path[].resourceId

String

false

path[].resourceTypeId

String

true

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

The id of the identity to whom this {@link IdentityResourceAction#resourceActionId} has been granted.

resourceActionId

String

false

The {@link ResourceAction} that possession of this {@link IdentityResourceAction} grants to the linked identity for resources under the specified path.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link IdentityResourceAction} was created.

updatedAt

String

false

The date-time at which this {@link IdentityResourceAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link IdentityResourceAction} was deleted. This will be null for an {@link IdentityResourceAction} that has not been deleted. If this property is not null, then the {@link IdentityResourceAction} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link CustomRoleAction} targets. For example, if this {@link CustomRoleAction} is "Update Widget Service" then this property defines the (id) path of/to the "Widget Service" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to the {@link ResourceAction#getResourceTypeId()}. Both must target the same {@link ResourceType}.

path[].resourceId

String

false

path[].resourceTypeId

String

true

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/identity-resource-actions' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2ZWxIVXBXSFhkdVdGMGwxWElzSHdBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjQxMjFmYTkwLTcwNTEtNDg3Zi05MTQwLTM5YjUzY2JkMDgyYyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYzMxMDY0MjAtZDk2Yi00NmI4LTgxMjctYTNhMjMxZjBkOGQyXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg5fSx7XCJpZFwiOlwiYTMzMTFhMTEtMDQ4Yy00MWFjLTgxOGQtMWRjNGY4YjMxNmNhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg5fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.dUTgjzA8zI13lD2dvAWRZVPsyrCPuYYMm5vOWIO7Ck8uv0HbIyuTl8n4fSn_vuQKx_tUVLFFTCMuzDj5c-zEMZshPKtKl_1mmEmGIs_hcFZkohMlKI7YDjXrJXZB8pNDzgHINpIQQbydetlaw1-iLmejmVQ-zvoaY4IOB4JGk7Iz2GdVbJB9uHBXGerqyICFQOopp1Dcgm2LDQHMVKEL0o5N2JmLNF-s-VfAnmE-b6IpTyVzsdh05wQ3iG5zrLOqx_gV7vedaRLqryYPFim3KAdjIt19v4Yr9xH7ZQ7CCNcBvizKET-jrKJQzh-rpJPSXXtCut_zEWnF_wSziM0p_g' \
    -H 'Content-Type: application/json' \
    -d '{"identityId":"f836b3dc-487d-4562-8e0f-a6552a29853b","resourceActionId":"78b980a3-7c96-40c2-ba6e-d54a14b6d065","path":[{"resourceId":"eace6753-bf37-4ff1-badb-7601c46a9fad","resourceTypeId":"b5e45843-2145-475b-8bd9-01a80c299b62"}]}'

Example response

HTTP/1.1 200 OK
Content-Length: 745
Content-Type: application/json;charset=UTF-8

{
  "id" : "a5aba8b3-d261-4c20-a2a1-1b272f62792f",
  "identityId" : "f836b3dc-487d-4562-8e0f-a6552a29853b",
  "resourceActionId" : "78b980a3-7c96-40c2-ba6e-d54a14b6d065",
  "createdBy" : "4121fa90-7051-487f-9140-39b53cbd082c",
  "createdAt" : "2021-01-19T17:21:29.985184Z",
  "updatedAt" : "2021-01-19T17:21:29.985184Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "eace6753-bf37-4ff1-badb-7601c46a9fad",
    "resourceTypeId" : "b5e45843-2145-475b-8bd9-01a80c299b62"
  } ],
  "type" : "io.netfoundry.auth.domainv2.identityresourceaction.IdentityResourceAction",
  "_title" : "Grant Test Action Test Type on/under Test Type eace6753-bf37-4ff1-badb-7601c46a9fad to identity f836b3dc-487d-4562-8e0f-a6552a29853b"
}

Delete Identity Resource Action

DELETE /identity-resource-actions/{id}

Authorization

This endpoint requires delete action on the identity-resource-action resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/identity-resource-actions/0eab352b-e29b-4f01-945e-fd23301e15e1' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwdFdSZDRWamFVaUFFSVVYTmRhZE13IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImJmNWQwNjEzLWExNDgtNGQ2ZC1iZDEyLTMwM2FiOWQzOWZhOSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMTNkZmI5ZTktNDkxMC00NDI1LWFkMDQtZTZjMjk2ZGNhYTAxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg5fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.Tx686M_4CJSKPkxJt3abpod-JTtmAcFng42uKHX-sKQbdZcmamZkdaNWe4ey85qizbQvI1dcaOkVoTyqTnip0truXJhTjKGFAJxt0vkFGUweulMK_XwwSZo9HTWXZI6XBLlo3MXB0rWegyyHrQTpCIG5qLYQmPihlSexg6y7qabpR-wsg9lPcBXF14CSDnvCzBLExOgVnpmA5wZSTvc872vsTFAkF9L5YU4PNNw0o1L_8Z2X8z4CFID-53e0jBIkbFXOi3KsGtvBOoi5Mq2hxZ6sllxz70CEtcRfityrSu1VCeRZEVor5d0ItU7FuqInrourlf8M02ODCiml_qkW7A'

Example response

HTTP/1.1 200 OK

Custom Roles

Find Custom Roles

GET /custom-roles

Returns a set of {@link CustomRole}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the custom-role resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

identityId

Object

true

Filters results to those granted to one of the specified identity ids.

resourceActionId

Object

true

Filters results to those that grant one of the specified {@link ResourceAction}s.

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].name

String

false

The human friendly name of this {@link CustomRole}.

Size must be between 1 and 256 inclusive.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link CustomRole} was created.

[].updatedAt

String

false

The date-time at which this {@link CustomRole} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link CustomRole} was deleted. This will be null for an {@link CustomRole} that has not been deleted. If this property is not null, then the {@link CustomRole} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[].type

String

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-roles' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJWeFdSZF9oTXV0YmRPcGd0VGUwbDh3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImM2NzZiZjcxLTE2YzEtNDllNC1iZjY3LWYyZmIxZDMxNGNhNSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDgwNDkxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiZTgxN2MyMzMtM2M5Yy00YTczLTkyYzgtYjVmN2RkMmM2ZDY3XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.N7vk3EOLbzgChqqS3KLcf-AL9eofrA9QoGIo1mqcCmivpWxdx1AnNwOLfIsJD3diQwDhs5mKWxpAz3GFEdfQlsmT-Fdn9ezrsH-TGvvO9qkisi-EW_FtnPdWF_vc98QQ5alAXCtvGtRFL67qVknhtsF0FRO6taBB_D0S9K34J_CPXCaIpJbcCaoIZsdsDzT84gw1zEUKB0TOau_d7pWAAtbwEy0GBH_1oYQJtt0Ly1oUw5_GarBAzvk2V1e_VDl4KRE9X7LKMoXOzY94o07q1qFIHHOKspcfOFcEi1wgLu-0hNSrkQzEYV1T9dtANmjwajKe0bDXfKRhexIURw3LxA'

Example response

HTTP/1.1 200 OK
Content-Length: 1151
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "e7127acc-b39c-462c-adba-39f5233e9f8c",
  "name" : "Test Custom Role 44",
  "createdBy" : "5e4cc27d-7a0e-4402-881b-9ebba9434572",
  "createdAt" : "2021-01-19T17:21:31.400738Z",
  "updatedAt" : "2021-01-19T17:21:31.400738Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.customrole.CustomRole",
  "_title" : "Test Custom Role 44"
}, {
  "id" : "665bf926-a4de-4a65-a59e-1206e0ff6fcb",
  "name" : "NF Support (Read-Only)",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.502437Z",
  "updatedAt" : "2021-01-19T17:21:22.502437Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.customrole.CustomRole",
  "_title" : "NF Support (Read-Only)"
}, {
  "id" : "9370b9d8-b62f-49c7-9054-16ef850d4a21",
  "name" : "Test Custom Role 48",
  "createdBy" : "27fdcdfd-6e20-48aa-b42b-6fd6c5cc6440",
  "createdAt" : "2021-01-19T17:21:31.565467Z",
  "updatedAt" : "2021-01-19T17:21:31.565467Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.customrole.CustomRole",
  "_title" : "Test Custom Role 48"
} ]

Get Custom Role

GET /custom-roles/{id}

Authorization

This endpoint requires read action on the custom-role resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

false

The human friendly name of this {@link CustomRole}.

Size must be between 1 and 256 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link CustomRole} was created.

updatedAt

String

false

The date-time at which this {@link CustomRole} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link CustomRole} was deleted. This will be null for an {@link CustomRole} that has not been deleted. If this property is not null, then the {@link CustomRole} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-roles/152c5050-0d73-4b45-a85d-af71d4f14501' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJkWkIxUW5kYVNlM0ZBUl96X2pvbU53IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjJmZmM5ZWY5LTE2YTEtNDJiMy1hOTkyLTNlNzA3YjU4ZGVkYyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDgwNDkxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNTU5ZGQwYzQtNTAzYS00N2E0LWFmMjEtNGNjZDUxYzM1YzM5XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.dqHKpro8LRkUZ-NZV-kTHMs2n5T-sQzJUesbEvxx3K4zNyhvqNbvPW8R5R_8nMEkuIX2m2AIN2X7sbK_R_9scBGjYujidM6qFgou77s41FaD014K37WrFHlBvW_BWh14f3wY_q-7AGimjxNDHEZu0MqmE4toYGgsdlpmHzhT2kuHDI-rHaR9Uffc87f98pNFeoJBpH7q3zUagXPs5s-uYy7x9wr5MuU_wbJsVUgdVZ1bvDXytbpjIxMbhAWmbSjN6e3gLD9IgJQaLZp41Wte1KWHyEWQbXkpRSjsDQk9Q1ziwXDcyUosWRnQSfsWhknmXK5XGrnLVST7Xhx6xejefA'

Example response

HTTP/1.1 200 OK
Content-Length: 379
Content-Type: application/json;charset=UTF-8

{
  "id" : "152c5050-0d73-4b45-a85d-af71d4f14501",
  "name" : "Test Custom Role 52",
  "createdBy" : "cc5c7e39-b7f9-445a-a5d1-f0e1c3271caf",
  "createdAt" : "2021-01-19T17:21:31.845275Z",
  "updatedAt" : "2021-01-19T17:21:31.845275Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.customrole.CustomRole",
  "_title" : "Test Custom Role 52"
}

Create Custom Role

POST /custom-roles

Authorization

This endpoint requires create action on the custom-role resource type.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

false

Size must be between 1 and 256 inclusive.

Response fields

Path Type Optional Description

id

String

false

name

String

false

The human friendly name of this {@link CustomRole}.

Size must be between 1 and 256 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link CustomRole} was created.

updatedAt

String

false

The date-time at which this {@link CustomRole} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link CustomRole} was deleted. This will be null for an {@link CustomRole} that has not been deleted. If this property is not null, then the {@link CustomRole} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-roles' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJMTTF5UjdxQUVBTnBwY0x4YXZ4ODBnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImM4MGQ4OGQ4LTFmMzYtNDMwYi04Nzg5LWVmZjc0YmZlYzY4NSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNDk0MmQwNzQtNTg5YS00YThjLTg1OGQtODNmZGZjYjBkYTMzXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.aLByj8PbPexquPKZebU6gE4TmtmEq7bpBcDBO4-cxEZcLiH5VeyHws11g85akY-AmuMPpyC2hxEcPhLitj7UvabSkePRKRnhsfgrCKy3GNZ5RHNcs5Wb6Nuz1FsSu7NBFrai73UEWmwsdPTS-XnvWcHCiP0Pzham2OHAclNynUbAuV3W97S5hClGfqB3ApGUvvW4lAGPLp5OSx8dyqlf5FOoz_QJOnOcw4yoPBR70X7eMLUSlLlUs90_a8eXNYupGGjQSTQmGZxs7sMQscqwcmRSzCcsAxl5Abx3f8-G38zkTzcahW8V6iVb-9yAXx6jSXEayQbBMrNvwhYNEV1uMA' \
    -H 'Content-Type: application/json' \
    -d '{"name":"Test Custom Role Create"}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 387

{
  "id" : "b8076dfe-b2e4-4b2c-9494-23339553821a",
  "name" : "Test Custom Role Create",
  "createdBy" : "c80d88d8-1f36-430b-8789-eff74bfec685",
  "createdAt" : "2021-01-19T17:21:32.276869Z",
  "updatedAt" : "2021-01-19T17:21:32.276869Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "type" : "io.netfoundry.auth.domainv2.customrole.CustomRole",
  "_title" : "Test Custom Role Create"
}

Delete Custom Role

DELETE /custom-roles/{id}

Authorization

This endpoint requires delete action on the custom-role resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-roles/ae6e992b-0e9c-4df5-9bda-7e4a2b5fb696' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2QTg2bklnWGVWMmdLQnhmRkhkMVFBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjdlOWE3OWZiLTYzMzYtNDg1NC05YTk4LWE4YzdiOTU0ZjVjNCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMzhmMmZiODMtY2UzOS00MTkzLWJjMDctNDNjYTAzYTk1OTE1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.PeBFKxB_f_lo-vK595PewBZ99OseoD-Rc8ZfEoMBNC65EIIEkUhQDqPaeWd0o5vIC83HV9hxy53Jp741uk5TQaruLjAGqq5GF7sraMKOCLHZSEovTBAWUxFAEtsH90_Z0ZWk1g8Gb0m_kAlpySrvVKkruK9S4zIYWh_wTuYaJlacimpGDli8FxXV0RZN_-bqBJaJGa-pecQURJQiVKaFpEsNrJaRbvUCUGSRc2SWXJ2kxiuJXX9N4eG3USV5c4CDEm3I5kNScjkHgtcTqhURdcDQZBWCVshor-UP_bxix7GYKnWO4SSoC3VvEuYDU2ugBvXBl8MFn_rXRfdePeLnCw'

Example response

HTTP/1.1 200 OK

Grant Custom Role (deprecated)

POST /custom-roles/{id}/identity-grants/{identityId}

Deprecated.

Deprecated. Use {@link CustomRoleGrantController#createCustomRoleGrant} to grant an identity a standard role.

Authorization

This endpoint requires the following actions:

  • read action on the custom-role resource type

  • create action on the custom-role-grant resource type

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have create action under the annotated resource.
Client must have read action on the annotated resource.

identityId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-roles/1c997a5e-2c5d-4f83-a760-76052dd79fb3/identity-grants/7fe01335-c22e-4540-a563-8236a62e0b8d' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIzcjBvNkVwQlVrcHY2ZjJPd2l1eTNnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImQ2NzU3ZDA4LTc2MTgtNDQ3ZS05ODM5LTA5ZGYwMDYxOTg5MiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiZWZmMmQzNTUtOWEyNy00YjU1LTkxNzctYzVhYjkxZDc1MzdhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfSx7XCJpZFwiOlwiNjA1NjUxNWEtNzY4Ny00MzA5LWFiMmItODBiZTFlYjBlMDRmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.aztjH5nP_00cTeGy9t81CjbiZoUHdha-s7ewKnG-9AFq1IW7EzzZnJVgQV4f6ESstAQL4pctWvBpxKn6f7Dj_4x1BNpfw-LyVeY6s_GsP0Vwdw0AFzNIiwsh1wWfzyy-SaY_aGvepEn5Y70P3hmax-NAy-XJh7gW4gf7q_n3w68caQDZ-jJzvB2Quc4ywrU8cRphav8rdW6gljhzBHpa4i7mDBdtkgejD6iXRb_X9zk7JjYqY3RmTSZ2j15wpU-6YVKQKUw1PbDVkIOlgR32dQK8C6t7th05njeAZax9pMvafKuEk4wDVoBtAIPxGIPOmfGADgS10vGF_qy2sV7THQ'

Example response

HTTP/1.1 200 OK

Revoke Custom Role (deprecated)

DELETE /custom-roles/{id}/identity-grants/{identityId}

Deprecated.

Deprecated. Use {@link CustomRoleGrantController#createCustomRoleGrant} to grant an identity a standard role.

Authorization

This endpoint requires the following actions:

  • read action on the custom-role resource type

  • delete action on the custom-role-grant resource type

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

identityId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-roles/4a019bd2-b575-4a11-954e-70d2e9df6dc6/identity-grants/cfdee099-c321-455b-811e-910988167160' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJMLXVWZFNYVVlIMFNOVlB3d1RXb1hRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjhlZGY1N2Y5LTM2YTUtNDIwZi1iNTExLWIzZDBlY2I5YTg3MyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNDlkMzFkOTMtZTk1NC00ODNkLTg4YzUtZDRkMDJhZmQ0NTQ3XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfSx7XCJpZFwiOlwiYjk2YWUzZWYtMzkzOC00YmZmLWFmMTgtNjkzMmFkOTcxOWNjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.FYzQRIeLhuamUVH2hfFiB9u30u8o5cx8HkdfyVAYA6cgcstuczs6hTtohB-Xag6jfTXeb9ZDDhB46xQor5b3NnXreR-ujKHwde2WUFAxXAhCe9sPyKK-rZoIMOOAxZPQ0u_c-12b6Mz98Cjw4h-hwxPBdFOehKXiiDAuOdtSgZRhTejLGP1hiTca0fW8Oezoz9PVILpS7qPxfNYG0U8sc0s3503TPVKJXUeGW97lyeg6Z94bjaxos0wzidhp5GgCdTNqVZruHkvxzst7D5pvrypMN-dkvqmsFPoE2FgPTorx9vHrNDbQ-p9woQ05Dlv5NyWM3bP6gfUXLyi9yUpYTA'

Example response

HTTP/1.1 200 OK

Custom Role Actions

Find Custom Role Actions

GET /custom-role-actions

Returns a set of {@link CustomRoleAction}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the custom-role-action resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

customRoleId

Object

true

Filters results to those from one of the specified {@link CustomRole}s.

resourceActionId

Object

true

Filters results to those that grant one of the specified {@link ResourceAction}s.

path

Object

true

Filters results to those that target any resource along the specified path.
For example, if the path is to Network X which is under Network Group Y, this would restrict the results to {@link CustomRoleAction}s that grant an action on any resource under Network X, an action on Network X itself, or an action on Network Group Y. Combine this query parameter with resourceActionIds to limit the results to the types of actions along the path that are of interest.
The path value must start with a domain code followed by a colon. It may then have a comma delimited sequence of colon separated resource type code and resource id pairs. The path structure must match that of the server defined resource tree for the specified resources in the specified domain.

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].customRoleId

String

false

The {@link CustomRole} that this {@link CustomRoleAction} belongs to. This {@link CustomRoleAction} should be granted to any identity that is granted this linked {@link CustomRole}.

[].resourceActionId

String

false

The {@link ResourceAction} that this {@link CustomRoleAction} confers to the identities that hold the linked {@link CustomRole}.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link CustomRoleAction} was created.

[].updatedAt

String

false

The date-time at which this {@link CustomRoleAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link CustomRoleAction} was deleted. This will be null for an {@link CustomRoleAction} that has not been deleted. If this property is not null, then the {@link CustomRoleAction} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[].path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link CustomRoleAction} targets. For example, if this {@link CustomRoleAction} is "Update Widget Service" then this property defines the (id) path of/to the "Widget Service" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to the {@link ResourceAction#getResourceTypeId()}. Both must target the same {@link ResourceType}.

[].path[].resourceId

String

false

[].path[].resourceTypeId

String

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-actions' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI1ZkxwNTRqWVVXb09hWWRueG5ONmZBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjhhZjYyMTdlLTQxYzEtNDJlNC1hNDRkLWExZjJlZGM4MDk5YiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDgwNDkxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNmZlM2Y4ZTAtNGUyYi00MDY5LWEyMjItMzdlN2Q3NGU3NDk3XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.Qb7k4GCmjhvsUfHf6ACcSCGNNnkM0ivvnxWUOCZx5X67zAfXfP3GXvDW_G4jpjgi5KBkPBzcm-6l44tYbIrG_V7Zrf03YI_IXU-cc1sGr2_ZyMZIWe8Iueqf_Vt8kNpexJ_FbFSXK9Eq70FxPcBSFOmvuvHSPvrW6TL9fu70mWqfR5L0ICKjET_tNsiVY0WpQ-zfpOm8TO2Icry305XhlbagdD-4h7r1pIzfG8ujnEXC15Kh1_8-FIyrPB1kvxFUzqWp_H84ecvmEmUjOSlW5fqKGmDd_THYLzp-YMKE2Bn9c5p0OtMHqTBkkjnDpm25gI_Yq0-gcxHi7IPOAW1Qrw'

Example response

HTTP/1.1 200 OK
Content-Length: 1295
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "dffdc609-09cc-4dea-b0d8-0760f819884e",
  "customRoleId" : "74a9a6c3-106c-40bc-acab-780c837ad8d0",
  "resourceActionId" : "fb645842-f2ee-4361-bf33-2e8e38ece802",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.623052Z",
  "updatedAt" : "2021-01-19T17:21:22.623052Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "_title" : "Read Identity Resource Action, All"
}, {
  "id" : "5cc0f6f1-3978-4c17-94bb-30868bf237c2",
  "customRoleId" : "665bf926-a4de-4a65-a59e-1206e0ff6fcb",
  "resourceActionId" : "eddccb0b-c2da-48e6-8920-fdf64754b383",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.504404Z",
  "updatedAt" : "2021-01-19T17:21:22.504404Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "_title" : "Read Healing Alert, All"
}, {
  "id" : "61614fdc-c951-40f3-89cc-d5197ed40f9d",
  "customRoleId" : "74a9a6c3-106c-40bc-acab-780c837ad8d0",
  "resourceActionId" : "f17966ff-4060-44fc-a473-95f0cd568c0d",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.623052Z",
  "updatedAt" : "2021-01-19T17:21:22.623052Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ ],
  "_title" : "Read API Account Identity, All"
} ]

Get Custom Role Action

GET /custom-role-actions/{id}

Authorization

This endpoint requires read action on the custom-role-action resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

customRoleId

String

false

The {@link CustomRole} that this {@link CustomRoleAction} belongs to. This {@link CustomRoleAction} should be granted to any identity that is granted this linked {@link CustomRole}.

resourceActionId

String

false

The {@link ResourceAction} that this {@link CustomRoleAction} confers to the identities that hold the linked {@link CustomRole}.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link CustomRoleAction} was created.

updatedAt

String

false

The date-time at which this {@link CustomRoleAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link CustomRoleAction} was deleted. This will be null for an {@link CustomRoleAction} that has not been deleted. If this property is not null, then the {@link CustomRoleAction} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link CustomRoleAction} targets. For example, if this {@link CustomRoleAction} is "Update Widget Service" then this property defines the (id) path of/to the "Widget Service" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to the {@link ResourceAction#getResourceTypeId()}. Both must target the same {@link ResourceType}.

path[].resourceId

String

false

path[].resourceTypeId

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-actions/650b8825-cde1-4c1f-9674-9317f4a06397' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ6S2dlUE53ZTJrMDBEUzZ3SVl2NHdBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjNkOTRmNzQ0LWU1M2ItNDM5NS04MmZiLTZhZDRhYmExZDExNCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDgwNDkxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMDVjM2NhZTEtMjFkZC00YmZmLWIwMTAtYWQxNzQ5Y2E4OGFiXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.lkpAzPSNvADGgPuGI8NlpxPHYH49kDufYdWHGBEuBli00nfsB9TcFWsQu5fWkWpJCVfSAJImFgkc6MKryUJbVQo-0Ax9utlR6sNI5rwW5HXh13PxeGPEUKdp4x4LPhIgBjqfuRXDwGPT7xWWNH6101yKJ3W6519n0ZNncdW6jVdJPKthZ14GL60cQWIQmXJ59IwocMi17bS0JVkwJ8hjucjgIjlc4oyPVNdDp2Vqv_UE-aR1tU3Iqa4rNI1nlPo8Z2MlLO-S2ookKqkw-5LDEicL9vhrTByi-OsDkWQeFE4CHG0lUmIXFZ2eRKsUAE8p61N_dimee4YPKhcTrqdWmg'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 613

{
  "id" : "650b8825-cde1-4c1f-9674-9317f4a06397",
  "customRoleId" : "e7127acc-b39c-462c-adba-39f5233e9f8c",
  "resourceActionId" : "d19b9845-1c2a-4a27-8327-be4a8e40e178",
  "createdBy" : "71fb63b1-307f-4d0b-a00d-a6420345700c",
  "createdAt" : "2021-01-19T17:21:31.412395Z",
  "updatedAt" : "2021-01-19T17:21:31.412395Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "0cb8aae4-a6e6-4171-a96a-537b6654061d",
    "resourceTypeId" : "7c8a385d-88bc-417f-9966-0f3d6db06335"
  } ],
  "_title" : "Test Action 47 Test Type 46 on/under Test Type 46 0cb8aae4-a6e6-4171-a96a-537b6654061d"
}

Create Custom Role Action

POST /custom-role-actions

Authorization

This endpoint requires the following actions:

  • create action on the custom-role-action resource type

  • read action on the custom-role resource type

  • read action on the resource-action resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

customRoleId

String

false

Client must have create action under the annotated resource.
Client must have read action on the annotated resource.

resourceActionId

String

false

Client must have read action on the annotated resource.

path

Array[Object]

false

path[].resourceId

String

false

path[].resourceTypeId

String

true

Response fields

Path Type Optional Description

id

String

false

customRoleId

String

false

The {@link CustomRole} that this {@link CustomRoleAction} belongs to. This {@link CustomRoleAction} should be granted to any identity that is granted this linked {@link CustomRole}.

resourceActionId

String

false

The {@link ResourceAction} that this {@link CustomRoleAction} confers to the identities that hold the linked {@link CustomRole}.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link CustomRoleAction} was created.

updatedAt

String

false

The date-time at which this {@link CustomRoleAction} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link CustomRoleAction} was deleted. This will be null for an {@link CustomRoleAction} that has not been deleted. If this property is not null, then the {@link CustomRoleAction} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link CustomRoleAction} targets. For example, if this {@link CustomRoleAction} is "Update Widget Service" then this property defines the (id) path of/to the "Widget Service" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to the {@link ResourceAction#getResourceTypeId()}. Both must target the same {@link ResourceType}.

path[].resourceId

String

false

path[].resourceTypeId

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-actions' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJSZVhoYlRjNEl1cjBKNnpfQzB3WHJ3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjdiYTlkNDIwLTIzMzgtNDA3Yy1hZjUxLWY0OTBlMjU1M2U5OCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDgwNDkxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNmUyMGNjNmQtOGM0NC00Mjc2LWJhM2MtMmQzMjM3MzZlZmRlXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfSx7XCJpZFwiOlwiOThmOWQyMjItYjhiZi00NjBkLWJlMTItMWI1Mjk1NDI2ODdlXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfSx7XCJpZFwiOlwiZmU3MzdlZDQtNjJmNi00ZmM0LWFmNzItNGE0ZDkwMmQ0ZDAzXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.b0GlDvNkJNW5-vZSuney6DU3dGnNRlB1j3SA6MNEYHhde7eMxDKMxAjp8ExH1G8JuPVmjeluIbG9p70PNl5_TkPj8wCXaoogY5tH3Eb-A7UbBjrVRIDP_seKY0VSWQ6kuykYoJTJRLDKq3iOG5LLTa2cPWqcPMX7n5s3l60EwvTaTmOOZegoIckq8Xz8VpY_dSKBWmm7MfFf3VO17yX-rIKa9hjpVbn-JOkYsB-j1drChRimdMBSfRwnHwCWFII_ffyWmUACS0709D6upFHhTd0g2r1zAgHgyGwiMlJbRTAZAhxp7F5lRBEwyTYd0eoX0VgeJvO5AeMPthUKmk7h9Q' \
    -H 'Content-Type: application/json' \
    -d '{"customRoleId":"2c1758fa-4546-47b5-8128-c6a66b19ec2c","resourceActionId":"78b980a3-7c96-40c2-ba6e-d54a14b6d065","path":[{"resourceId":"88e9ef12-39f8-4ce3-a4ec-6773e0ab62a7","resourceTypeId":"b5e45843-2145-475b-8bd9-01a80c299b62"}]}'

Example response

HTTP/1.1 200 OK
Content-Length: 604
Content-Type: application/json;charset=UTF-8

{
  "id" : "b168caa3-b83e-44dd-9947-78b0a33f355c",
  "customRoleId" : "2c1758fa-4546-47b5-8128-c6a66b19ec2c",
  "resourceActionId" : "78b980a3-7c96-40c2-ba6e-d54a14b6d065",
  "createdBy" : "7ba9d420-2338-407c-af51-f490e2553e98",
  "createdAt" : "2021-01-19T17:21:31.316376Z",
  "updatedAt" : "2021-01-19T17:21:31.316376Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "88e9ef12-39f8-4ce3-a4ec-6773e0ab62a7",
    "resourceTypeId" : "b5e45843-2145-475b-8bd9-01a80c299b62"
  } ],
  "_title" : "Test Action Test Type on/under Test Type 88e9ef12-39f8-4ce3-a4ec-6773e0ab62a7"
}

Delete Custom Role Action

DELETE /custom-role-actions/{id}

Authorization

This endpoint requires delete action on the custom-role-action resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-actions/65aa0f64-8e92-4ab7-8661-a1696e163b6b' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJHRjNRQ2ZISHNQQ2dkYXFETHE4VDFBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImQxODQwMWYwLTc1ODgtNGM0Ni05OGIyLWM4MDBjZGJjODk4ZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MSwiZXhwIjoxNjExMDgwNDkxLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiM2E5MmM2YjEtZDU4ZS00YzBlLWE2ZTctMjcxYTM4ZmQzNDg3XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkxfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.VNfHLIqGvmzmwW7pbgE4g0xO8MWvvD6hCLViNwMs_9ZSqkApQOwSSABqXW2tB49OC-IcVNe1BLIOBhyeQUbNJvsFo2mR6qKk8eOsAx88qUutlO7Y7B6LDnxRwulsSp0bi8-bqwjE7Mxhg9-XWTHX8QU1nlpamPEBe-Z6rcDeHI-k_Mr0gXFYo495SWQMpZxUXeJ1TmQnHhug76hZO49Ri4WvMyqw4kBPBNpS-uqLzanddPz86GPsDpIFy0vW0Xz-PHfkR4dUYMPLv102ZVLg--x-Ns4tF4JH43p9st8BQ2kHg3g1aJtOM51AW8EnelKyryafuoiwJ99w1XEUA66TCw'

Example response

HTTP/1.1 200 OK

Custom Roles Grants

Find Custom Role Grants

GET /custom-role-grants

Returns a set of {@link CustomRoleGrant}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the custom-role-grant resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

customRoleId

Object

true

Filters results to grants to one of the specified {@link CustomRole}s.

customRoleIds

Object

true

Deprecated..

identityId

Object

true

Filters results to those granted to one of the specified identity ids.

identityIds

Object

true

Deprecated..

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].identityId

String

false

[].customRoleId

String

false

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link CustomRoleGrant} was created.

[].updatedAt

String

false

The date-time at which this {@link CustomRoleGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link CustomRoleGrant} was deleted. This will be null for an {@link CustomRoleGrant} that has not been deleted. If this property is not null, then the {@link CustomRoleGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-grants' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiItYWRXanh5MGpjNlBac2dNd0hQLTNRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6Ijk3MjRiNTQ1LWYxYWYtNDQwZi05ZjVmLTdmNjYxNWM4NTg0NCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMzhhNjVhOGYtODE2OS00NDQxLWE4ZmYtNjhhMGViNzhiMTQxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.HKLHm291Bjdy7o_AYIaU7C2AOJS60MhK80f1g_aKHylrvlstdCNLBNoVKL96qFgLumy7KFtxmCqweEJLaXyXVHyz1zC_mXG6y7fdhPDsfyt2c7KAsmSzpZjHZ7oqCOqL-071NB9RguKIWxWSJtg3SpVzJu6lIhTxXsPd5db7vIz3JmOVE7J0WEy1wyzPuGUzCnV7fiJWpVa26CUSe3RuyvMs6tuGZkPj4W9y4Xk1yM245yNL8NIpAh_-i6gGpwHOE1zF4YY8g1WIjuQSZBj867SPZCtoe_-ZfoiVaZb_sXD1VDTcPe_YdAFsWGlmhZeZtHve4ih7IJfSaTE_wXQFkA'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1415

[ {
  "id" : "7cf3cca7-4629-409e-bdbf-bf5d530b266b",
  "identityId" : "83d8cce9-1ad2-4ec1-ae23-9d1f3d28f2ba",
  "customRoleId" : "233ae92e-4b5d-4cab-9549-5d55fd1cbf6c",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.474718Z",
  "updatedAt" : "2021-01-19T17:21:22.474718Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Read-Only, ALL Auth Domain Resources to identity 83d8cce9-1ad2-4ec1-ae23-9d1f3d28f2ba"
}, {
  "id" : "3cb448a7-2b4b-4b24-960d-4de32cd2cf05",
  "identityId" : "bc186704-9a24-4c84-a5f5-a756a17a67e0",
  "customRoleId" : "233ae92e-4b5d-4cab-9549-5d55fd1cbf6c",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.395438Z",
  "updatedAt" : "2021-01-19T17:21:22.395438Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Read-Only, ALL Auth Domain Resources to identity bc186704-9a24-4c84-a5f5-a756a17a67e0"
}, {
  "id" : "a494f33f-c0a8-4585-8737-56ef47c3dbef",
  "identityId" : "373cef0b-d1d8-460a-9aaa-373a63556a5f",
  "customRoleId" : "233ae92e-4b5d-4cab-9549-5d55fd1cbf6c",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.960210Z",
  "updatedAt" : "2021-01-19T17:21:22.960210Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Read-Only, ALL Auth Domain Resources to identity 373cef0b-d1d8-460a-9aaa-373a63556a5f"
} ]

Get Custom Role Grant

GET /custom-role-grants/{id}

Authorization

This endpoint requires read action on the custom-role-grant resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

customRoleId

String

false

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link CustomRoleGrant} was created.

updatedAt

String

false

The date-time at which this {@link CustomRoleGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link CustomRoleGrant} was deleted. This will be null for an {@link CustomRoleGrant} that has not been deleted. If this property is not null, then the {@link CustomRoleGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-grants/200c8e63-fef7-4819-86dc-3dcd815f132e' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJTa3RVNWpaSXAxRUlqUWFRcjJCT2hRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImViZTRhNjQ0LWNhYTUtNGY5NS04MmZiLTI2ZjY1MmNlNWQ0YyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiODljMTU5ZmEtMjBlOS00MTY3LWI0YmItZDAwZThjNjM3ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.DXBFF8yXom1WQnMhmXVKf02FJA_9jlYRZ_7CJ8b8MX1VgG0u_QXa9TmFJVUbuMR6kkaalBeD5yEJ2wqbIL7BIw-SxN0FCBz3vh466bRFpbaRzNgjyVIchflwFs0v0xLGizRVH65TzTfGjcgoyr1WqOZGjdzA8fg50McjLT8OvCTxhyiJGS1aBmSzqsreJ9vKULWXJmCSK7MI2D4nijRot36bnTsqfY-FWwSxqvYM2qpXF4HJa9afnVe1tO8qu16-C4_KXqw6xjXzVaUaWfGKPAz92yS3wYqb4_3x2RGC6mU4HADIhKeYKs7iyzc6cPLsSv0BnK9kPyA6zJCcwblvVg'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 452

{
  "id" : "200c8e63-fef7-4819-86dc-3dcd815f132e",
  "identityId" : "903add79-7cec-4c8f-96c1-d2e1d5d7c733",
  "customRoleId" : "2057c7ae-87d8-4cb6-99ca-6c79a1cf5cd7",
  "createdBy" : "d122a391-bc5f-4a9b-9913-129612d67aff",
  "createdAt" : "2021-01-19T17:21:32.552103Z",
  "updatedAt" : "2021-01-19T17:21:32.552103Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Test Custom Role 56 to identity 903add79-7cec-4c8f-96c1-d2e1d5d7c733"
}

Create Custom Role Grant

POST /custom-role-grants

Authorization

This endpoint requires the following actions:

  • create action on the custom-role-grant resource type

  • read action on the custom-role resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

customRoleId

String

false

Client must have create action under the annotated resource.
Client must have read action on the annotated resource.

identityId

String

false

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

customRoleId

String

false

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link CustomRoleGrant} was created.

updatedAt

String

false

The date-time at which this {@link CustomRoleGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link CustomRoleGrant} was deleted. This will be null for an {@link CustomRoleGrant} that has not been deleted. If this property is not null, then the {@link CustomRoleGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-grants' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJSWGF5SnZxMER2S19QZHpESFR6Sm5BIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImZhODZjZjE0LTJiOTMtNGE1MC04ZDUyLWM4ZTdjYWMzODExZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYTIxZjNhNDQtZmY2YS00NDYwLWFlMGYtM2E4OTBkMDFlYzliXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfSx7XCJpZFwiOlwiM2NjNzhjZmYtOWYzNi00NzE1LWFkOWEtYzM4MDhlNTNkNjMxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.OmQKNnDteeaF61KQV_ZKDKhh-wzEIrj9BstjVBqa97usdUF5uS8l4LtzMagQmZU4_wV1GH9U71xeRkHTZ1oFc_Mxd95uGTxFhHR8JuA8TKgrBagOmUm4OyHyvIKV5vtHDh88ebNVTowcGr8Fkl4UTn0zqQJ8jvXY1PqF1c-RBhZDU8106j2JqQcjPG4_O2BeALXaG3FNmvfxkekCSth82CNkOxS7_Dc3VVX-k62WKr-Luj1-ERnQZLKhXiDLKkxcDvpTAOGPAPGIv1Y7I2rN73WmhKJIwTrJV57tuPQeZUqD7qJwpL_miT05NPWthD37Ld1REAXQ6zG3UcUBCmfWhg' \
    -H 'Content-Type: application/json' \
    -d '{"customRoleId":"77fbbca4-1189-4f24-81c4-b5c5983629a9","identityId":"1ed42bc8-4272-4ea4-a22e-31c39478df9d"}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 452

{
  "id" : "c20afd24-2e22-4238-b1b8-8c72a482c2b7",
  "identityId" : "1ed42bc8-4272-4ea4-a22e-31c39478df9d",
  "customRoleId" : "77fbbca4-1189-4f24-81c4-b5c5983629a9",
  "createdBy" : "fa86cf14-2b93-4a50-8d52-c8e7cac3811d",
  "createdAt" : "2021-01-19T17:21:32.711447Z",
  "updatedAt" : "2021-01-19T17:21:32.711447Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Test Custom Role 58 to identity 1ed42bc8-4272-4ea4-a22e-31c39478df9d"
}

Delete Custom Role Grant

DELETE /custom-role-grants/{id}

Authorization

This endpoint requires delete action on the custom-role-grant resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/custom-role-grants/e8eb3cda-597a-4d2e-931e-657e8aee16b7' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJYcGNXaE1rN2Nsc3c4YXFtOE9JVFpBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjNjMDBlOWZkLTJhZmMtNGIxYy1hNDAxLWE2YmM3MWRkZWYzNyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiY2RlMGEwNzktNjk1MC00NDY1LWIxMzMtZmYxMzJlMTQ0YzIxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.av3rv2wmHy7OxLHRrHDvZy1KKBWhreKfAV1gKAP8wrR3wMGE7kwlKKWbhyP8AK6MKRYO8Ke18Riq4bb5-EZGdq0jBp41QY1qb0vbBRCqmVdUK_J-s44tr78WdfnfmFZL4tQcW5U4xT9YrV_Gj9e503aMysPOgPLVfqBrAsbXixY2gEffg6G-rAgNmZdmYvE-GWUuwoI8HJitPTRPv-O9HvLf5qgfgroeCQHVJmczY909eal5vA3qruyzhNLq3z11K4jnfkKmiKvRAE9ugNrWEMuEgQ4DGNVDJVFqFK8CWdMYhcC0_yCfGeKayHYA8rexh_QbcLFOpHRsEiBjgcqMEg'

Example response

HTTP/1.1 200 OK

Standard Roles

Find Standard Roles

GET /standard-roles

Returns a set of {@link StandardRole}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the standard-role resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

standardRoleTypeId

Object

true

Filters results to those that are of one of the specified {@link StandardRoleType}s.

identityId

Object

true

Filters results to those which have been granted to one of the specified identities.

resourceId

Object

true

Filters results to those that specifically target one of the specified resources.
For example, if Network id X is passed, this would restrict the results to instances of a Network X Standard Role, such as Network Admin of Network X, Network Read-Only of Network X, etc. This would exclude Network Group Standard Roles, even if the Network Group contains Network X.

path

Object

true

Filters results to those that target any resource along the specified path.
For example, if the path is to Network X which is under Network Group Y, this would restrict the results to {@link CustomRoleAction}s that grant an action on any resource under Network X, an action on Network X itself, or an action on Network Group Y. Combine this query parameter with resourceActionIds to limit the results to the types of actions along the path that are of interest.
The path value must start with a domain code followed by a colon. It may then have a comma delimited sequence of colon separated resource type code and resource id pairs. The path structure must match that of the server defined resource tree for the specified resources in the specified domain.

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].standardRoleTypeId

String

false

The 'type' of this {@link StandardRole}.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link StandardRole} was created.

[].updatedAt

String

false

The date-time at which this {@link StandardRole} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link StandardRole} was deleted. This will be null for an {@link StandardRole} that has not been deleted. If this property is not null, then the {@link StandardRole} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[].path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link StandardRole} targets. For example, if this {@link StandardRole} is "ACME Corporation Account Manager" then this property defines the (id) path of/to the "ACME Corporation" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to this {@link StandardRole#standardRoleType}'s resource type. Both must target the same {@link ResourceType}.

[].path[].resourceId

String

false

[].path[].resourceTypeId

String

true

[].type

String

true

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-roles' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJpSF96dVlyTG9IVXlvcWMwN3hxTU1BIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImNjYzE4YzQ2LTA1ODItNDZlNC04YWEwLTZhMjI1MzEyZmRhZiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MCwiZXhwIjoxNjExMDgwNDkwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNWI3Y2VmNmEtZTk4ZC00ODc3LTg5NTAtNmQ4Y2M3YzRmYWI2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.b7jJTEvnBAV9QgTfO-NWmZ75i_IlKtMPYEdrYo54rT-MKRizTI6ayrQMTrUuIcFopV3eKn_VUP9xUbMYTIW0_UsP8bft1XTEOCyTDZYlOs3UW-Clu3DyGhtg8-hNFJO-69xibAiCqSjEKI_b2LRbZ1Z6eySJk1J7_8u0mC4rEiK8HXW2zN4ArqGwArekvEQ1QcHwDfTsVLJzJmTnPuDzu8vC5e_NpupxQkZ-KjEZMjo3sJnLu7mArVcYnw1WcZcPtfP_DS-yhJHJwvAbuErablr8a1uN5-xeUVJsilwmrZ_5tZf8GIKn0SKDGwAgK1LpE5BJTCWfR_2aMq1uEJoclg'

Example response

HTTP/1.1 200 OK
Content-Length: 1793
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "037982e4-fbd7-4fef-a31f-2343a8e611c7",
  "standardRoleTypeId" : "2958102b-cf0b-429e-90ce-3cdfbc68b93b",
  "createdBy" : "37917315-597a-43a0-a6c7-38a266e00878",
  "createdAt" : "2021-01-19T17:21:30.134929Z",
  "updatedAt" : "2021-01-19T17:21:30.134929Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "f04d3945-ed68-4203-9ff8-0d063347b38c",
    "resourceTypeId" : "46ef06ca-3e3e-45d4-965e-022cf00a2409"
  } ],
  "type" : "io.netfoundry.auth.domainv2.standardrole.StandardRole",
  "_title" : "Test Type 32 Admin - f04d3945-ed68-4203-9ff8-0d063347b38c"
}, {
  "id" : "35b6100b-8a5d-436e-bf55-2d96b6e4ff73",
  "standardRoleTypeId" : "b9b7c573-df9a-4aab-9132-cdd366fb196e",
  "createdBy" : "2c4b6822-faa2-4172-ba6b-49966643f62f",
  "createdAt" : "2021-01-19T17:21:30.065503Z",
  "updatedAt" : "2021-01-19T17:21:30.065503Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "ac73f186-f8bb-4024-bc7d-f2059c205bda",
    "resourceTypeId" : "c1411716-8a6d-4ced-8c07-45cd42894dcf"
  } ],
  "type" : "io.netfoundry.auth.domainv2.standardrole.StandardRole",
  "_title" : "Test Type 30 Admin - ac73f186-f8bb-4024-bc7d-f2059c205bda"
}, {
  "id" : "be25a868-ce65-4838-a2a4-c819b08c3fa5",
  "standardRoleTypeId" : "a6df5bf8-3351-4891-b161-fc79e625694c",
  "createdBy" : "09a73cfa-8554-4062-b206-7d989f84cf80",
  "createdAt" : "2021-01-19T17:21:30.228625Z",
  "updatedAt" : "2021-01-19T17:21:30.228625Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "1c2e44e5-dbe2-4e90-b045-8d19f4e4558f",
    "resourceTypeId" : "97ba9362-03ec-4f01-bf2d-365e3d0f71c3"
  } ],
  "type" : "io.netfoundry.auth.domainv2.standardrole.StandardRole",
  "_title" : "Test Type 34 Admin - 1c2e44e5-dbe2-4e90-b045-8d19f4e4558f"
} ]

Get Standard Role

GET /standard-roles/{id}

Authorization

This endpoint requires read action on the standard-role resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

standardRoleTypeId

String

false

The 'type' of this {@link StandardRole}.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link StandardRole} was created.

updatedAt

String

false

The date-time at which this {@link StandardRole} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link StandardRole} was deleted. This will be null for an {@link StandardRole} that has not been deleted. If this property is not null, then the {@link StandardRole} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link StandardRole} targets. For example, if this {@link StandardRole} is "ACME Corporation Account Manager" then this property defines the (id) path of/to the "ACME Corporation" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to this {@link StandardRole#standardRoleType}'s resource type. Both must target the same {@link ResourceType}.

path[].resourceId

String

false

path[].resourceTypeId

String

true

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-roles/037982e4-fbd7-4fef-a31f-2343a8e611c7' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJvSmpfd2xCLUZrbHI3Y2VnZHRndlRnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjVlYjY1YzllLTg1MmEtNDU1OC05NmJiLTM2NTZmZmVhYTcyMyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MCwiZXhwIjoxNjExMDgwNDkwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMjM1MmMyNzQtMjExNC00MDFjLTk2NDMtZjZjZDg2NDZjOGNiXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.T3RX1QH7gRSVxR80kzNddyhsQnmeofzLxdRK56wSGl1evTHNq_FH31kPvNLci23PVZlejm89-9vDH5Nn6GJQGXuGHMfpW-isrglNDwMTuCqCb91AwSmZ9gZCamaV8E9qu0RlVZea4gUeErVtB4loL-vKwa7Q0-Fml0WxJAPRIH2lcwUnb5tsoVbsJwL32rGm4oEN5aSYCzSxjoVZ6deLCempPh3MuZWenL94Qa_ZbogGqYi9p_sPN8UWyemVr7faORULyGQOYX1X2tn83AuZicQfhFeyWfZei9hCMT8Tc6XqBcZ3lxDEpOBpfgs3OQEWJHxPq193R0ZXckQRzQ_hyA'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 595

{
  "id" : "037982e4-fbd7-4fef-a31f-2343a8e611c7",
  "standardRoleTypeId" : "2958102b-cf0b-429e-90ce-3cdfbc68b93b",
  "createdBy" : "37917315-597a-43a0-a6c7-38a266e00878",
  "createdAt" : "2021-01-19T17:21:30.134929Z",
  "updatedAt" : "2021-01-19T17:21:30.134929Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "f04d3945-ed68-4203-9ff8-0d063347b38c",
    "resourceTypeId" : "46ef06ca-3e3e-45d4-965e-022cf00a2409"
  } ],
  "type" : "io.netfoundry.auth.domainv2.standardrole.StandardRole",
  "_title" : "Test Type 32 Admin - f04d3945-ed68-4203-9ff8-0d063347b38c"
}

Create Standard Role

POST /standard-roles

Authorization

This endpoint requires the following actions:

  • create action on the standard-role resource type

  • read action on the standard-role-type resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

standardRoleTypeId

String

false

Client must have create action under the annotated resource.
Client must have read action on the annotated resource.

path

Array[Object]

false

path[].resourceId

String

false

path[].resourceTypeId

String

true

Response fields

Path Type Optional Description

id

String

false

standardRoleTypeId

String

false

The 'type' of this {@link StandardRole}.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link StandardRole} was created.

updatedAt

String

false

The date-time at which this {@link StandardRole} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link StandardRole} was deleted. This will be null for an {@link StandardRole} that has not been deleted. If this property is not null, then the {@link StandardRole} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

path

Array[Object]

false

The path (ordered pairs of resource type and id) from resource tree root to the target resource that this {@link StandardRole} targets. For example, if this {@link StandardRole} is "ACME Corporation Account Manager" then this property defines the (id) path of/to the "ACME Corporation" resource. The path, specifically the ordered list of resource types that it contains, is co-variant to this {@link StandardRole#standardRoleType}'s resource type. Both must target the same {@link ResourceType}.

path[].resourceId

String

false

path[].resourceTypeId

String

true

type

String

true

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-roles' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJhSWJwT3ZsNG5fRXlldl9CMF85TEF3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjA5YTczY2ZhLTg1NTQtNDA2Mi1iMjA2LTdkOTg5Zjg0Y2Y4MCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MCwiZXhwIjoxNjExMDgwNDkwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYzU4YzE5MWEtN2E1OC00MmRhLWE2MTEtZTNkZDc2NGQyN2MwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfSx7XCJpZFwiOlwiYmZhMDUzYTQtNzIxNy00OTBhLTlmNTUtYjI3MGI0NTRmM2JlXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.N76OhwSOgA5kSoMeQvxsVQUz80BP01ByseBcP8srUrTg4zrNz3O_ubngNWFYa8Pm-LnF9FY0MUW6hubPKkpa-wTndpGLjCpl0xeocElpnBBEllelvz7g_m47yo9dRCf0nMQWTcf34P1IsJVLnhO6uGUL48u9NeKuNUu4gW8tQ9pzFid4eFKfkzv44ytCe3eHD8oV94tRu_bLQdQ2yBugNm7jU0dIK-SEc9C2O1L5FEE7CaGqjXM2g03_MIAWrgINNbVSUWToYotOJMGK4PRo_BOMIINAPyK4j-ikc5FHBHvgB7k9jnE6pRd66EdhI_IlBZulfW2LcXbY-XFwopVjvQ' \
    -d '{"standardRoleTypeId":"a6df5bf8-3351-4891-b161-fc79e625694c","path":[{"resourceId":"1c2e44e5-dbe2-4e90-b045-8d19f4e4558f","resourceTypeId":"97ba9362-03ec-4f01-bf2d-365e3d0f71c3"}]}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 595

{
  "id" : "be25a868-ce65-4838-a2a4-c819b08c3fa5",
  "standardRoleTypeId" : "a6df5bf8-3351-4891-b161-fc79e625694c",
  "createdBy" : "09a73cfa-8554-4062-b206-7d989f84cf80",
  "createdAt" : "2021-01-19T17:21:30.228625Z",
  "updatedAt" : "2021-01-19T17:21:30.228625Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "path" : [ {
    "resourceId" : "1c2e44e5-dbe2-4e90-b045-8d19f4e4558f",
    "resourceTypeId" : "97ba9362-03ec-4f01-bf2d-365e3d0f71c3"
  } ],
  "type" : "io.netfoundry.auth.domainv2.standardrole.StandardRole",
  "_title" : "Test Type 34 Admin - 1c2e44e5-dbe2-4e90-b045-8d19f4e4558f"
}

Delete Standard Role

DELETE /standard-roles/{id}

Authorization

This endpoint requires delete action on the standard-role resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-roles/6a59e666-dff7-4ae5-b9bb-2fb591911b29' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIwZnBpV1J4bmZvUFVvNGdQaG81dDhnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImExMTE4ZTE1LWYyZDEtNDU5ZS04MjcxLWEzNzFkNjllYTE5MyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MCwiZXhwIjoxNjExMDgwNDkwLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiY2VkYTVjOWMtNzliNy00NTMxLWFkNGQtODk4MjU5NWRlNTIwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkwfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.E-wAIws3byAHznA9ECghMaSMRB3MSjP6KEYbJQjTlrFV6Z09talIyqVYcCtSGL3yioW7HSDR1Vh8IfmcEGuTe3y9SAgny4mxyrZkPaZcIWL7p0b7l-AbOcOH3LCNKifDV6RqQ-8dx5rFNqKfhK1DgG74tMKC_Jj5lv8rhaTsPHc6FTfOmUUuzLgN6WZYUme4fpzq-cJ5S4hU02gcwb8_VcCbZSvf_nV-45TXjZZp1Ru4EhEE0kBLDqDV5fNM3KL-5G53MbLr3GoeLOqKsxucsVbSi0T7D1Ibgcw21Z8Sej4R9CuHd_o37cKVKEvSTYO0SXbp37fzkaXboxHZ3n2CAw'

Example response

HTTP/1.1 200 OK

Standard Roles Grants

Find Standard Role Grants

GET /standard-role-grants

Returns a set of {@link StandardRoleGrant}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the standard-role-grant resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

standardRoleId

Object

true

Filters results to grants to one of the specified {@link StandardRole}s.

standardRoleIds

Object

true

Deprecated..

identityId

Object

true

Filters results to those granted to one of the specified identity ids.

identityIds

Object

true

Deprecated..

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].identityId

String

false

[].standardRoleId

String

false

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link StandardRoleGrant} was created.

[].updatedAt

String

false

The date-time at which this {@link StandardRoleGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link StandardRoleGrant} was deleted. This will be null for an {@link StandardRoleGrant} that has not been deleted. If this property is not null, then the {@link StandardRoleGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-role-grants' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJBODRCQk9jZXBCNVV2anhVUmJ2Q29nIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImE4ZTA3YzRkLTg3YjgtNDU2MS05OTZmLWU5MzNiMDdmZGRmOSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNDIwYjdkYjItNzIxYS00ODQ5LThhOWQtOTgwY2Q5MGJjZjY2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.In2S-vMJ03mjlzNoZ3G2icHvdD-C8n7c4J-2wFnIBnyjOCMn_KWCz-cD6e9wFUpgNFzr02waFAiZ40aVAbhsDcIbSQ_F9CkKxgeXDaY8HUSw0vplMUZVVKvipkWc2A9q7CIylmFnQy6Ce9zoeGJh7dfSHoKb7F61ZzlNUahEj4vfLgAiVIPMqXHWGZyC4NEv8z3J67FEfQ1NRu2bDSA5FwSdHPhn0yF6T__2eFfE92zdfPMPtSP7KPwXNZQ_vVzH5vlaslUiD8zjfIfq57vD2YfZgfRSK-c0BK5o8tfndjLnqtsYE7zuIG3_kNK_icnJ4PUzOljf3T2f_kQmCBzTkw'

Example response

HTTP/1.1 200 OK
Content-Length: 1540
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "c69b3831-f675-41d4-ae7d-e94f4d326dca",
  "identityId" : "67aa893c-4d6a-488b-8066-f1fb701de66a",
  "standardRoleId" : "1884fb2a-9980-4a9c-8aa2-82a82a75b62b",
  "createdBy" : "00662301-0cbe-4862-833e-cfce96ac3afe",
  "createdAt" : "2021-01-19T17:21:33.725614Z",
  "updatedAt" : "2021-01-19T17:21:33.725614Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Test Type 68 Admin - 5f910ae5-342c-4e07-b549-4190282c130b to identity 67aa893c-4d6a-488b-8066-f1fb701de66a"
}, {
  "id" : "a8519b4c-d89c-49ea-b48c-3f753249bd8a",
  "identityId" : "83b334e9-67e2-4e57-a2cc-388244c81247",
  "standardRoleId" : "b285c351-929a-4391-beee-875a6294a939",
  "createdBy" : "5570693a-bf26-4d6d-851c-f9339d5a9367",
  "createdAt" : "2021-01-19T17:21:30.381282Z",
  "updatedAt" : "2021-01-19T17:21:30.397165Z",
  "deletedAt" : "2021-01-19T17:21:30.396Z",
  "deletedBy" : "25325c8c-5f40-4b2a-b663-ab322d2a15a6",
  "_title" : "Grant Test Type 38 Admin - d65500bf-5e04-4687-a287-ec5558f2c9c0 to identity 83b334e9-67e2-4e57-a2cc-388244c81247"
}, {
  "id" : "6ab245ef-693f-4908-9a62-af281d53e754",
  "identityId" : "0dde6763-1b73-45c8-92d7-74739f74c945",
  "standardRoleId" : "35b6100b-8a5d-436e-bf55-2d96b6e4ff73",
  "createdBy" : "98839836-7f26-4f07-8f61-ad8c29f4cdb6",
  "createdAt" : "2021-01-19T17:21:30.099680Z",
  "updatedAt" : "2021-01-19T17:21:30.099680Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Test Type 30 Admin - ac73f186-f8bb-4024-bc7d-f2059c205bda to identity 0dde6763-1b73-45c8-92d7-74739f74c945"
} ]

Get Standard Role Grant

GET /standard-role-grants/{id}

Authorization

This endpoint requires read action on the standard-role-grant resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

standardRoleId

String

false

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link StandardRoleGrant} was created.

updatedAt

String

false

The date-time at which this {@link StandardRoleGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link StandardRoleGrant} was deleted. This will be null for an {@link StandardRoleGrant} that has not been deleted. If this property is not null, then the {@link StandardRoleGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-role-grants/f612144b-9992-43ce-be81-d963174bd2de' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiItaEZrdzdDMFhUV1pfXzFOa0tMWjBBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjRjODcyNWI1LWE2YjctNDVhYy04MzY2LWI1YTU4YTc4ZThjMCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNjUxMjY5YTktMTEyNy00MDUzLWE2NWQtY2JjNDMyZTc4ZWM5XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.AJ8f30nymFms2RyFe8MHzddTMUo8nLXJqC63xcsZpPYI9GpgMq2nR7skdH0wJRzeQ-c7pqPtOsj5TEBc9GIoN0uwYDogCQ53pi6rQ5qyYhcECHLWMcYkelAzdJZyUHHjJ5MJImW-We2OQqrRo-CAMHGmgnkH5DN8Va4zA14y826MxuBPuJrkgMqypuOUsvDGyPlyatbdNW3owULf-9ANaucGxaPAT3bVPi9mxKifPSIfmEP3xWLrdroeoZzZU9MpB2oXk1qp4NCTJ-6uOggHpYFiXFwtMh43G4RH6vvQklORys-TYVkx1E506z1TcyS1v48c-KpBqMDJaREt1vLmzg'

Example response

HTTP/1.1 200 OK
Content-Length: 492
Content-Type: application/json;charset=UTF-8

{
  "id" : "f612144b-9992-43ce-be81-d963174bd2de",
  "identityId" : "b5152f4a-835c-4e22-9b93-fdd238160519",
  "standardRoleId" : "e5f1d2d6-b1ff-42cc-acd8-38e46d771b37",
  "createdBy" : "bdb4e322-5ae3-4ee3-9908-4feb30e5d2f9",
  "createdAt" : "2021-01-19T17:21:33.828440Z",
  "updatedAt" : "2021-01-19T17:21:33.828440Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Test Type 70 Admin - 2ff59adf-253c-4088-b0c7-1962ae12e64c to identity b5152f4a-835c-4e22-9b93-fdd238160519"
}

Create Standard Role Grant

POST /standard-role-grants

Authorization

This endpoint requires the following actions:

  • create action on the standard-role-grant resource type

  • read action on the standard-role resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

standardRoleId

String

false

Client must have create action under the annotated resource.
Client must have read action on the annotated resource.

identityId

String

false

Response fields

Path Type Optional Description

id

String

false

identityId

String

false

standardRoleId

String

false

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link StandardRoleGrant} was created.

updatedAt

String

false

The date-time at which this {@link StandardRoleGrant} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link StandardRoleGrant} was deleted. This will be null for an {@link StandardRoleGrant} that has not been deleted. If this property is not null, then the {@link StandardRoleGrant} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-role-grants' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI1Ui04b2oxT0hWSE44VG9seWE4eTFBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjAwNjYyMzAxLTBjYmUtNDg2Mi04MzNlLWNmY2U5NmFjM2FmZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYzBhOWViMWEtYmYyNy00Y2U1LTgxOTgtN2IxNjM4YTM5NjEwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiMzgxZmZlMmYtYzI1Zi00NjM4LTlmNjYtZjYxZDQ3YWVjNDE5XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.D_EGgyOb4HJphJFqHthIOXxcmt3vKcjpdUEbGvGa-B5WtWGU6ybEY0IV0URkpElApBFSAtX4D8a68WH2qQ7PbGwIJulEdfc_5Oe6GOARyxOUj0isaNJ2SF6AcGLzkoKnwb-vmCDejmD1ARVfkJZ8dxhXqctz3qP_U652kmPEo7Dhq-0-R6IXNLJn9mAxlhR0kgYUmIdUu_DL4OuK7N6FXt1BS5tUT7xaks5r-t8r_bG0Q7EKZxDJnhnbiPNlT283KsRtwEW_bCC5ykJLmjNmfu8OoMF7fi5v7n_DubH3aZVPR958o3AQM79U6OrgOfwjhZ7bHi14a_U6sAXDAd29yQ' \
    -H 'Content-Type: application/json' \
    -d '{"standardRoleId":"1884fb2a-9980-4a9c-8aa2-82a82a75b62b","identityId":"67aa893c-4d6a-488b-8066-f1fb701de66a"}'

Example response

HTTP/1.1 200 OK
Content-Length: 492
Content-Type: application/json;charset=UTF-8

{
  "id" : "c69b3831-f675-41d4-ae7d-e94f4d326dca",
  "identityId" : "67aa893c-4d6a-488b-8066-f1fb701de66a",
  "standardRoleId" : "1884fb2a-9980-4a9c-8aa2-82a82a75b62b",
  "createdBy" : "00662301-0cbe-4862-833e-cfce96ac3afe",
  "createdAt" : "2021-01-19T17:21:33.725614Z",
  "updatedAt" : "2021-01-19T17:21:33.725614Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Grant Test Type 68 Admin - 5f910ae5-342c-4e07-b549-4190282c130b to identity 67aa893c-4d6a-488b-8066-f1fb701de66a"
}

Delete Standard Role Grant

DELETE /standard-role-grants/{id}

Authorization

This endpoint requires delete action on the standard-role-grant resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-role-grants/e60c8093-c943-4abe-8275-38ea20535b42' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJOV2szblJxaFNwaXM4eFVXZ1cyenhRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjhjZmMwMjc5LTJiODktNDc0OS05MGM1LWI0NThjOTM1NjFmYiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcIjk3ZWQwZTIxLTA3ZTAtNGZkMC05ZWRkLWRmNDVjNjYzOTViMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjMyNDhiOThjLTM3MTAtNDBlMS05ZmFmLWY1YWNlNmZiODg0YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M30se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiMzNjYWI5ZTYtZWFhNC00NGU1LWI1NTYtYjExMmJlZTBiMmM1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.FJeEbf8RXhPzwQ5QV0OC8yBbMScMBD9zig63VuZ6dSYOGg2-Zpl6-Iymu0lU5mUv-GQdbsSQu1-oPdp6XAQJAl7MGbSTHb5Z149rExDc3nX-L2qvN0ktDIzZITjLQYeka3PSibUL3hNl0x239yR7PshULAEbjmUU3sPcJ8N-O1FB-p8Ij0oUuldjS7kmpEIf8dZNoYka-664ldU3ayONRXQytjEMoiloWTEDIOzuEf60ABaKyfJVvvP5PYKX4Ky53Sm8m9fWIlVKfM8LSt_hZyiNzh-JK5CwizK4-0ZJP5X9PCD1w1b_4kpeB6GGXdF3OWgD9cVMFYO1XxNKMQ9wtQ'

Example response

HTTP/1.1 200 OK

Standard Role Types

Find Standard Role Types

GET /standard-role-types

Returns a set of {@link StandardRoleType}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the standard-role-type resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

resourceTypeId

Object

true

Filters results to those that target one of the specified {@link ResourceType}s.

resourceTypeIds

Object

true

Deprecated..

authorizationStrategyName

Object

true

Filters results to those that are of one of the specified strategies.

authorizationStrategyNames

Object

true

Deprecated..

includedByStandardRoleTypeId

Object

true

Filters results to those whose actions are fully included by the specified {@link StandardRoleType}. In other words, all returned {@link StandardRoleType}s are logical sub-sets of the {@link StandardRoleType} specified by this query parameter.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].resourceTypeId

String

false

[].authorizationStrategyName

String

false

Size must be between 1 and 64 inclusive.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link StandardRoleType} was created.

[].updatedAt

String

false

The date-time at which this {@link StandardRoleType} was updated. The only supported 'update' on this bean is to mark it as deleted.

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-role-types' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ6M1VQZUI5TTBCQk9uS1pSTm80TGxRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImRjM2M1YzVmLTRlZGUtNDIwOC05ZDdiLTJmOTA3OTI5ZGRjMCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNGUzMTk0MjQtMzYwNi00MDk4LWEyN2ItZGNkODZkYjNjODQxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.n_KD7i7rinRk4RNAh1mBqaDkO_G7RruxFu-dR-AHxYQ0BqBzcy7CQvsTAl0QzOJ9EqhCmnmk6MUovFUKJwAzqUV3YTf82A8sT5UkvC8TrZz_BsdDBMMVCiWJYLjCnN3xfjTy37n2QOg7rEoK9qng-OQ1DAQh3wgyx0eC7C6SLnCSgT-Vaz-Pz6WWBuH6GE8X383d7E_XYINpbDIvjrESY-dsHt2GeDrmXrH9f6Lttx7yc5xAz4Apu9CQXJT7N6JLryiEx0wL0kc2hzBgPyiaBNt0AVsoH9tlTjo3KpEMdT48rI1xZQYIT1nhQ7sD_T_knQIdMfrnIw7Yr4esOBKIzA'

Example response

HTTP/1.1 200 OK
Content-Length: 1025
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "1142c437-539f-4422-860d-97923f5f0bdf",
  "resourceTypeId" : "444a0f36-9428-474d-b717-08b370cedf93",
  "authorizationStrategyName" : "Read-Only",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.345360Z",
  "updatedAt" : "2021-01-19T17:21:22.345360Z",
  "_title" : "Custom Role Read-Only"
}, {
  "id" : "65d17369-c7c9-47ea-91e1-9f02b9f7d358",
  "resourceTypeId" : "381e8822-0568-4068-b26f-39f27cd37a31",
  "authorizationStrategyName" : "Admin",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:21.996103Z",
  "updatedAt" : "2021-01-19T17:21:21.996103Z",
  "_title" : "Network Admin"
}, {
  "id" : "545318c2-fe30-4f5a-9e6e-1e2a8893a684",
  "resourceTypeId" : "e6292412-b6bc-4040-8e8e-c348e15d677a",
  "authorizationStrategyName" : "Admin",
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:21.996103Z",
  "updatedAt" : "2021-01-19T17:21:21.996103Z",
  "_title" : "Network Group Admin"
} ]

Get Standard Role Type

GET /standard-role-types/{id}

Authorization

This endpoint requires read action on the standard-role-type resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

resourceTypeId

String

false

authorizationStrategyName

String

false

Size must be between 1 and 64 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link StandardRoleType} was created.

updatedAt

String

false

The date-time at which this {@link StandardRoleType} was updated. The only supported 'update' on this bean is to mark it as deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-role-types/ec45b49d-a4db-446d-82f1-85a16d502c86' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2VUlpcEp0YU1RT29DRjRBa2FET0FnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjQ4YjEwODIwLTk4NmQtNGU3OS04YjA1LTJhMmRiMDFhZmYxMyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNjJkZGFjOWQtYWZmNS00OTM1LTk1NTQtNGY1MzVmZjAwOGQ3XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.ceZ1vZP-pDEep_NQZA9MXOI0kjsbWv4gc_Qal9C87L553veIounL3-QJYQpODfMUdq0DT0J0GdjNcZlPH7V4VKm2mQOLu65XtIGaY6bIxKeJAeTHqYlItVHjD6xq11SZWW6TeCXNiBrAWPJnNp3vXN5adKcoyFflwMmkiv9mPoZNvmJ5MFxAZe-kIxG5x7gKnBEhhLN2lwT9h17wcBPnNnFIHTTzakBf9KbcipjLx8kZiY-ZRhe9--4yWU4Fm8ZT4Ki22wU5H_1OtsOrwkrdure-rUXjElXrnxlZZw4Ks3uAZhx1R4VpwlrxUldaxGgcXEv0K1djo1K2QZhjjqq5fQ'

Example response

HTTP/1.1 200 OK
Content-Length: 338
Content-Type: application/json;charset=UTF-8

{
  "id" : "ec45b49d-a4db-446d-82f1-85a16d502c86",
  "resourceTypeId" : "9072ed4f-b0a6-493b-8f0d-36f145305f59",
  "authorizationStrategyName" : "Admin",
  "createdBy" : "25affbfa-e8db-43df-97db-58756ab053e4",
  "createdAt" : "2021-01-19T17:21:32.915137Z",
  "updatedAt" : "2021-01-19T17:21:32.915137Z",
  "_title" : "Test Type 60 Admin"
}

Create Standard Role Type

POST /standard-role-types

Authorization

This endpoint requires the following actions:

  • create action on the standard-role-type resource type

  • read action on the resource-type resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

resourceTypeId

String

false

Client must have read action on the annotated resource.

authorizationStrategy

String

false

Response fields

Path Type Optional Description

id

String

false

resourceTypeId

String

false

authorizationStrategyName

String

false

Size must be between 1 and 64 inclusive.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link StandardRoleType} was created.

updatedAt

String

false

The date-time at which this {@link StandardRoleType} was updated. The only supported 'update' on this bean is to mark it as deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/standard-role-types' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJhM3diZ1IzV0tqbHNvSnkyQXVhazd3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImIyYjI1ZTViLTdmNWUtNDQ4Yy1iMDFiLTRkZTNmMWVlYTVmYSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MiwiZXhwIjoxNjExMDgwNDkyLCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNWE0NGY2OGItZjM4NS00YmUwLTk3YmItZjU5MzdlZGE4M2EzXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfSx7XCJpZFwiOlwiZDE2MmFjZDctZGYzYS00YjVmLWI5MzUtYTRiZTk1ZGU3MTAzXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkyfV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.Qtde8te3SiBGSWdZfyNPU71WGlu1JcRfwcg1CJ5hf7QZq7biXG-dt0EQq93V1oCe-GZnqIExsHkRe7AtdX61mVIf8pYrxOC5f0HK-wq12-UW6VeJmLA_5xu-aU3yL6MV0ZDbOPnwebyhtbI8iG11_P6oQjSSXymnKNCifdew37-MAcBwhxK7u01040xsx89bulFuuRDVVaDjxcNv5awUc6osnG2-7_wy4GhLDPo_k8VyFMwE1bk00p8oa8f3_hCHBSleVSzBOn3gcEQtZrK6_OQj6x3PbkDnhC8N5_2yBkPen0DDJy9uPjjSfSdt920JgSWy-HSDo5iHKRxhlYfvQA' \
    -H 'Content-Type: application/json' \
    -d '{"resourceTypeId":"b5e45843-2145-475b-8bd9-01a80c299b62","authorizationStrategy":"Admin"}'

Example response

HTTP/1.1 200 OK
Content-Length: 335
Content-Type: application/json;charset=UTF-8

{
  "id" : "d1709bd0-ff71-40a0-a578-1194c32a5331",
  "resourceTypeId" : "b5e45843-2145-475b-8bd9-01a80c299b62",
  "authorizationStrategyName" : "Admin",
  "createdBy" : "b2b25e5b-7f5e-448c-b01b-4de3f1eea5fa",
  "createdAt" : "2021-01-19T17:21:32.851884Z",
  "updatedAt" : "2021-01-19T17:21:32.851884Z",
  "_title" : "Test Type Admin"
}

Resource Action Inclusions in Standard Roles

Find Action Inclusions

GET /action-inclusions

Returns a set of {@link ActionInclusion}s that the client is authorized to read and which match the specified (optional) query parameters.

If multiple query parameters are specified, then results must match each query parameter that is set. If a query parameter supports multiple values, then a result must match at least one of the values. In other words, distinct query parameters are AND’d while value matching within a single query parameter act as an OR condition. For example a query parameter "?x=1,2&y=3" becomes (X == 1 OR X == 2) AND (Y == 3).

Authorization

This endpoint requires read action on the action-inclusion resource type.

Path parameters

No parameters.

Query parameters

Parameter Type Optional Description

resourceActionId

Object

true

Filters results to those that apply to one of the specified {@link ResourceAction}s.

authorizationStrategyName

Object

true

Filters results to those that apply to one of the specified strategies.

isDeleted

Boolean

true

When true, returns only those that are marked as deleted. When false, returns only those that are not marked deleted. When not set, returns all those that are otherwise matching, whether they are marked deleted or not.

Request fields

No request body.

Response fields

Path Type Optional Description

[].id

String

false

[].resourceActionId

String

false

[].authorizationStrategyName

String

false

Size must be between 1 and 64 inclusive.

[].includeWhenAbove

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is above the {@link StandardRoleType}'s {@link ResourceType}.

[].includeWhenAt

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is the same as the {@link StandardRoleType}'s {@link ResourceType}.

[].includeWhenBelow

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is below the {@link StandardRoleType}'s {@link ResourceType}.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link ActionInclusion} was created.

[].updatedAt

String

false

The date-time at which this {@link ActionInclusion} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link ActionInclusion} was deleted. This will be null for an {@link ActionInclusion} that has not been deleted. If this property is not null, then the {@link ActionInclusion} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/action-inclusions' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJwTmtvNS1OWmhwdUU2cGI0VVg1clZBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6Ijk0YzliMDYxLTI3NWQtNDY5ZS1iZjA5LWQwZDZlMzZiN2JhNSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OCwiZXhwIjoxNjExMDgwNDg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNzY1NWVmMDctNTZmMi00YWRlLTllOGUtOGJmYzFhMDllZTg0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.GFdh3f0eUm_Y6e-1MWcEjcfYG5HF-R_svryyKXH_VmXGD2HTUixSWPh82DMdaoHUQ7QT1HAaJL4Hq_J6Aj5QBlq-09zIiOt06f9i0HAtIqqCtnMdWOf_zGoEt_AguAYzuC5eEdS7MH9MYeJslKBR3Ctb9R_483hUTX3uyoMdpxYx_Szpb2FHndzZt8_Safg1v76dSNDaqk3OHCSlBK8M4K618wLfLe6GO99uoyaouU74kDd9rHqYugEU2W2CWbi6q4GfQruEYLs_1bPv__2MYuo3O9rxbRslJn1QCTdj2zBs2ah1wP2ygNDJpjd9JR9oB1Pnyt9rkBShqgB4tBCh6g'

Example response

HTTP/1.1 200 OK
Content-Length: 1575
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "96db75f5-094d-44a8-ac3d-1291ee31d0e1",
  "resourceActionId" : "274b14ac-0621-4007-8ceb-7e7b53988937",
  "authorizationStrategyName" : "Contributor",
  "includeWhenAbove" : false,
  "includeWhenAt" : false,
  "includeWhenBelow" : true,
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.554769Z",
  "updatedAt" : "2021-01-19T17:21:22.554769Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Inclusion Rules for Update Service Group in Contributor Standard Roles"
}, {
  "id" : "7d158769-aeac-45c4-8550-f4534d6d7d11",
  "resourceActionId" : "45a01609-0819-4b03-8bad-df8a02091c9e",
  "authorizationStrategyName" : "Admin",
  "includeWhenAbove" : false,
  "includeWhenAt" : false,
  "includeWhenBelow" : true,
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.282778Z",
  "updatedAt" : "2021-01-19T17:21:22.282778Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Inclusion Rules for Create Action Inclusion in Admin Standard Roles"
}, {
  "id" : "14ac0ba1-4715-4666-8869-30d2905ed5f3",
  "resourceActionId" : "a3021047-4b9b-46be-ab68-b452d5b65d2a",
  "authorizationStrategyName" : "Admin",
  "includeWhenAbove" : false,
  "includeWhenAt" : false,
  "includeWhenBelow" : true,
  "createdBy" : "0ab1b47d-a5de-4f39-a3bd-7b130cacf401",
  "createdAt" : "2021-01-19T17:21:22.282778Z",
  "updatedAt" : "2021-01-19T17:21:22.282778Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Inclusion Rules for Create Custom Role Grant in Admin Standard Roles"
} ]

Get Action Inclusion

GET /action-inclusions/{id}

Authorization

This endpoint requires read action on the action-inclusion resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have read action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

resourceActionId

String

false

authorizationStrategyName

String

false

Size must be between 1 and 64 inclusive.

includeWhenAbove

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is above the {@link StandardRoleType}'s {@link ResourceType}.

includeWhenAt

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is the same as the {@link StandardRoleType}'s {@link ResourceType}.

includeWhenBelow

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is below the {@link StandardRoleType}'s {@link ResourceType}.

createdBy

String

false

The identity id that created this resource.

createdAt

String

false

The date-time at which this {@link ActionInclusion} was created.

updatedAt

String

false

The date-time at which this {@link ActionInclusion} was updated. The only supported 'update' on this bean is to mark it as deleted.

deletedAt

String

true

The date-time at which this {@link ActionInclusion} was deleted. This will be null for an {@link ActionInclusion} that has not been deleted. If this property is not null, then the {@link ActionInclusion} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

_title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/action-inclusions/0a21b671-b0bf-43d1-9e99-6c18c98f9e85' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJvU0ZVUjZSRDhpWVNsMlp4eFVpOXFBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjhlYjczMDViLWRmN2UtNGM0Zi04YTRmLTNmMDNhMGU2MjE4OCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OCwiZXhwIjoxNjExMDgwNDg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiZDA1MDZiYjEtMmM1ZS00YWU5LWE5NWQtZTBhYjliMTQzMDcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.UKabT5NICIi57C064_YkrmJBoe57R8rC0hb4FBR3W_9TxoTpzmnAMlh_XCFLnoKh-vadfZByRy3g5JK6LgUJrfehggaOEYZhgI0DRf3Od0Sn8SybwNIZe9ad78LnUURTIBD2JKAOpju8urOnWf5pla_2K1WFsQsbWwkOMTTtj0s7tk0a8RQXdCv-pCAjLh70Adc9yVX4zuBTVPrx-b0Fh07ooNY6O9P_iet4zRrk2DDIc2nsSfYCzOkzdPyLyZIplT35mDpSqAJoIvjtX5gRoNmDRqmI4Y_b9oBiQhM-msuzoeryERVRvIdUUkyM3uaOxKKoeYOF7dCwiVNlMh9z0A'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 520

{
  "id" : "0a21b671-b0bf-43d1-9e99-6c18c98f9e85",
  "resourceActionId" : "42d93545-3666-4b77-8b30-8b07a05c6026",
  "authorizationStrategyName" : "Admin",
  "includeWhenAbove" : false,
  "includeWhenAt" : true,
  "includeWhenBelow" : true,
  "createdBy" : "ac9c493e-5cb2-498f-83ca-0b7123e3081b",
  "createdAt" : "2021-01-19T17:21:28.660176Z",
  "updatedAt" : "2021-01-19T17:21:28.660176Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Inclusion Rules for Test Action 2 Test Type 1 in Admin Standard Roles"
}

Create Action Inclusion

POST /action-inclusions

Authorization

This endpoint requires the following actions:

  • create action on the action-inclusion resource type

  • read action on the resource-action resource type

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

resourceActionId

String

false

Client must have read action on the annotated resource.

includeWhen

Map

false

Response fields

Path Type Optional Description

[].id

String

false

[].resourceActionId

String

false

[].authorizationStrategyName

String

false

Size must be between 1 and 64 inclusive.

[].includeWhenAbove

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is above the {@link StandardRoleType}'s {@link ResourceType}.

[].includeWhenAt

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is the same as the {@link StandardRoleType}'s {@link ResourceType}.

[].includeWhenBelow

Boolean

true

True if the linked {@link ResourceAction} should be included in {@link StandardRole}s where this {@link ResourceAction}'s {@link ResourceType} is below the {@link StandardRoleType}'s {@link ResourceType}.

[].createdBy

String

false

The identity id that created this resource.

[].createdAt

String

false

The date-time at which this {@link ActionInclusion} was created.

[].updatedAt

String

false

The date-time at which this {@link ActionInclusion} was updated. The only supported 'update' on this bean is to mark it as deleted.

[].deletedAt

String

true

The date-time at which this {@link ActionInclusion} was deleted. This will be null for an {@link ActionInclusion} that has not been deleted. If this property is not null, then the {@link ActionInclusion} is 'marked' as being deleted. For data retention reasons, we never actually delete a resource.

[].deletedBy

String

true

The identity id that deleted this resource. This will be null until the resource is marked deleted.

[]._title

String

true

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/action-inclusions' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJKa05jVS1wZzdwcUZ6Zmo0b29VY2VRIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImViYzE0Mjg0LTk0NzEtNDdhOS05MTI3LWNjMGIzNmYyMjZlMyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OCwiZXhwIjoxNjExMDgwNDg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiYjJlZWI5OGQtZWQ0YS00MDZhLTgxNTgtZWU0NWRmZjM4MzY4XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fSx7XCJpZFwiOlwiMDZiZTdhY2ItYjhhMS00ZDAyLWE4YjctNjQ4ODczMjBhNWJmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.AFvycDXBl8Tto7heNlANZ6IKF5kfCDJDGeijVh6kcY2eQoeardzVTzwz-FahJzglaVQ0j9oUJKeLKcCLAhBaPdxeHnczVo0xcXgoOxGevLA9LFyQ-sa-HCYBl0nq73ZTaF_XbOJdIFDDl1NBPfR0RzA1MWb6lAOWs0bHtIpSO8Bf9Lw7ZcXSdozKlVV6yRJBdLqGprxTheGKsFzmgwBYdqW2YNfy52dJViB_Emn5996N6yxEPjQoFJGcD6bjvwmacP-ngfPXKwZ7gbGdoS3kUGbTd7WXGDOobMICIisF21--ki4GDo6Nu_JGi0NSzZyPVKiEt0VJE8iu_wxKKAyhOg' \
    -d '{"resourceActionId":"cbd78298-5534-4105-9aa7-ee165b5ccee3","includeWhen":{"Admin":{"above":false,"at":true,"below":true}}}'

Example response

HTTP/1.1 200 OK
Content-Length: 524
Content-Type: application/json;charset=UTF-8

[ {
  "id" : "b42a7631-5a10-4fd1-8227-2b4de898c0e2",
  "resourceActionId" : "cbd78298-5534-4105-9aa7-ee165b5ccee3",
  "authorizationStrategyName" : "Admin",
  "includeWhenAbove" : false,
  "includeWhenAt" : true,
  "includeWhenBelow" : true,
  "createdBy" : "ebc14284-9471-47a9-9127-cc0b36f226e3",
  "createdAt" : "2021-01-19T17:21:28.937379Z",
  "updatedAt" : "2021-01-19T17:21:28.937379Z",
  "deletedAt" : null,
  "deletedBy" : null,
  "_title" : "Inclusion Rules for Test Action 8 Test Type 7 in Admin Standard Roles"
} ]

Delete Action Inclusion

DELETE /action-inclusions/{id}

Authorization

This endpoint requires delete action on the action-inclusion resource type.

Path parameters

Parameter Type Optional Description

id

Object

false

Client must have delete action on the annotated resource.

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/action-inclusions/8a498cb6-0981-43bb-b199-5d508722a9fe' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJQbDJFbVJnYzA2QW5oWDRTRmNOQjBnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImRlMjc5MTBjLThkNzAtNDQzMi04MjkzLTY3OWVhOWZhOWY4NiIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OCwiZXhwIjoxNjExMDgwNDg4LCJncmFudHMtc3VwZXIiOiJbXSIsImdyYW50cy1jdXN0b20iOiJbXSIsImdyYW50cy1wdWJsaWMiOiJbe1wiaWRcIjpcImNiYTA3NjhkLWNmMTYtNDhkOC04MDhlLTU3YjA5ODI0NGZmYVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjczYWYwOTYwLTcyZjUtNDRhNS1iODRkLTgzNmJmZGUzYzZmZlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImQ0NmVlNGY3LTI4MWEtNDNhNi1hZGRmLTNhODI0YmM2YzI2NFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjliODY2MDU2LTFhNmItNDlkNS1hNDk3LWNlZGU1MjQ5MTE3Y1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcImFmOGUyMjgyLTFkYzItNDY3Zi1hNzdjLWIwMWI3MWIyZTE3MFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4NX0se1wiaWRcIjpcIjIxOTBkMGNhLTJjYzktNDJlOS1iMmY0LWY3YjRiOTgzNjg1MVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjZmMzg1NmI1LTA0MDAtNDRjZC05N2I3LWY1NjUwYjVmZTI3NVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn0se1wiaWRcIjpcIjFjMjhlYTQyLWYyN2EtNDA5Mi04Y2M2LTQzMDk0ZTAwOTJkNlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4Mn1dIiwiZ3JhbnRzLWFjdGlvbiI6Ilt7XCJpZFwiOlwiNmY1ZDM1MWEtZDQ3My00YWQyLTgyMzMtY2I1M2I4ZWE5YzVhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg4fV0iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.E3a8BKqCiearOtGw-5vpsxYTGKhBd8RCWQ36YPqVrBamG8wmF2X7c8Gz4ddKKNQvVHSBBb2cYFuy9mj703I_dMAZ61euLvn80XcHRgxIXiq0sjZSl54f_BFwtr5Ko9cHxzkJepFE-mY0bCcMBF-a2MIUVbnJPyA2Erev96LUEZdrOA_vm3_Ok_H0sITExlny_JKqqW_GUR-uhqXvQF5VDOlXDVQXiVtLid2zBgoJYUXK65AwVIAyFoPU5jRBSYUV54mACFACw-0VRLtvK69VsF-VA19-TVNdbMb3baxkv_JvmStJiO0r1ojiAUkO5cU7-88o7pVgULf6j1S5-kj4EQ'

Example response

HTTP/1.1 200 OK

Deprecated Resources

Resources

Find Resources

GET /resources

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

nameLike

String

true

descriptionLike

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

name

String

false

description

String

false

resourceTemplateId

String

true

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resources' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Length: 1152
Content-Type: application/json;charset=UTF-8

{
  "content" : [ {
    "id" : "2b374a00-bf8d-4874-8cb5-5ce67adff0e0",
    "name" : "nfrn:orgs:*:nets:*:gateway-clusters:*:endpoints:*",
    "description" : "All Gateway Cluster Endpoints",
    "resourceTemplateId" : null,
    "createdAt" : "2021-01-19T17:21:20.392671Z"
  }, {
    "id" : "cdace3ea-d75b-11e9-b01a-d05099466715",
    "name" : "nfrn:*",
    "description" : "All NetFoundry Resources",
    "resourceTemplateId" : null,
    "createdAt" : "2021-01-19T17:21:20.392671Z"
  }, {
    "id" : "cdace5d7-d75b-11e9-b01a-d05099466715",
    "name" : "nfrn:orgs:*",
    "description" : "All Organizations",
    "resourceTemplateId" : null,
    "createdAt" : "2021-01-19T17:21:20.392671Z"
  } ],
  "pageable" : {
    "sort" : {
      "sorted" : false,
      "unsorted" : true,
      "empty" : true
    },
    "pageSize" : 20,
    "pageNumber" : 0,
    "offset" : 0,
    "unpaged" : false,
    "paged" : true
  },
  "totalElements" : 50,
  "totalPages" : 3,
  "last" : false,
  "numberOfElements" : 20,
  "first" : true,
  "sort" : {
    "sorted" : false,
    "unsorted" : true,
    "empty" : true
  },
  "number" : 0,
  "size" : 20,
  "empty" : false
}

Get Resource

GET /resources/{idOrName}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

idOrName

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

false

description

String

false

resourceTemplateId

String

true

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resources/1891414f-7b86-4015-94e7-20097976e48b' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Length: 193
Content-Type: application/json;charset=UTF-8

{
  "id" : "1891414f-7b86-4015-94e7-20097976e48b",
  "name" : "nfrn:tests:*:foos:*",
  "description" : "All Foos",
  "resourceTemplateId" : null,
  "createdAt" : "2021-01-19T17:21:25.672736Z"
}

Create Resource

POST /resources

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

false

description

String

false

audience

String

true

Response fields

Path Type Optional Description

id

String

false

name

String

false

description

String

false

resourceTemplateId

String

true

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resources' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"name":"nfrn:tests:*:random:*","description":"random test resource","audience":"io.netfoundry.tests"}'

Example response

HTTP/1.1 200 OK
Content-Length: 207
Content-Type: application/json;charset=UTF-8

{
  "id" : "0f55f97d-12a3-4c07-a7bf-76ad1a22b6be",
  "name" : "nfrn:tests:*:random:*",
  "description" : "random test resource",
  "resourceTemplateId" : null,
  "createdAt" : "2021-01-19T17:21:31.122279Z"
}

Delete Resource

DELETE /resources/{id}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/resources/89faa6c0-fd87-48dd-834c-e09441ca6f24' -i -X DELETE

Example response

HTTP/1.1 200 OK

Actions

Find Actions

GET /actions

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

nameLike

String

true

descriptionLike

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

name

String

false

Must match the regular expression :[a-zA-Z0-9-].

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/actions' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJHUkVyNUNPakFreHg1TmdPQlZvSm5nIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6Ijk4ZGE4NjQ2LTI4OWMtNGI3Ni1hOGI1LTg0ZWU4NmYxOGMyZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjE1ZmFhN2M0LWUzNTktNDRjYy1hNDRhLTNjZGM0ZjJhOTc4ZFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M31dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiOTdlZDBlMjEtMDdlMC00ZmQwLTllZGQtZGY0NWM2NjM5NWIyXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMzI0OGI5OGMtMzcxMC00MGUxLTlmYWYtZjVhY2U2ZmI4ODRiXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.XYD7OE0XqIYx0N00HHtWcGdUabj9kQO-DDlxmoucSqFJ5saklKpf2zJBQ6vPXjMoLVjGu1XAnMRkcxydcHuaFwIKAorxG7VlCf2yK49iJU-LDRhQKmF3XSqhS3wB5B_H2jhuvc_j0afyjyWrRCcb3MflxdGj8LXIzxFqgjHk6w7RB24XIpCssFMdrzhel_QzEjAWfpbbGEfc9_KfIm8RElxFizsJiRnysndSm2DhCYmXIbv9ib9umJ4Agn0GXlrJwAF_RpwcW6eEmNW-Acec_nbw1kh6FIct6KbiMxXr5xwJUPEiRVxZYqCrhTGJ5asK3vg1KFNHyeat1ZigNphiyg'

Example response

HTTP/1.1 200 OK
Content-Length: 1052
Content-Type: application/json;charset=UTF-8

{
  "content" : [ {
    "id" : "a68353ea-b58d-441e-8714-b5ed62c75f22",
    "name" : "networks:create-aws-autoscale-endpoint",
    "description" : "Create AWS Auto-Scale Endpoints",
    "createdAt" : "2021-01-19T17:21:20.343961Z"
  }, {
    "id" : "ce0b865f-d75b-11e9-b01a-d05099466715",
    "name" : "*:*",
    "description" : "All Actions",
    "createdAt" : "2021-01-19T17:21:20.343961Z"
  }, {
    "id" : "ce0b8832-d75b-11e9-b01a-d05099466715",
    "name" : "azure-subscriptions:*",
    "description" : "All Azure Subscription Actions",
    "createdAt" : "2021-01-19T17:21:20.343961Z"
  } ],
  "pageable" : {
    "sort" : {
      "sorted" : false,
      "unsorted" : true,
      "empty" : true
    },
    "pageSize" : 20,
    "pageNumber" : 0,
    "offset" : 0,
    "unpaged" : false,
    "paged" : true
  },
  "totalElements" : 173,
  "totalPages" : 9,
  "last" : false,
  "numberOfElements" : 20,
  "first" : true,
  "sort" : {
    "sorted" : false,
    "unsorted" : true,
    "empty" : true
  },
  "number" : 0,
  "size" : 20,
  "empty" : false
}

Get Action

GET /actions/{idOrName}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

idOrName

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

false

Must match the regular expression :[a-zA-Z0-9-].

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/actions/b36318dd-4b41-44ef-9871-7fc504c32b12' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ2UEttS1g4TGZnRFRUVlJNRUxmY1VnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImU0ODg1NTk5LWIzYWUtNGJmMi1hMzgxLWNiYTBjYTk2MTRjZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5MywiZXhwIjoxNjExMDgwNDkzLCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjc1MzI5MzY1LTEyYWEtNGQ2Zi1iODhhLThhYmFkZDUwMWRjOVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5M31dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiOTdlZDBlMjEtMDdlMC00ZmQwLTllZGQtZGY0NWM2NjM5NWIyXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMzI0OGI5OGMtMzcxMC00MGUxLTlmYWYtZjVhY2U2ZmI4ODRiXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.D6mVhBt1i9A3fn4xrrrGtjZrybgFBO-A2oN_0sy_Ov4Obp367HZFTnensLkqQwSAL8X2G53E7jXQf2_KzDy5cuqicZFYu-SqHutCc7GDvxw8tISIlD5chLl8bSmQZL88_zLskBPncxtQSz_GDg4pDM3EE8-WUkD2ySWbgn2dN1Sgtn7AGfTGfi3tFUdfFXRFu5Dm2FY0vAO3rzTcmxWN38HWVK5Oy8_TLWZ6TerQgYMlShI5V8q3GKfagSvDs4jAMHYLT8XHy0F-0C719H_REfILJO1EKlSginhME2BLITpVHD1ITpR0q4SbfTjLL8RPqfYbuYX-dswznON4WrT85Q'

Example response

HTTP/1.1 200 OK
Content-Length: 161
Content-Type: application/json;charset=UTF-8

{
  "id" : "b36318dd-4b41-44ef-9871-7fc504c32b12",
  "name" : "tests:create-foo",
  "description" : "Create Foo",
  "createdAt" : "2021-01-19T17:21:25.661173Z"
}

Create Action

POST /actions

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

false

Must match the regular expression :[a-zA-Z0-9-].

description

String

false

Response fields

Path Type Optional Description

id

String

false

name

String

false

Must match the regular expression :[a-zA-Z0-9-].

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/actions' -i -X POST \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJvNGlkcF93c1QtYWtyMkRCV0VsXzRBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImM0NTgyYWFlLWFlY2UtNDk0NS1iYjEwLTc3ODQ0MGYwNWI3MyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5NCwiZXhwIjoxNjExMDgwNDk0LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjVjZTlmMTMyLTlkYmQtNGRiNC1hMDg4LWYzMzcyMTI2ODFjNFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5NH1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiOTdlZDBlMjEtMDdlMC00ZmQwLTllZGQtZGY0NWM2NjM5NWIyXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMzI0OGI5OGMtMzcxMC00MGUxLTlmYWYtZjVhY2U2ZmI4ODRiXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.N-R2Grr1CYqpbc4Ls6JjVluHf-lHRDwxmjhUA4AkRtBBN2Yv8hRk0q1E4tyCZQR0ZNH1LMI5I5mWh8-NZqngmiaCzau234C4EWD9A8I-Pfa2o5T6PBtAh1OGQ112cXPYTflY8se14kuK2X-rfja5RemFAfSMI7PhakAy6_lUqMLC-tqOYiTm2yQzCbkiWFLXOVasBw2dqEbetTEp-MS_V_y9bB3J45GuqKPH1E_r1FcypF36-2IgZtRHTKVEfDNL38viB79YOed2rgxDnR_V_bvPALTe8uUkeW8f_7W65mhZxcffP-Evdh5yQ7ry-8tDkEgRdaBDYcD9e96ewKCmqg' \
    -H 'Content-Type: application/json' \
    -d '{"name":"nfrn:get-widget","description":"Getting a widget"}'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 166

{
  "id" : "9c0f208e-372c-4088-af9d-5b2f55ee5867",
  "name" : "nfrn:get-widget",
  "description" : "Getting a widget",
  "createdAt" : "2021-01-19T17:21:34.042240Z"
}

Policies

Find Policies

GET /policies

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

resourceIdIn

Object

true

actionIdIn

Object

true

descriptionLike

String

true

roleId

Object

true

identityId

Object

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

resourceId

String

false

actionId

String

false

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiItdUktOUlHTEJJOUdJclNnVnNKWXd3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjdmYmU4MzVhLWFiZDEtNDcxZS05ODE3LTY4NDhmODVlZTE1ZSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjM4MGViY2I0LWY2NDktNGQwMy1hZmU2LWNmYjA2OWQyMjRhOVwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.RlqrB7dEOfLmRolf75I2gmPwxcc-Owe1gAqRqcr7yzFMNXtHR2biuLbreQU1DjIFQECI1HoRU-Og_C4ieiIIGJfO7CMhqyciR1V3YGOX3q-ynostDL5igMQWgIPOnw4v_IvNJiupbQQjeTf3gb_sedh8YJdbYUpSDg1zqmzESNsbue_pbkePT6FAyOtkMGeJrw96h6G3p8KDaNvUiUt1BWBQjqJDJYf8lLEB4sdPW6KgFIr6jUIgOKFujUD-gNNjm6vrPVB74QpCNaBsNtJJtFf4QnUxQZT495zYLVKbgYNbDlpMo3Qk_-8hIH_g9Hm0ILWUBgU63hrccxngT6Hllg'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1215

{
  "content" : [ {
    "id" : "0597e8f7-be2b-11e9-b33b-d05099466715",
    "resourceId" : "d862d360-d75b-11e9-b01a-d05099466715",
    "actionId" : "d180d08a-d75b-11e9-b01a-d05099466715",
    "description" : "",
    "createdAt" : "2021-01-19T17:21:20.428991Z"
  }, {
    "id" : "0597e924-be2b-11e9-b33b-d05099466715",
    "resourceId" : "d862d360-d75b-11e9-b01a-d05099466715",
    "actionId" : "d180d1a5-d75b-11e9-b01a-d05099466715",
    "description" : "",
    "createdAt" : "2021-01-19T17:21:20.428991Z"
  }, {
    "id" : "0597e934-be2b-11e9-b33b-d05099466715",
    "resourceId" : "d862d360-d75b-11e9-b01a-d05099466715",
    "actionId" : "d180cffa-d75b-11e9-b01a-d05099466715",
    "description" : "",
    "createdAt" : "2021-01-19T17:21:20.428991Z"
  } ],
  "pageable" : {
    "sort" : {
      "sorted" : false,
      "unsorted" : true,
      "empty" : true
    },
    "pageSize" : 20,
    "pageNumber" : 0,
    "offset" : 0,
    "unpaged" : false,
    "paged" : true
  },
  "totalElements" : 171,
  "totalPages" : 9,
  "last" : false,
  "numberOfElements" : 20,
  "first" : true,
  "sort" : {
    "sorted" : false,
    "unsorted" : true,
    "empty" : true
  },
  "number" : 0,
  "size" : 20,
  "empty" : false
}

Get Policy

GET /policies/{id}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

resourceId

String

false

actionId

String

false

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies/cc09a0f8-0cb4-4e85-a639-94adbd8244aa' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJCSHBfTkllZi1iOVR2TkNXMDIwaEd3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImU0MzQyNjU0LWI4N2ItNDY5OC1iOTIwLTZkNWJlNGRiYTEyMSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjZlZGI1YjhkLTQzOTMtNDhjOS1iMzYxLTM1YTlkZDYxNjNiOFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.DBxJORyRSJubQ7HcM02wimpKVt3oBaagFEEApwxX5p4KE6g6ln-FDniMvC5UruPHO__BJ2Em6wPJhM-aVlA01gv768ltfBANyB0vGaHsiwvjf_n2uSxed2Vki8ocjrJJFkvEbFrewHD5I5qsG7Iz6gPuVnqZgAeDKsrFhr4Z84xGlQhtsfAwmv43RgF6fWmCIxTuHhslXZDH58qHlYzgn1Qctx7tYpD5LJKgLQE31g96yVxTDkJFaJn1SEflks7WUP74Ke3pip1Wm6EGlEZpGwAxjhVl8XDW4XnRUZpG0rz9V3rLNqkcOgLIfPxzrqAgr-HLCSMwfDGkHDG0WpYnVg'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 255

{
  "id" : "cc09a0f8-0cb4-4e85-a639-94adbd8244aa",
  "resourceId" : "1891414f-7b86-4015-94e7-20097976e48b",
  "actionId" : "b36318dd-4b41-44ef-9871-7fc504c32b12",
  "description" : "Create Foo for All Foos",
  "createdAt" : "2021-01-19T17:21:25.684550Z"
}

Create Policy

POST /policies

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

resourceId

String

false

actionId

String

false

Response fields

Path Type Optional Description

id

String

false

resourceId

String

false

actionId

String

false

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJ3Rk5YWmh6TzR6M0lzMENNQU8wSzhBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjgxNDVjYWVmLTk2NTctNGZkNS05OTU2LWFiNTRhY2Y4MzY5NSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcImNjZWRhY2FlLTYzNmQtNDFjZC05OWExLWNhMjhhOWI2MDkyMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.G95CgJS-J2VPINij2WK6OjiypbdkNl5xhWKeMwQZjcXQ7F5rgJGVZ8aCcCL6gSKPnHzjGykvbIgABeyblTCvbIilj7y2Uv0mBXg-zdYL0QcfXF2H-6M4q3k6tin0Fk7pe0dP8acmZBnacS5oqkWrTO1aL6ufXtZV13VDN8k0sBesZkL6xTT6BsPeio_-qU2UppUolPLnLhfPbL4AqbN1KX7__gYnDkl5_FTD2pcHiLlyk-JGimNDewXduiVTyotHll03G972Mz9GCtku2v8ak28i_moJIE_L_PG32k8R6yAwuhDkAgrkfBUtLOGyj_yfAAJdKcitQtAeM1_3nr-cqQ' \
    -d '{"resourceId":"5153a3eb-fb48-4116-be41-a9cd04da278b","actionId":"2035517b-da92-4b6c-bddb-b0ea7516af07"}'

Example response

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json;charset=UTF-8

{
  "id" : "024bdbe7-f536-4c0b-b08c-40ce5a99aa0a",
  "resourceId" : "5153a3eb-fb48-4116-be41-a9cd04da278b",
  "actionId" : "2035517b-da92-4b6c-bddb-b0ea7516af07",
  "description" : "Random Action 22 on All Random21",
  "createdAt" : "2021-01-19T17:21:29.657721Z"
}

Delete Policy

DELETE /policies/{id}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies/741f571b-b7bf-462f-93e1-fa27ae86656f' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJfOVhWVW9yOUFjMkxoQUFGUG9iTVFnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImI3ZmU5NWM4LTYyYTctNGYxMC1hZDIyLWQ0YzI2ODA2MmIzOCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjE5YzRiNjliLWNhZDctNDBiZi1hZmQxLWUyNTdiZWI0NjkzMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.mZR-2x2THIX8NbezJ0o6mNh2CYxNbiLPBenQiTZ_xx8YLV1dTV4hMDJU7wKRgvDrRy7FPlUHmbuUU2VPfDL20b5EEnq-fZ-9l0LC-hs25ccaPq4Tuz49LYNa683UOItcjug3y-kSK4LwRtSbXem1g5DJU7VzRPlsaTp2n5Sh8WNCbuS0JrykNs7B9-Yef_ZCCf4YXcFVQ_PvWXLld363tdohkCZzRBtpV5N2rb8SLZR5tibHaPjYZN1xz-A0gJOfstXS4dzeMcDe7oE0d8JAhGa3zXWQnGid0CqNEwiJfZEfBTzd3oDv9YpB97m6ocHitD6O-9brbbcFWDe92mL47Q'

Example response

HTTP/1.1 200 OK

Grant Policy To Identity

PUT /policies/{id}/identity-grants/{identityId}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

identityId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies/59fb4a45-23c7-4f02-8a95-807daac8e422/identity-grants/b8d7ed45-51cd-4aef-9a75-4f5efa8a4a92' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJmX0gzSkR0VDk1Q0pybUdBajdUYkRBIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImMwYTQxYzMyLTQzNmQtNDk1NS04YTUzLWEyODg4NzI3MWFkNSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcImM4MjMxMzlhLWI5YjAtNGM0OC1iMGE0LTUwN2I1YTYyMmNjM1wiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.gHilV6RdHghkKa0I6NNedI1EXwytS9cVV-s47GhuXG2dmDe5hpa90_7AqOk4_Abfmbivc4BrKM2X24DDEAGtyi4HU8PYSrSzFFEJX5yDLK6_JamcqT8uII3ogZoRJGorleZqXZYu5JiUFOemvcUVKIiZpPAJ_aOGyFLJ-Vmtxi2km8BzVegz28jLiVMfSXK5GT_g5CDSuhHsOIQoalx1YpfqW5UBvF71geKvdlLCVWigKNkQ_VGTuX5Tk5R6o4nouIOTbHNt3lrLU_tLNmkx-lk3phNS7nwvOCDkddtWPhk7_ira92KRTIIYDJH3OXzoynP1YYkYQm1NiwPtC-YE4g'

Example response

HTTP/1.1 200 OK

Revoke Policy From Identity

DELETE /policies/{id}/identity-grants/{identityId}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

identityId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies/1f35fc8d-bd96-4d3d-b229-4e0dca0185eb/identity-grants/56258dde-b39d-424a-a25b-97aa1dcc68de' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJnMWdpV3lYN0FkYktya0ZwMEE2V0x3IiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjZkMTMzNzdkLTRmYTctNDY3NS1iMzM1LWI4Y2UxMGMyOTA2MSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjJiNDgwZDFiLWQzMGMtNDNkMy04YjU5LTgzOWJlNzU1ZDIzNFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.TqsX1qKtJo5V6ftUrF_XS2hBqcJacgxy_19evUE3I2shsme2CTvYm_zW4kGByWWxwk_OdiGP4tPbuUa3wetNvOXLFCVy9vpagb4XyKtkusqChJ79ZNKlWHdJHO4aapA7sFZMg6y_nLZYrL6SydCkQRJ2nE8Vc4n5biRR42UoARU-mRJqCeaGMBnovJF9UnYl30ytuukO2FZ-M7ii42ZKua-O-qZs54d05yR6XBtXJT7u0L02_w0lfLBx5qufvKw0DwB_YTx5LvfXEz4w_CTWMiseIMInQoh1EJPs9RPFnz25RIJ7SYvdJf54aFNFXDUDDO2pMAJR1vJFYFeXzXvFGg'

Example response

HTTP/1.1 200 OK

Grant Policy To Role

PUT /policies/{id}/role-grants/{roleId}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

roleId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies/d5785685-d31c-477a-83aa-485f8a760111/role-grants/944d7640-e0fe-4292-87e6-52d1d27a4773' -i -X PUT \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJTenJmNUlmLVVsN05zOFdfcDBfbV9nIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImIwNDUwNzc5LThiYjktNGI5OC04M2RjLWVlN2I4NTJhY2MzYSIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjAzMjE1MjI5LWJmZDgtNGE5MC05OGRlLThmMjZhZTVjMDM5YlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.KlsoDeJlJzAavmpTVmD7mA40z0ws0Znj_YwVDz9rDxLhm9NRGDxUcMbFIcCMjKOoZkoiibR-x4yBf-HFca_ctA02XRUub-xpWJyBLyG-QCtDl5K94vgbUDhEh_5O3ysQX3gErs1p8eQj5hn46VGb828Xfuok2vYRFuHUVMVW7wkeK7p-YfYH1CG3_x9VuoPYUCCw489c6I3mMTR6FntUU0d4IWXAjB9m6MD3LSss_sVSiGRBeC26KeAzO4t35lyRU8OxdS3h8_Jc75uH-ahKZgN8rFs6sa-A1n7O8pRipNhue9eMf2S9-u9mEk3_Vgg0wPK-Z7iUpf7ExTXvW62Raw'

Example response

HTTP/1.1 200 OK

Revoke Policy From Role

DELETE /policies/{id}/role-grants/{roleId}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

roleId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/policies/e01eaf22-e526-4fb4-9213-79330843ba59/role-grants/8474418e-9792-419b-bc0a-755b9b8ce740' -i -X DELETE \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJfV2JXeDBHbi1BeF9xYndxcXlkT2ZnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6ImRlYTJhMDNjLWQ5Y2ItNDQzYi05MThlLTE0ZmRmMjMxMzJlNyIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg4OSwiZXhwIjoxNjExMDgwNDg5LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcIjliMTY5ZDlmLWE4ZmItNGQyMy04Zjg5LWJmNjIzMzljNjM5OFwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg4OX1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.PcwnIoP3wD5G80jFT8VF8xG6IZYor_Ry2_1mnFEfFtp_w6xL1YK4KrimwrBaAI7z7SPy_kx6fYaRAGmuGOfEflxhD_JjwP-5DpoZ6e6MJAMxuZmIStej2jM6yRA_q9I5SK1LzUexr51vMPApxL2_PV3XdVVlgZ-IFsrQPZABY6wYvtX51T7OseB-aeSOGi1KQZZkr9ZOYhOJBR_ziMRGpXm2KjID_xkIbz0eQM3sm6kR3Omjd9EqedV2QDnbg3rbfHJKBhRdeXlX6CgB3tr7w9cvLbB-FYQ8EN3kz1Mmw_Tl7yJ7V6Qb37fdeXW_QAa1ank1GZgHfuq0P6fOcXs9Iw'

Example response

HTTP/1.1 200 OK

Roles

Find Roles

GET /roles

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

nameLike

String

true

descriptionLike

String

true

policyId

Object

true

identityId

Object

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

id

String

false

name

String

false

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/roles' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Length: 1049
Content-Type: application/json;charset=UTF-8

{
  "content" : [ {
    "id" : "ce46aba4-d75b-11e9-b01a-d05099466715",
    "name" : "super-user",
    "description" : "Super User - All Access",
    "createdAt" : "2021-01-19T17:21:20.457225Z"
  }, {
    "id" : "ceea2e98-d75b-11e9-b01a-d05099466715",
    "name" : "Organization Admin",
    "description" : "All Actions on All Tenants",
    "createdAt" : "2021-01-19T17:21:20.457225Z"
  }, {
    "id" : "cf0481e9-d75b-11e9-b01a-d05099466715",
    "name" : "Organization (Read Only)",
    "description" : "Read Only Actions on All Tenants",
    "createdAt" : "2021-01-19T17:21:20.457225Z"
  } ],
  "pageable" : {
    "sort" : {
      "sorted" : false,
      "unsorted" : true,
      "empty" : true
    },
    "pageSize" : 20,
    "pageNumber" : 0,
    "offset" : 0,
    "unpaged" : false,
    "paged" : true
  },
  "totalElements" : 10,
  "totalPages" : 1,
  "last" : true,
  "numberOfElements" : 10,
  "first" : true,
  "sort" : {
    "sorted" : false,
    "unsorted" : true,
    "empty" : true
  },
  "number" : 0,
  "size" : 20,
  "empty" : false
}

Get Role

GET /roles/{idOrName}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

idOrName

String

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

Path Type Optional Description

id

String

false

name

String

false

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/roles/26a955d8-238b-41c2-a91d-6b5abb2b4035' -i -X GET

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 167

{
  "id" : "26a955d8-238b-41c2-a91d-6b5abb2b4035",
  "name" : "Foo Admin",
  "description" : "All Foo related actions",
  "createdAt" : "2021-01-19T17:21:25.695118Z"
}

Create Role

POST /roles

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

No parameters.

Request fields

Path Type Optional Description

name

String

false

description

String

false

Response fields

Path Type Optional Description

id

String

false

name

String

false

description

String

false

createdAt

String

false

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/roles' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"name":"Test Role 6a5df97b-3f69-42dc-a61b-16a91c57672b","description":"Random test role"}'

Example response

HTTP/1.1 200 OK
Content-Length: 197
Content-Type: application/json;charset=UTF-8

{
  "id" : "fc81fb8d-44c1-4ed4-960d-b702f3de968c",
  "name" : "Test Role 6a5df97b-3f69-42dc-a61b-16a91c57672b",
  "description" : "Random test role",
  "createdAt" : "2021-01-19T17:21:30.954752Z"
}

Delete Role

DELETE /roles/{id}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/roles/10670186-616e-47a4-b014-9ca414342a4a' -i -X DELETE

Example response

HTTP/1.1 200 OK

Grant Role To Identity

PUT /roles/{id}/identity-grants/{identityId}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

identityId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/roles/c57aeea5-4026-4a8d-ae22-358627d84ab2/identity-grants/bba968a6-c21b-4376-b0f9-0d7885dcb302' -i -X PUT

Example response

HTTP/1.1 200 OK

Revoke Role From Identity

DELETE /roles/{id}/identity-grants/{identityId}

Authorization

Authorization not required for this request.

Path parameters

Parameter Type Optional Description

id

Object

false

identityId

Object

false

Query parameters

No parameters.

Request fields

No request body.

Response fields

No response body.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/roles/f09a7d6e-9746-4032-9dac-2e0b25205e8a/identity-grants/634a51b3-8dff-4639-b82f-0443b646e0eb' -i -X DELETE

Example response

HTTP/1.1 200 OK

Claims

Find Claims

GET /claims

Authorization

Authorization not required for this request.

Path parameters

No parameters.

Query parameters

Supports standard paging query parameters.

Parameter Type Optional Description

identityIdIn

Object

true

roleIdIn

Object

true

policyIdIn

Object

true

resourceNameLike

String

true

actionNameLike

String

true

audience

String

true

Request fields

No request body.

Response fields

Standard paging response where content field is list of following objects:

Path Type Optional Description

resource

String

false

The policy resource name.

action

String

false

The policy action name.

Example request

$ curl 'https://gateway.netFoundry.io/auth/v1/claims' -i -X GET \
    -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJGSERVZlNKVUlxb0wxWnVqeC0zc1lnIiwiaXNzIjoiTmV0Rm91bmRyeSIsInN1YiI6IjYwMTkwMzhhLWNkMTAtNDM3Zi1hNGE3LTA4OGE5ZTFjY2EwZCIsImF1ZCI6ImlvLm5ldGZvdW5kcnkuYXV0aCIsImlhdCI6MTYxMTA3Njg5NCwiZXhwIjoxNjExMDgwNDk0LCJncmFudHMtc3VwZXIiOiJbe1wiaWRcIjpcImRlYzdiZGU2LWNjZTQtNDY2MS04MGViLWEyY2E3YTlkNGNkMlwiLFwibGFzdE1vZGlmaWVkXCI6MTYxMTA3Njg5NH1dIiwiZ3JhbnRzLWN1c3RvbSI6IltdIiwiZ3JhbnRzLXB1YmxpYyI6Ilt7XCJpZFwiOlwiOTdlZDBlMjEtMDdlMC00ZmQwLTllZGQtZGY0NWM2NjM5NWIyXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiY2JhMDc2OGQtY2YxNi00OGQ4LTgwOGUtNTdiMDk4MjQ0ZmZhXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNzNhZjA5NjAtNzJmNS00NGE1LWI4NGQtODM2YmZkZTNjNmZmXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiZDQ2ZWU0ZjctMjgxYS00M2E2LWFkZGYtM2E4MjRiYzZjMjY0XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiOWI4NjYwNTYtMWE2Yi00OWQ1LWE0OTctY2VkZTUyNDkxMTdjXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiYWY4ZTIyODItMWRjMi00NjdmLWE3N2MtYjAxYjcxYjJlMTcwXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODg1fSx7XCJpZFwiOlwiMjE5MGQwY2EtMmNjOS00MmU5LWIyZjQtZjdiNGI5ODM2ODUxXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiNmYzODU2YjUtMDQwMC00NGNkLTk3YjctZjU2NTBiNWZlMjc1XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfSx7XCJpZFwiOlwiMzI0OGI5OGMtMzcxMC00MGUxLTlmYWYtZjVhY2U2ZmI4ODRiXCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODkzfSx7XCJpZFwiOlwiMWMyOGVhNDItZjI3YS00MDkyLThjYzYtNDMwOTRlMDA5MmQ2XCIsXCJsYXN0TW9kaWZpZWRcIjoxNjExMDc2ODgyfV0iLCJncmFudHMtYWN0aW9uIjoiW10iLCJncmFudHMtc3RhbmRhcmQiOiJbXSJ9.PG1c4c2BT0m82_eB04Dyug4NwwInmUrwUF7JaLTLnFaqn6TPcTH6cU5ugHBKRMZ9XkvEfphJlUMkMQlyc9GhPi9q0_xUGRcxYoTfC8bks_CP-ePRPcyD_iH7msG6X6hhcQKVT6YG5LMfK5xv4rYr4x5OK3MidIIDtgj19xJVwZedDkblmEWLuwTHnjkayPF1TIsDrANeQJS0_4lu-6GULixRIHqGC2Ou5GEVeKiAdOfm8p6OjYiHCows_qeJRIb6fj0fEtlVpSAO5VK_B96yH0rkjVjqcm_wJwJl3Rm5Xabpo-voCzlnXBcy23ffwP1iLnPzDV9mO1Ri7VyacJsK6Q'

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 532

{
  "content" : [ {
    "resource" : "nfrn:tenants:*",
    "action" : "tenants:get-tenants"
  }, {
    "resource" : "nfrn:tenants:*",
    "action" : "tenants:get-tenants"
  }, {
    "resource" : "nfrn:orgs:*:billingkeys:*",
    "action" : "billing:create-keys"
  } ],
  "pageable" : "INSTANCE",
  "totalElements" : 21,
  "totalPages" : 1,
  "last" : true,
  "numberOfElements" : 21,
  "first" : true,
  "sort" : {
    "sorted" : false,
    "unsorted" : true,
    "empty" : true
  },
  "number" : 0,
  "size" : 0,
  "empty" : false
}