Eddie Framework France
As mentioned in the section for EDDIE Framework, each country can have a slightly different architecture. For France, the Framework looks as follows:
| Container | Responsibility |
|---|---|
| EDDIE Core | Provides the core functionalities of EDDIE, e.g. handles energy data or meta data that is forwarded to EDDIE, stored in the database or send somewhere else. |
| Regional Connector France | The Enedis Datahub is a permission administrator and data access provider for historically validated data in France. Enedis offers various APIs, including the Data Connect API, which is useful for EDDIE to manage data access. Through these APIs, Enedis provides the eligible parties with the means to obtain metering data on behalf of customers in France. The provided APIs are based on HTTP/REST principles and use an OAuth 2.0-based authorization scheme to access the data. The identified issues related to the use of Enedis are summarized as a Table BPRT_Infra_IssueList.xlsx. |
| Database | The Database stores important meta data, e.g. access rights, parameters for data exchange or country specific information. |
Connector Specifics
|The ENEDIS Datahub is a permission administrator and data access provider for historically validated data in France. They offer some APIs from which we only consider the Data Connect API. It provides means to authorize a customer and obtain metering data on behalf of this customer for providing additional services.
This API is based on HTTP/REST principles and uses an OAuth 2.0 based authorization scheme to access that data.
Authorization
The current authorization API Jeton v3 is based on OAuth 2.0. This is the API ENEDIS offers to fulfill it's role as a permission administrator.
ENEDIS implements the Client Credentials Grant Flow, i.e. we provide the credentials of our ENEDIS application to the Jeton v3 API which will return a JWT bearer token. The token needs to be provided to the other APIs when requesting data e.g. consumption data like daily consumption or a load curve. With the token we can request data for all usage points (metering points) for which we have been granted access.
Access to a usage point (metering point) is granted by a user via the Authorization v1 API. This API redirects the user to an ENEDIS page on which they can grant access to their usage points.
RFCs for OAUTH grants:
- RFC 6749: Authorization Code Grant
- RFC 6749: Resource Owner Password Credentials Grant
- RFC 6749: Client Credentials Grant
A description of various authorization flows can be found in the auth0 documentation, see Authentication and Authorization Flows.
Metering Data
Links to ENEDIS Datahub
- Services providers presentation: presentation of APIs for service providers
- Services API: description of the available APIs in French
- État des services: current status of the ENEDIS services in French
- Data Connect
- Data Connect API documentation: swagger API documentation in French
Note:
- Most links to ENEDIS require the creation of a user account. An account can be created by logging in with an email that has no account associatated (yes very obvious...).
- Use the French documentation as reference and translate with e.g. a browser plugin, as the english version is outdated.