Skip to content

Commit

Permalink
Update data-transfer-methods.md (#1076)
Browse files Browse the repository at this point in the history
Add disclaimer that HTTPProxy is only available in EDC Enterprise Edition (CaaS)
  • Loading branch information
SebastianOpriel authored Nov 6, 2024
1 parent fd8a870 commit 739508f
Showing 1 changed file with 8 additions and 5 deletions.
13 changes: 8 additions & 5 deletions docs/getting-started/documentation/data-transfer-methods.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,18 @@
Which data transfer methods are supported by the EDC-Connector?
========

The connector supports two different data transfer modes:
The connector supports two different data transfer modes visualized in the following diagram.

1. HTTPData: The provider EDC fetches the data from the responsible data source and pushes the data to the consumer's desired data sink. The transfer flow is either initiated by the consumer using the EDC-UI or from a consumer backend via API calls, which could be a use case application and could also serve as a data sink (a1). This triggers an initiation for sending a transfer-request from the consumer control plane and the request is send towards the control plane of the provider. With this call (a2) the access credentials of the consumers data sink and its URL together with other necessary information are handed over to the provider. After successfully checking the context, e.g. that the requesting consumer is eligible to request the data, the provider control plane orchestrates a call to a provider data plane to process the transfer request further (a3). The provider data plane fetches the data from the responsible data source, as defined in the asset data-address and any additional parameterizations, with a REST call (a4) and caches the data (a5), to finally transfer the data to the desired consumer data sink (a6).
2. HTTPProxy: The provider EDC fetches the data and passes it on consumer's data transfer request synchronously back to the consumer.

The following diagram illustrates the different transmission modes:
![data-transfer-methods.png](images%2Fdata-transfer-methods.png)

**HTTPData**: The provider EDC fetches the data from the responsible data source and pushes the data to the consumer's desired data sink. The transfer flow is either initiated by the consumer using the EDC-UI or from a consumer backend via API calls, which could be a use case application and could also serve as a data sink (a1). This triggers an initiation for sending a transfer-request from the consumer control plane and the request is send towards the control plane of the provider. With this call (a2) the access credentials of the consumers data sink and its URL together with other necessary information are handed over to the provider. After successfully checking the context, e.g. that the requesting consumer is eligible to request the data, the provider control plane orchestrates a call to a provider data plane to process the transfer request further (a3). The provider data plane fetches the data from the responsible data source, as defined in the asset data-address and any additional parameterizations, with a REST call (a4) and caches the data (a5), to finally transfer the data to the desired consumer data sink (a6).

**HTTPProxy**: The provider EDC fetches the data and passes it on consumer's data transfer request synchronously back to the consumer.
> [!WARNING]
> The HttpProxy / HTTP Pull feature is only available for our sovity EDC Enterprise Edition.
# Consuming Data via HttpProxy / HTTP Pull

The Use-Case Backend-Application is involved in steps b1, b4, b5 and b8 of the diagram. It should provide an endpoint for receiving
the EDR (b4). These information can then be used to start the tranfser request (b5). The result of the transfer request
will contain the data (b8). Please see related [documentation](./pull-data-transfer.md) about how to implement it technically.

0 comments on commit 739508f

Please sign in to comment.