Warning

You're reading a development version (main) of the documentation. For the latest released version, please see 1.0.0.

4. Guidance for Data Consumers

Note

This documented is primarily intended for technical and operations teams within organisations wishing to participate in Open Energy as Data Consumers.

Note

The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.

4.1. Data Consumer Role and Responsibilities

Data Consumers are Open Energy members which can consume Shared Data (classes OE-SA and OE-SB in our Data Sensitivity Classes) from APIs produced and maintained by Data Providers.

In the figure below, we expect Data Consumers to occupy a number of roles from the lowest in the diagram upwards - they are organisations able to configure their infrastructure (in terms of the consumer parts of the Common Security Requirements, specifically Token acquisition and Token usage - calling a shared data API). This is covered by the bottom two boxes.

4.1.1. Data Consumer vs Service Provider

Open Energy does not differentiate between Data Consumers that access data to solve a problem internal to their organisation and those (known as Service Providers) which offer this as a service to other organisations. A Data Consumer may also be a Data Provider , the roles are not mutually exclusive.

In a similar vein, it would be entirely normal for a Data Consumer to also access Open Data, and to use the OEGS search system to locate data sets of interest, both open and shared.

../_images/consumer_abstraction_stack.svg

Fig. 4.1 Data Consumers in a typical problem solving context

4.1.2. Responsibility - Data consumption

The definition of a Data Consumer is that it consumes data from shared data APIs. To do this, the organisation MUST create cryptographic key material, and maintain a record within the OEGS directory. It is responsible for the integrity of this key material, and MUST put appropriate policies in place to ensure that this material is not misused.

4.1.3. Responsibility - Data licensing

Data Consumers are responsible for honouring the licenses for any data obtained through shared data APIs. Where the OEGS provides technical measures such as cryptographically signed receipts binding data and license conditions together, the Data Consumer is responsible for retaining and storing such receipts.

4.2. Problem Resolution (Data Consumers)

4.2.1. Effective resolution of problems (Data Consumers)

We encourage Data Consumers to direct any problems with data APIs first to the Data Provider concerned. In the event that a Data Consumer is unable to resolve an issue with a Data Provider, the issue MAY be flagged to the OEGS Dispute Resolution function for independent support.

4.2.2. Dispute resolution for access control and capability grant policies

In cases where a Data Consumer believes that access conditions or capability grant rules are being applied unfairly, the OEGS will act as a mediating party.

4.2.3. OEGS support

The OEGS Service Desk will provide participants with a supplementary ticket management process and supports Data Consumers in communicating problems to ecosystem participants via the noticeboard.