LogoLogo
EDCDSPortalDAPS
CE 11.0.0
CE 11.0.0
  • Welcome
  • Key Concepts
  • FAQ
  • Frontend
    • Walkthrough
    • Dashboard
    • Providing
      • 1. Create Data Offer
      • 2. Create Asset
      • 3. Create Policy
      • 4. Create Contract Definition
    • Consuming
      • 1. Finding Offers
      • 2. Initiating Transfers (HttpData-Push)
      • 3. Transfer History
    • Contract Termination
  • Backend
    • Postman
    • API-Wrapper vs Management-API
    • API-Wrapper
      • Java Client Library
    • Management-API
      • Secrets API
      • Contract Definition: Multiple Assets
      • QuerySpec
      • Health Check APIs
      • Policy: Business Partner Groups
      • Policy: Unrestricted
    • Data Transfer
      • HttpData-Pull (Parameterized)
      • AWS S3 Transfer
      • Source: Audit Headers
      • Source/Sink: OAuth2/API-Key
  • Community Edition Deployment
    • Overview
    • Local Demo
    • Production
  • Customer Links
    • Glossary
    • sovity Hub
    • Service Desk
Powered by GitBook
LogoLogo

sovity

  • Homepage
  • About us
  • GitHub
  • LinkedIn

Information

  • Contact
  • Imprint
  • Privacy Policy

© by sovity GmbH

On this page
  • 1. HttpData-Push
  • 2. HttpData-Pull
  • 3. AmazonS3-Push
  • Comparison of Transfer Types
  • Understanding Data-Source and Data-Sink types

Was this helpful?

Edit on GitHub
  1. Backend

Data Transfer

Last updated 2 months ago

Was this helpful?

The Connector supports various transfer types to enable secure and efficient data exchange. Below is an overview of the currently supported transfer types and their detailed workflows.

The transfer types HttpData-Pull and AmazonS3-Push are currently available only in our hosted Enterprise Edition. The available transfer types may vary depending on the Connector, for any questions about which types are supported by your specific connector, please feel free to contact us.

1. HttpData-Push

The HttpData-Push transfer type involves the provider fetching the data from its internal data source and pushing it to the consumer's desired data sink. This mode ensures the consumer receives the data without directly accessing the provider’s source system.

Workflow

  1. Initiation:

    • The consumer triggers the transfer request, either through the EDC-UI or via API calls from a backend application. This backend can also act as the data sink (a1).

    • The consumer's control plane sends a transfer request to the provider's control plane (a2), including the consumer's sink URL and access credentials.

  2. Validation:

    • The provider control plane verifies the context, ensuring the consumer is authorized to request the data.

  3. Data Fetching and Transfer:

    • The provider's data plane retrieves the data from the defined source (e.g., a REST endpoint) based on the asset's data address (a4).

    • The fetched data is cached temporarily (a5) and then pushed to the consumer's data sink (a6).

2. HttpData-Pull

In the HttpData-Pull transfer type, the consumer actively retrieves data directly from the provider's endpoint using the details provided in an Endpoint Data Reference (EDR).

Workflow

  1. Contract Negotiation:

    • The consumer and provider agree on a contract agreement.

  2. EDR Issuance:

    • The provider issues an EDR containing the endpoint URL, access credentials, and other metadata.

  3. Data Retrieval:

    • The consumer uses the EDR to fetch the data directly from the provider’s endpoint via a GET or similar HTTP method and the details from the EDR.

3. AmazonS3-Push

The AmazonS3-Push transfer type allows the provider to upload data directly to an Amazon S3 bucket managed by the consumer.

Workflow

  1. Initiation:

    • The consumer initiates the transfer request via the EDC-UI or API.

    • The consumer provides the S3 bucket details (e.g., bucket name, region) and credentials, such as an AWS access key or a pre-signed URL.

  2. Validation:

    • The provider validates the transfer request and ensures the consumer is authorized to receive the data.

  3. Data Upload:

    • The provider's data plane uploads the data to the specified S3 bucket using the provided credentials.

Comparison of Transfer Types

Transfer Type
Consumer Role
Provider Role
Mode
Example Use Cases

HttpData-Push

Provides data sink; initiates request

Fetches data and pushes to sink

Asynchronous

Batch file transfer, REST updates

HttpData-Pull

Fetches data directly using EDR

Issues EDR and hosts endpoint

Consumer-driven

On-demand API access

AmazonS3-Push

Provides S3 bucket details and credentials

Uploads data to consumer's S3 bucket

Asynchronous

Large-scale data transfers

The choice of transfer type depends on factors like real-time requirements, control over data flow, and system architecture.

Understanding Data-Source and Data-Sink types

When working with transfer types, it’s important not to confuse transfer types with data-source and data-sink types. For example, HttpData refers to REST APIs typically used as data-sources or data-sinks for transfer types like HttpData-Push, while AmazonS3 is the typical data-sink type for the AmazonS3-Push transfer type. Other data-source and data-sink types may also apply depending on the scenario. If you have any questions or need clarification, please don’t hesitate to contact us.

Data Transfer Types