Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Kleine wijzigingen: Aanpassingen t.b.v. leesbaarheid
Info

Deze pagina’s zijn in het engels ten behoeve van mogelijk internationale ontwikkelaars

...

This endpoint must MUST be implemented by the following roles:

...

Used to obtain broker evidence from the trust framework catalogue. Broker evidence can be used by a data service broker in future data service requests to data service providers. In the DSGO broker evidence expresses the power to act of a data service consumer to a selected data service broker. For more information about data service brokers in the DSGO, see Datadienstbrokers.

Excerpt
name/brokers
Panel
panelIconId2705
panelIcon:white_check_mark:
panelIconText
bgColor#FFF0B3

the The trust framework catalogue MUST provide broker evidence via the /brokers endpoint

Information about the use of a data service broker is provided in brokerEvidence object, see the object definition of brokerEvidence. The brokerEvidence object is based on the delegationEvidence object, see delegationEvidence object.

...

object

...

Parameters

...

Type

...

Description

...

notBefore

...

Required

...

Integer

...

.

...

...

notOnOrAfter

...

Required

...

Integer

...

Timestamp indicating the end of the validity period of this broker evidence, MUST be according to ISO 8601, following the timestamp conventions. The trust framework catalogue MUST set the validity period to be one hour.

...

policyIssuer

...

Required

...

String

...

MUST contain a valid Organisation ID (an EORI or KvK number) of the data service consumer making use of a data service broker.

...

target

...

Required

...

Object

...

Object MUST contain an accessSubject. No other elements are allowed. It makes the entire broker evidence applicable only to this accessSubject.

...

accessSubject

...

Required

...

String in target

...

MUST contain a valid Organisation ID (an EORI or KvK number) of the data service broker which receives the rights to act for a data service consumer).

Info

Note, at this time, brokerEvidence provides a data service broker the complete power to act for a data service consumer in all data services. It is foreseen that a data service consumer may only wish to grant a data service broker partial power to act in specific circumstances (for example, in a specific data service, or only at a specific data service provider). When this becomes relevant, the brokerEvidece object will be expanded in line with the delegationEvidece object.

Expand
titleExample brokerEvidence object
Code Block
languagejson
{
  "notBefore": 1541058939,
  "notOnOrAfter": 2147483647,
  "policyIssuer": "EU.EORI.NL000000005",
  "target": {
    "accessSubject": "EU.EORI.NL000000001"
  }
}

Endpoint

the The /brokers endpoint follows the generic technical requirements, as well as the requirements specified for specific methods. The figure below gives an overview of the HTTP methods that are supported by the /brokers endpoint. These methods are further detailed and specified in the pages below:

Page Tree
rootDSGO:AD:@self
startDepth1

Swagger open api macro
displayOperationIdfalse
methodsnone,get,put,post,delete,options,head,patch,trace
validator
defaultModelsExpandDepth0
urlhttps://api.swaggerhub.com/apis/DSGO/developer-portal/0.7.0
tokend51a8d42-88d4-4747-82dc-76dfeed3121d
defaultModelRenderingexample
filterBrokers
passwordZ@&&BYe27jt^e*9^3B$jryXgxE^^8Qwh
expandlist
showCommonExtensionsfalse
filename
operations
maxDisplayedTags
attachfalse
showExtensionsfalse
displayRequestDurationfalse
usernamebauke.rietveld@digigo.nu
order