{"id":13565248,"url":"https://github.com/International-Data-Spaces-Association/DataspaceConnector","last_synced_at":"2025-04-03T22:31:01.070Z","repository":{"id":36955256,"uuid":"474110881","full_name":"International-Data-Spaces-Association/DataspaceConnector","owner":"International-Data-Spaces-Association","description":"This is an IDS Connector reference implementation.","archived":false,"fork":true,"pushed_at":"2024-02-02T01:02:44.000Z","size":28875,"stargazers_count":30,"open_issues_count":97,"forks_count":21,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-05-01T09:59:33.487Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"FraunhoferISST/DataspaceConnector","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/International-Data-Spaces-Association.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-03-25T17:47:44.000Z","updated_at":"2024-03-07T07:31:33.000Z","dependencies_parsed_at":"2023-02-17T20:31:14.785Z","dependency_job_id":null,"html_url":"https://github.com/International-Data-Spaces-Association/DataspaceConnector","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/International-Data-Spaces-Association%2FDataspaceConnector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/International-Data-Spaces-Association%2FDataspaceConnector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/International-Data-Spaces-Association%2FDataspaceConnector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/International-Data-Spaces-Association%2FDataspaceConnector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/International-Data-Spaces-Association","download_url":"https://codeload.github.com/International-Data-Spaces-Association/DataspaceConnector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247089948,"owners_count":20881893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T13:01:43.147Z","updated_at":"2025-04-03T22:30:56.046Z","avatar_url":"https://github.com/International-Data-Spaces-Association.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n    \u003cimg alt=\"Logo\" height=\"200\" src=\"docs/assets/images/dsc_logo.png\"/\u003e\n  \u003cbr\u003e\n      Dataspace Connector\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#contributing\"\u003eContribute\u003c/a\u003e •\n  \u003ca href=\"https://international-data-spaces-association.github.io/DataspaceConnector/\"\u003eDocs\u003c/a\u003e •\n  \u003ca href=\"https://github.com/International-Data-Spaces-Association/DataspaceConnector/issues\"\u003eIssues\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\nThe Dataspace Connector is an implementation of an IDS connector component following the\n[IDS Reference Architecture Model](https://www.internationaldataspaces.org/wp-content/uploads/2019/03/IDS-Reference-Architecture-Model-3.0.pdf).\nIt integrates the [IDS Information Model](https://github.com/International-Data-Spaces-Association/InformationModel)\nand uses the [IDS Messaging Services](https://github.com/International-Data-Spaces-Association/IDS-Messaging-Services)\nfor IDS functionalities and message handling.\nThe core component in this repository provides a REST API for loading, updating, and deleting\nresources with local or remote data enriched by its metadata. It supports IDS conform message\nhandling with other IDS connectors and components and implements usage control for selected IDS\nusage policy patterns.\n\n***\n\n\u003ch3 align=\"center\" \u003e\n  \u003ca href=\"https://international-data-spaces-association.github.io/DataspaceConnector/\"\u003e\n    D O C U M E N T A T I O N\n  \u003c/a\u003e\n\u003c/h3\u003e\n\n***\n\n## Quick Start\n\nThe official Docker images of the Dataspace Connector can be found\n[here](https://github.com/International-Data-Spaces-Association/DataspaceConnector/pkgs/container/dataspace-connector).\n\nFor an easy deployment, make sure that you have [Docker](https://docs.docker.com/get-docker/)\ninstalled. Then, execute the following command:\n\n```commandline\ndocker run -p 8080:8080 --name connector ghcr.io/international-data-spaces-association/dataspace-connector:latest\n```\n\nIf everything worked fine, the connector is available at\n[https://localhost:8080/](https://localhost:8080/). The API can be accessed at\n[https://localhost:8080/api](https://localhost:8080/api). The Swagger UI can be found at\n[https://localhost:8080/api/docs](https://localhost:8080/api/docs).\n\nFor certain REST endpoints, you will be asked to log in. The default credentials are `admin` and\n`password`. **Please take care to change these when deploying and hosting the connector yourself!**\n\nFor a more detailed explanation of deployment and configurations, see\n[here](https://international-data-spaces-association.github.io/DataspaceConnector/Deployment).\n\nNext, please take a look at our\n[communication guide](https://international-data-spaces-association.github.io/DataspaceConnector/CommunicationGuide).\n\n**Note**:\nFor a more detailed or advanced Docker or Kubernetes deployment, as well as a full setup with the\nConnector and its GUI, see [here](https://github.com/International-Data-Spaces-Association/IDS-Deployment-Examples/tree/main/dataspace-connector).\nIf you want to build and run locally, follow [these](https://international-data-spaces-association.github.io/DataspaceConnector/GettingStarted#local-build) steps.\n\n\n### Security and Verification\n\nThe Docker images are signed using [cosign](https://github.com/sigstore/cosign).\nThe public key of the Dataspace Connector can be found at the root of the project structure\n([here](https://github.com/International-Data-Spaces-Association/DataspaceConnector/blob/main/dsc.pub)).\n\nFor verifying that you have received an official image from a trusted source, run:\n\n```commandline\ncosign verify --key dsc.pub ghcr.io/international-data-spaces-association/dataspace-connector:latest\n```\n\n### Software Bill of Material (SBoM)\n\nThe Software Bill of Material (SBoM) for every Docker image is supplied as\n[SPDX-JSON](https://spdx.org/licenses/JSON.html) and can be found by appending `-sbom` to the\nimage tag. For example, the SBoM for `ghcr.io/international-data-spaces-association/dataspace-connector:latest`\nis `ghcr.io/international-data-spaces-association/dataspace-connector:latest-sbom`.\n\nThe SBoM can be pulled via tools like [oras](https://github.com/oras-project/oras).\n\n```commandline\noras pull ghcr.io/international-data-spaces-association/dataspace-connector:latest-sbom -a\n```\n\n**Note**: Also the SBoM images can be validated using [cosign](https://github.com/sigstore/cosign)\nas shown [above](#security-and-verification).\n\n### Database Migration\n\nBefore updating to a new major release, please read\n\u003ca href=\"https://international-data-spaces-association.github.io/DataspaceConnector/Deployment/DatabaseMigration\"\u003ethis\u003c/a\u003e\nguide!\n\n### Connector Components Overview\n\nThe container architecture of the entire IDS Connector is made up of several components. Some of them are optional. At the center is the Dataspace Connector itself (connector core) with its connector data management. Optionally, the Dataspace Connector GUI can be used. Jaeger can be connected for displaying collected OpenTelemetry data. For the integration of IDS-Apps into the connector infrastructure, Portainer can be used to load IDS-Apps from an IDS-AppStore-Registry and manage them in the infrastructure. The actual data can be located both locally and externally. External IDS-Ecosystem components can be reached via IDS-Messages.\n\n![Container Overview](docs/assets/images/container-overview.jpg)\n\n## IDS Ready \u0026 IDS Sandbox\n\nThe Dataspace Connector is IDS ready and approved for IDS graduation scheme.\n\n\u003ca href=\"https://internationaldataspaces.org/ids-ready-open-source-software-dataspace-connector-enables-sovereign-data-exchange/\" target=\"_blank\"\u003e\u003cimg alt=\"IDS Ready\" height=\"200\" src=\"docs/assets/images/ids_ready_logo.jpg\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/International-Data-Spaces-Association/idsa/blob/main/graduation_scheme/Projects.md\" target=\"_blank\"\u003e\u003cimg alt=\"IDS Sandbox\" src=\"docs/assets/images/ids_sandbox.png\"/\u003e\u003c/a\u003e\n\n## Contributing\n\nYou are very welcome to contribute to this project when you find a bug, want to suggest an\nimprovement, or have an idea for a useful feature. Please find a set of guidelines at the\n[CONTRIBUTING.md](CONTRIBUTING.md) and the [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).\n\n**This project is currently no longer maintained but looking for new maintainers.**\n\nApplications for maintainers shall be directed to the [International Data Spaces Association](mailto:info@internationaldataspaces.org).\n\nThis project was previously maintained by Fraunhofer ISST and after that by sovity GmbH.\nPlease do not approach former maintainers. If you have questions, plase open an issue / discussion for the community or approach the [International Data Spaces Association](mailto:info@internationaldataspaces.org).\n\nFormer maintainer, developer and contributer:\n\n* [Sebastian Opriel](https://github.com/SebastianOpriel), [sovity GmbH](http://sovity.de)\n* [Tim Berthold](https://github.com/tmberthold), [sovity GmbH](http://sovity.de)\n* [Omar Silva](https://github.com/omarsilva1), [sovity GmbH](http://sovity.de)\n* [Heinrich Pettenpohl](https://github.com/HeinrichPet), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html), project manager\n* [Julia Pampus](https://github.com/juliapampus), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html), lead developer\n* [Brian-Frederik Jahnke](https://github.com/brianjahnke), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Ronja Quensel](https://github.com/ronjaquensel), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Erik van den Akker](https://github.com/vdakker), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Fabian Bruckner](https://github.com/fabianbruckner), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Gökhan Kahriman](https://github.com/goekhanKahriman), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Haydar Qarawlus](https://github.com/hqarawlus), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Johannes Pieperbeck](https://github.com/jpieperbeck), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Michael Lux](https://github.com/milux), [Fraunhofer AISEC](https://www.aisec.fraunhofer.de/en.html)\n* [René Brinkhege](https://github.com/renebrinkhege), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n* [Steffen Biehs](https://github.com/steffen-biehs), [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html)\n\n## License\nCopyright © 2020-2022 [Fraunhofer ISST](https://www.isst.fraunhofer.de/en.html).\nThis project is licensed under the Apache License 2.0 - see [here](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInternational-Data-Spaces-Association%2FDataspaceConnector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FInternational-Data-Spaces-Association%2FDataspaceConnector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInternational-Data-Spaces-Association%2FDataspaceConnector/lists"}