# eclipse-dataspace-hub/jad architecture

> Architecture diagram of the GitHub repository eclipse-dataspace-hub/jad, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eclipse-dataspace-hub/jad
- Repository: https://github.com/eclipse-dataspace-hub/jad

## Overview

JAD demonstrates deploying and managing a dataspace as a Kubernetes SaaS platform. The documented platform includes participant control planes, identity and credential services, data transfer, authentication, secrets, persistence, messaging, and CFM provisioning; the repository also implements a certificate-exchange extension for its data plane. The principal user-facing workflow is certificate administration and authenticated retrieval through the extension APIs. The README excerpt documents platform roles but not their runtime wiring, and most deployment templates and launcher sources were not sampled, so those relationships are left unverified rather than inferred.

Main entry points: [`extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java`](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java) (Public Certificate API), [`extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertInternalExchangeController.java`](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertInternalExchangeController.java) (Internal Certificate API), [`extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/CertStore.java`](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/CertStore.java) (Certificate Store), [`extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeExtension.java`](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeExtension.java) (Certificate API Setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Dataspace Platform"]
  node_profile["Kubernetes Profile"]
  node_controlplane["Control Plane"]
  node_identityhub["IdentityHub"]
  node_issuer["IssuerService"]
  node_dataplane["Data Plane"]
  node_keycloak["Keycloak"]
  node_vault[("HashiCorp Vault")]
  node_postgres[("PostgreSQL")]
  node_nats["NATS"]
end

subgraph group_provisioning["Participant Provisioning"]
  node_cfm["Connector Fabric Manager"]
  node_tenant["Tenant Manager"]
  node_provision["Provision Manager"]
end

subgraph group_certs["Certificate Exchange"]
  node_cert_extension["Certificate API Setup"]
  node_public_api["Public Certificate API"]
  node_internal_api["Internal Certificate API"]
  node_metadata["Certificate Metadata<br/>[CertMetadata.java]"]
  node_activity["Download Activity<br/>[ActivityItem.java]"]
end

subgraph group_persistence["Certificate Persistence"]
  node_store_api["Certificate Store<br/>[CertStore.java]"]
  node_sql_store["SQL Certificate Store<br/>[SqlCertStore.java]"]
  node_database[("Certificate Database")]
end

node_operator(("Cloud Operator"))

node_operator -.->|"deploys"| node_profile
node_profile -.->|"configures"| node_dataplane
node_cfm -.->|"manages tenants"| node_tenant
node_cfm -.->|"provisions participants"| node_provision
node_cert_extension -->|"registers"| node_public_api
node_cert_extension -->|"registers"| node_internal_api
node_public_api -->|"queries and retrieves"| node_store_api
node_public_api -->|"records downloads"| node_activity
node_public_api -->|"returns metadata"| node_metadata
node_internal_api -->|"stores and retrieves"| node_store_api
node_internal_api -->|"creates metadata"| node_metadata
node_store_api -->|"implemented by"| node_sql_store
node_sql_store -->|"reads and writes"| node_database

click node_profile "https://github.com/eclipse-dataspace-hub/jad/tree/main/charts/jad-dataspace-profile"
click node_dataplane "https://github.com/eclipse-dataspace-hub/jad/tree/main/launchers/dataplane"
click node_tenant "https://github.com/eclipse-dataspace-hub/jad/blob/main/openapi/tenant-manager.yaml"
click node_provision "https://github.com/eclipse-dataspace-hub/jad/blob/main/openapi/provision-manager.yaml"
click node_cert_extension "https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeExtension.java"
click node_public_api "https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java"
click node_internal_api "https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertInternalExchangeController.java"
click node_metadata "https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/model/CertMetadata.java"
click node_activity "https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/model/ActivityItem.java"
click node_store_api "https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/CertStore.java"
click node_sql_store "https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/sql/SqlCertStore.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_profile,node_controlplane,node_identityhub,node_issuer,node_dataplane,node_keycloak,node_vault,node_postgres,node_nats toneBlue
class node_cfm,node_tenant,node_provision toneAmber
class node_cert_extension,node_public_api,node_internal_api,node_metadata,node_activity toneMint
class node_store_api,node_sql_store,node_database toneRose
class node_operator toneIndigo
```

## Components

### Dataspace Platform

- [Kubernetes Profile](https://github.com/eclipse-dataspace-hub/jad/tree/main/charts/jad-dataspace-profile): `charts/jad-dataspace-profile`
- **Control Plane**
- **IdentityHub**
- **IssuerService**
- [Data Plane](https://github.com/eclipse-dataspace-hub/jad/tree/main/launchers/dataplane): `launchers/dataplane`
- **Keycloak**
- **HashiCorp Vault**
- **PostgreSQL**
- **NATS**

### Participant Provisioning

- **Connector Fabric Manager**
- [Tenant Manager](https://github.com/eclipse-dataspace-hub/jad/blob/main/openapi/tenant-manager.yaml): `openapi/tenant-manager.yaml`
- [Provision Manager](https://github.com/eclipse-dataspace-hub/jad/blob/main/openapi/provision-manager.yaml): `openapi/provision-manager.yaml`

### Certificate Exchange

- [Certificate API Setup](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeExtension.java): `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeExtension.java`
- [Public Certificate API](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java): `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java`
- [Internal Certificate API](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertInternalExchangeController.java): `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertInternalExchangeController.java`
- [Certificate Metadata](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/model/CertMetadata.java): `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/model/CertMetadata.java`
- [Download Activity](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/model/ActivityItem.java): `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/model/ActivityItem.java`

### Certificate Persistence

- [Certificate Store](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/CertStore.java): `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/CertStore.java`
- [SQL Certificate Store](https://github.com/eclipse-dataspace-hub/jad/blob/main/extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/sql/SqlCertStore.java): `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/sql/SqlCertStore.java`
- **Certificate Database**

### Other components

- **Cloud Operator**

## Connections

- Cloud Operator → Kubernetes Profile: deploys
- Kubernetes Profile → Data Plane: configures
- Connector Fabric Manager → Tenant Manager: manages tenants
- Connector Fabric Manager → Provision Manager: provisions participants
- Certificate API Setup → Public Certificate API: registers (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeExtension.java`)
- Certificate API Setup → Internal Certificate API: registers (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeExtension.java`)
- Public Certificate API → Certificate Store: queries and retrieves (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java`)
- Public Certificate API → Download Activity: records downloads (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java`)
- Public Certificate API → Certificate Metadata: returns metadata (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertExchangePublicController.java`)
- Internal Certificate API → Certificate Store: stores and retrieves (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertInternalExchangeController.java`)
- Internal Certificate API → Certificate Metadata: creates metadata (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/api/CertInternalExchangeController.java`)
- Certificate Store → SQL Certificate Store: implemented by (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/CertExchangeSqlExtension.java`)
- SQL Certificate Store → Certificate Database: reads and writes (evidence: `extensions/data-plane-certs/src/main/java/org/eclipse/edc/virtualized/dataplane/cert/store/sql/SqlCertStore.java`)
