Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Conventions for ODRL Parties and Actions

A data clearing house can aggregate metadata from many repositories and broker access to resources in those repositores. Conventions for representing data access policies are necessary to support groupings of datasets based on their common access policies. Re-usable ODRL policies could be deployed across multiple repositories enabling a metadata harvester to aggregate content about access and make access conditions transparent for users searching the catalogue. The benefits of such a clearing house approach could include:

Standardised, machine-actionable data access policies necessary to deliver on two assumptions of a shared clearing house:

The basic approach to representing policies that can be implemented with existing ODRL technology is described in ODRL implementation.

Workflow Scenario:

The workflow outlined in the table below illustrates a message exchange initiated by a researcher requesting a dataset stored in a specific repository with a central clearing house mediating access on behalf of this and many other repositories. Note that here, the Broker (clearing house) is not acting as a portal for finding the data, but as a mediator of access to a resource known to be at an identified repository.

stepMessageMessage pseudo-description
1Request CDIF ResourceUser locates dataset resource on repository catalogue with DOI https://dx.doi.org:12345 and clicks on ‘Access Data’ button
2CDIF ODRL PolicyRepository posts new RequestFulfilment object to Brokerage API including location of CDIF record for https://dx.doi.org:12345, a JSON-LD artefact which encapsulates ODRL Policy #2b
3Request AgentPropertiesBrokerage parses the ODRL Policy statement and determines that the user must be located in Germany. More complex real-world examples might be the collection of additional information through an online form managed by the broker.
4Supply AgentPropertiesThe user will supply any information requested by the broker.
5Verify AgentPropertiesThe brokerage will perform the necessary validation and verification of any information supplied by the user. This might involve auxiliary processes, such as seeking third party approval.
6ODRL RequestOnce all conditions outlined by the ODRL Policy have been met and satisfied by the broker, an ODRL Request will be sent to the repository on behalf of the user.
{ “context”: “http://www.w3.org/ns/odrl.jsonld”,
type”:“Request”,
“uid”:“http://brokerage.com/odrlrequest/9a112bc6-d93d-4a59-8384-0ac65399ef94”,
“permission”: [
 {“target”: “http://repository7987.org/dataset_6123”,
 “action”: “http://cdif.org/odrl/1/download”,
 “assignee”: “http://orciduser675765”}
 ]}
7ODRL OfferThe repository will respond with an ODRL Offer to the broker.
{“context”: “http://www.w3.org/ns/odrl.jsonld”,
type”: “Offer”,
“uid”:“http://brokerage.com/odrloffer/2f93930b-93f7-418f-a045-aa49d09faf2b”,
“permission”: [
 {“target”: “http://repository7987.org/dataset_6123”,
 “action”: “http://cdif.org/odrl/1/download”,
 “assigner”: “http://repository7987.org”}
 ]}
8AccessToken and ODRL AgreementAssuming the broker accepts the offer on behalf of the user, an encrypted Access token is sent to the user and an ODRL Agreement is filed for audit purposes.
{
context”: “http://www.w3.org/ns/odrl.jsonld”,
type”: “Agreement”,
“uid”:" http://example.com/odrlagreement/d91d4663-f9bd-4bd5-8a81-c331e19bf987",
“dcterms:references”:[
 “http://brokerage.com/odrlrequest/9a112bc6-d93d-4a59-8384-0ac65399ef94”,
 “http://brokerage.com/odrloffer/2f93930b-93f7-418f-a045-aa49d09faf2b
 ],
“permission”: [
 {“target”:“http://repository7987.org/dataset_6123”,
 “action”: “http://cdif.org/odrl/1/download”,
 “assigner”: “http://repository7987.org”,
 “assignee”: “http://orciduser675765”}
 ]}
9Present Access TokenThe user presents the token to the Repository
10Retrieve ResourceThe repository makes the file available for immediate download to the user.

This is over-engineered for a simple download where the only condition is that the researcher be based in Germany. Practical access policies are likely to require multi-step processes with complex criteria, often with asynchronous handoffs to third parties for approval. The framework above, while necessarily brief for the purposes of this document, illustrates how a more complex stateful negotiation process could be performed using ODRL as the basis for defining conditions, executing those conditions through a centralised brokerage, and generating a rich set of accounting information for access requests and fulfilment across the supported repositories.