# digital-ecosystems/edc-simpl-infrastructure architecture

> Architecture diagram of the GitHub repository digital-ecosystems/edc-simpl-infrastructure, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/digital-ecosystems/edc-simpl-infrastructure
- Repository: https://github.com/digital-ecosystems/edc-simpl-infrastructure

## Overview

This SIMPL extension adds infrastructure deployment to Eclipse Dataspace Connector (EDC). A consumer defines an Infrastructure asset with a deployment-script ID, then starts an Infrastructure-PUSH transfer; the data plane resolves the transfer and asset, selects a sink, and sends an authenticated trigger request to the provisioning backend. The control plane supplies address validation and provisioning/deprovisioning, including Vault-backed secrets. The README documents the asset and transfer API workflow; source excerpts show extension registration and data-plane behavior, but not every EDC-internal dispatch detail.

Main entry points: [`extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java`](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java) (Control extension), [`extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java`](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java) (Infrastructure sink), [`extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java`](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java) (Provisioner), [`extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSourceFactory.java`](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSourceFactory.java) (Source factory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control plane"]
  node_cp_extension["Control extension"]
  node_source_validator["Source validator"]
  node_destination_validator["Destination validator"]
  node_resource_generator["Consumer resource generator"]
  node_resource_definition["Resource definition"]
  node_provisioner["Provisioner"]
  node_provisioned_resource["Provisioned resource"]
end

subgraph group_dataplane["Data plane"]
  node_dataplane_extension["Data-plane extension"]
  node_source_factory["Source factory"]
  node_data_source["Infrastructure source"]
  node_sink_factory["Sink factory"]
  node_data_sink["Infrastructure sink"]
  node_backend_client["Backend API client"]
end

subgraph group_domain["Shared domain types"]
  node_schema["Infrastructure schema"]
  node_auth_token["Auth token type<br/>[AuthToken.java]"]
end

subgraph group_external["External systems"]
  node_management["Management API"]
  node_vault[("EDC Vault")]
  node_backend["Provisioning backend"]
  node_edc_transfer["EDC transfer runtime"]
end

node_consumer(("EDC user"))

node_consumer -->|"submits asset and transfer"| node_management
node_management -.->|"uses extension capabilities"| node_cp_extension
node_cp_extension -->|"registers validator"| node_source_validator
node_cp_extension -->|"registers validator"| node_destination_validator
node_cp_extension -->|"registers generator"| node_resource_generator
node_cp_extension -->|"registers provisioner"| node_provisioner
node_resource_generator -->|"generates definition"| node_resource_definition
node_provisioner -->|"reads definition"| node_resource_definition
node_provisioner -->|"builds resource"| node_provisioned_resource
node_provisioner -->|"resolves or deletes secret"| node_vault
node_cp_extension -->|"registers token type"| node_auth_token
node_dataplane_extension -->|"registers factory"| node_source_factory
node_dataplane_extension -->|"registers factory"| node_sink_factory
node_dataplane_extension -->|"constructs client"| node_backend_client
node_edc_transfer -.->|"creates source"| node_source_factory
node_edc_transfer -.->|"creates sink"| node_sink_factory
node_source_factory -->|"creates source"| node_data_source
node_sink_factory -->|"builds sink"| node_data_sink
node_data_sink -->|"reads source part"| node_data_source
node_data_sink -->|"sends trigger"| node_backend_client
node_backend_client -->|"posts script request"| node_backend
node_data_sink -->|"resolves auth secret"| node_vault
node_data_sink -->|"decodes token"| node_auth_token
node_source_factory -->|"checks asset type and ID"| node_schema
node_sink_factory -->|"uses address type"| node_schema
node_source_validator -->|"validates script ID"| node_schema
node_destination_validator -->|"validates destination"| node_schema

click node_cp_extension "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java"
click node_source_validator "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureSourceDataAddressValidator.java"
click node_destination_validator "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureDestinationDataAddressValidator.java"
click node_resource_generator "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureConsumerResourceDefinitionGenerator.java"
click node_resource_definition "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureResourceDefinition.java"
click node_provisioner "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java"
click node_provisioned_resource "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureProvisionedResource.java"
click node_dataplane_extension "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/InfrastructureDataPlaneExtension.java"
click node_source_factory "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSourceFactory.java"
click node_data_source "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSource.java"
click node_sink_factory "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSinkFactory.java"
click node_data_sink "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java"
click node_backend_client "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/backend/BackendAPIClient.java"
click node_schema "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/core/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/InfrastructureSchema.java"
click node_auth_token "https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/core/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/types/AuthToken.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cp_extension,node_source_validator,node_destination_validator,node_resource_generator,node_resource_definition,node_provisioner,node_provisioned_resource,node_consumer toneBlue
class node_dataplane_extension,node_source_factory,node_data_source,node_sink_factory,node_data_sink,node_backend_client toneAmber
class node_schema,node_auth_token toneMint
class node_management,node_vault,node_backend,node_edc_transfer toneRose
```

## Components

### Control plane

- [Control extension](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java): `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java`
- [Source validator](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureSourceDataAddressValidator.java): `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureSourceDataAddressValidator.java`
- [Destination validator](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureDestinationDataAddressValidator.java): `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureDestinationDataAddressValidator.java`
- [Consumer resource generator](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureConsumerResourceDefinitionGenerator.java): `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureConsumerResourceDefinitionGenerator.java`
- [Resource definition](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureResourceDefinition.java): `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureResourceDefinition.java`
- [Provisioner](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java): `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java`
- [Provisioned resource](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureProvisionedResource.java): `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureProvisionedResource.java`

### Data plane

- [Data-plane extension](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/InfrastructureDataPlaneExtension.java): `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/InfrastructureDataPlaneExtension.java`
- [Source factory](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSourceFactory.java): `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSourceFactory.java`
- [Infrastructure source](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSource.java): `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSource.java`
- [Sink factory](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSinkFactory.java): `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSinkFactory.java`
- [Infrastructure sink](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java): `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java`
- [Backend API client](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/backend/BackendAPIClient.java): `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/backend/BackendAPIClient.java`

### Shared domain types

- [Infrastructure schema](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/core/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/InfrastructureSchema.java): `extensions/core/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/InfrastructureSchema.java`
- [Auth token type](https://github.com/digital-ecosystems/edc-simpl-infrastructure/blob/main/extensions/core/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/types/AuthToken.java): `extensions/core/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/types/AuthToken.java`

### External systems

- **Management API**
- **EDC Vault**
- **Provisioning backend**
- **EDC transfer runtime**

### Other components

- **EDC user**

## Connections

- EDC user → Management API: submits asset and transfer (evidence: `README.md`)
- Management API → Control extension: uses extension capabilities
- Control extension → Source validator: registers validator (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java`)
- Control extension → Destination validator: registers validator (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java`)
- Control extension → Consumer resource generator: registers generator (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java`)
- Control extension → Provisioner: registers provisioner (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java`)
- Consumer resource generator → Resource definition: generates definition (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/resource/InfrastructureConsumerResourceDefinitionGenerator.java`)
- Provisioner → Resource definition: reads definition (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java`)
- Provisioner → Provisioned resource: builds resource (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java`)
- Provisioner → EDC Vault: resolves or deletes secret (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureProvisioner.java`)
- Control extension → Auth token type: registers token type (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/InfrastructureControlPlaneExtension.java`)
- Data-plane extension → Source factory: registers factory (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/InfrastructureDataPlaneExtension.java`)
- Data-plane extension → Sink factory: registers factory (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/InfrastructureDataPlaneExtension.java`)
- Data-plane extension → Backend API client: constructs client (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/InfrastructureDataPlaneExtension.java`)
- EDC transfer runtime → Source factory: creates source
- EDC transfer runtime → Sink factory: creates sink
- Source factory → Infrastructure source: creates source (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSourceFactory.java`)
- Sink factory → Infrastructure sink: builds sink (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSinkFactory.java`)
- Infrastructure sink → Infrastructure source: reads source part (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java`)
- Infrastructure sink → Backend API client: sends trigger (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java`)
- Backend API client → Provisioning backend: posts script request (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/backend/BackendAPIClient.java`)
- Infrastructure sink → EDC Vault: resolves auth secret (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java`)
- Infrastructure sink → Auth token type: decodes token (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSink.java`)
- Source factory → Infrastructure schema: checks asset type and ID (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasource/InfrastructureDataSourceFactory.java`)
- Sink factory → Infrastructure schema: uses address type (evidence: `extensions/data-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/dataplane/datasink/InfrastructureDataSinkFactory.java`)
- Source validator → Infrastructure schema: validates script ID (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureSourceDataAddressValidator.java`)
- Destination validator → Infrastructure schema: validates destination (evidence: `extensions/control-plane/src/main/java/eu/europa/ec/simpl/programme/infrastructure/edc/controlplane/dataaddress/InfrastructureDestinationDataAddressValidator.java`)
