WIP_03: Transferring data - Mobility-Data-Space/mobility-data-space GitHub Wiki
The Eclipse Dataspace Components (EDC) Connector is the key component for connecting to the MDS and providing and consuming data. There are two options to access the MDS with:
- Connector-as-a-Service (CaaS)
- On-premise installation
Setting up a Connector
Requesting Connector-as-a-service
A MDS CaaS is a managed, cloud-based service that enables easy integration and data exchange within the Mobility Data Space.
Together with our partner Think-it we provide a platform that acts as a mediator between your system and those of other MDS members. The CaaS reduces the complexity of setting up and operating a connector, as you do not need your own operating environment or in-depth IT expertise.
Using the CaaS is the simplest way to obtain a registered and compliant connector.
If you want to order a CaaS for your organization please contact us.
After the deployment of your CaaS, you will receive an email from our provider with all necessary information.
Your newly registered CaaS will then be visible in the Connectors list in the MDS portal.
You can access the CaaS user interface via the portal using Single Sign-On (SSO) by clicking the Frontend button next to your CaaS entry in the list.
Setting Up a Connector On-Premise
In order to start the deployment, you need to define a (sub)domain for your connector. Through this domain your connector will be exposed to the internet and it will be the base-url (so called dsp endpoint) of the connector.
Setup and configure the connector
-
A deployment guide for self-hosting a functional MDS EDC can be found here.
-
If you want additionally deploy the MDS EDC UI, it is available here.
Register your Connector in the MDS portal
In the MDS portal, go to Connectors and click the Add On-Prem Connector button.
Fill out the form and click Next to continue.
Fill out the fields in the Generate Certificate tab, then click Generate & Download Certificate.
Using the Connector
Introduction to the Connector UI
- Connector Dashboard
- Rough description of items
Creating a Data Offer
- Explain how a data offer can be created (wizzard) + screenshot
- difference between available and on request
- explaination of policies
- data offer creation without wizzard
- Create Data Offer via API + template
Consuming a Data Offer
- Explain how a data offer can be consumed + screenshots (copying endpoint from broker, select data offer from connector, contract negotiation, transfer)
- consume data via API + template
Manual Approval
- Explian manual approval
- template for manual approval processes performed via API
Terminating a Data Contract
- Explain consequences of terminating data contract + screenshot
- template for terminating a contract via API