{"id":24736362,"url":"https://github.com/engineering-research-and-development/true-connector-ui","last_synced_at":"2026-05-06T23:35:24.398Z","repository":{"id":247973720,"uuid":"819273587","full_name":"Engineering-Research-and-Development/true-connector-ui","owner":"Engineering-Research-and-Development","description":null,"archived":false,"fork":false,"pushed_at":"2024-07-17T14:53:02.000Z","size":3670,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-27T21:24:45.219Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Engineering-Research-and-Development.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-24T07:23:31.000Z","updated_at":"2024-07-17T14:52:46.000Z","dependencies_parsed_at":"2024-07-11T17:15:00.881Z","dependency_job_id":"93c1718e-d2a0-4579-a4b5-36311052ed50","html_url":"https://github.com/Engineering-Research-and-Development/true-connector-ui","commit_stats":null,"previous_names":["engineering-research-and-development/true-connector-ui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Engineering-Research-and-Development%2Ftrue-connector-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Engineering-Research-and-Development%2Ftrue-connector-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Engineering-Research-and-Development%2Ftrue-connector-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Engineering-Research-and-Development%2Ftrue-connector-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Engineering-Research-and-Development","download_url":"https://codeload.github.com/Engineering-Research-and-Development/true-connector-ui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244992508,"owners_count":20543827,"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":"2025-01-27T21:24:52.154Z","updated_at":"2026-05-06T23:35:19.377Z","avatar_url":"https://github.com/Engineering-Research-and-Development.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TRUE Connector UI Application\n\n[![License: AGPL](https://img.shields.io/github/license/Engineering-Research-and-Development/true-connector-execution_core_container.svg)](https://opensource.org/licenses/AGPL-3.0)\n[![Docker badge](https://img.shields.io/docker/pulls/rdlabengpa/ids_true_connector_ui.svg)](https://hub.docker.com/r/rdlabengpa/ids_true_connector_ui)\n\u003cbr/\u003e\n\n![](https://github.com/Engineering-Research-and-Development/true-connector/raw/main/doc/TRUE_Connector_Logo.png?raw=true)\n\n\u003c/br\u003e\u003c/br\u003e\n\n\u003ch1\u003e\nTRUE ('TRU'sted 'E'ngineering) Connector UI for the IDS (International Data Space) ecosystem \n\u003c/h1\u003e\n\nThe TRUE Connector UI is a frontend application developed by Engineering, a leading digital transformation company based in Italy. This UI application is part of the TRUE Connector suite, designed to enable self-determined data sharing while ensuring compliance with regulations such as GDPR. The application provides user-friendly interfaces for managing self description, policies, and contract negotiations within the IDS ecosystem.\n\n## Features\n\n- **Self Description Management**: View, and update self descriptions data of connector, such are offered resources, contract offers, and representations.\n- **Policies Management**: View or delete usage policies for data resources.\n- **Contract Negotiation**: Engage in contract negotiations for data sharing between provider and consumer.\n- **Multi-Account Support**: Seamlessly switch between provider and consumer roles within the application.\n- **Connector configuration**: Overview of connector configuration details previosly setup in `application.properties` of ECC, DataApp and UCApp.\n\n## Current implement features\n\n- **Self Description Management**: View self descriptions data of connector, such are offered resources, contract offers, and representations.\n- **Policies Management**: /\n- **Contract Negotiation**: Getting the artifact without usage of UCApp (no full contact negotiation flow)\n- **Multi-Account Support**: Seamlessly switch between provider and consumer roles within the application.\n- **Connector configuration**: Overview of connector configuration details previosly setup in `application.properties` of ECC, DataApp and UCApp.\n\n## User manual\n\nFor comprehensive instructions and visual guides, please refer to the [User Manual](/doc/TRUE_Connector_UI_user_manual.pdf). This document includes detailed explanations and UI screenshots to help you effectively navigate and utilize all the application's features.\n\n## Prerequisites\n\n- `Node.js` and `npm`\n- `Angular CLI`\n\n## Installation\n\n1. **Clone the repository:**\n\n   ```\n   git clone https://github.com/Engineering-Research-and-Development/true-connector-ui.git\n   cd true-connector-ui\n   ```\n\n2. **Install dependencies:**\n\n   ```\n   npm install\n   ```\n\n3. **Environment Configuration:**\n   Create a `.env` file in the root directory and set the necessary environment variables. Example:\n\n   ```\n   SELF_DESCRIPTION_URL: 'https://......',\n   PROXY_ENDPOINT_URL: 'https://......',\n   SELF_DESCRIPTION_API: 'https://......',\n   CONTRACT_OFFER_API: 'https://......',\n   OFFERED_RESOURCE_API: 'https://......',\n   REPRESENTATION_API: 'https://......',\n   MULTIPART_TYPE: 'form',\n   FORWARD_TO: 'https://......',\n   ```\n\n   The TRUE Connector UI displays configuration details for other components of the TRUE Connector, such as ECC, DA, and UC. To enable these details to be shown, you can use the following environment variables:\n\n   ```\n   TC_DATA_APP_ENDPOINT\n   TC_MULTIPART_EDGE\n   TC_MULTIPART_ECC\n   TC_CONNECTOR_ID\n   TC_IDSCP2\n   TC_WS_EDGE\n   TC_WS_ECC\n   TC_UC_DATAAPP_URI\n   TC_BROKER_URL\n   TC_CACHE_TOKEN\n   TC_FETCH_TOKEN_ON_STARTUP\n   TC_ECC_KEYSTORE_NAME\n   TC_ECC_KEY_PASSWORD\n   TC_ECC_KEYSTORE_PASSWORD\n   TC_ECC_ALIAS\n   TC_DAPS_KEYSTORE_NAME\n   TC_DAPS_KEYSTORE_PASSWORD\n   TC_DAPS_KEYSTORE_ALIAS\n   TC_ECC_TRUSTORE_NAME\n   TC_ECC_TRUSTORE_PASSWORD\n   TC_ECC_FIREWALL\n   TC_AES256_SECRET_KEY\n   TC_DA_KEYSTORE_NAME\n   TC_DA_KEY_PASSWORD\n   TC_DA_KEYSTORE_PASSWORD\n   TC_DA_ALIAS\n   TC_EXTRACT_PAYLOAD_FROM_RESPONSE\n   TC_ISSUER_CONNECTOR_URI\n   TC_DA_FIREWALL\n   TC_VALIDATE_SELF_DESCRIPTION\n\n   ```\n\n4. **Run the application:**\n\n   ```\n   ng serve\n   ```\n\n   The application will be available at `http://localhost:4200`.\n\n## Docker Deployment\n\nTo run the UI application using Docker Compose, follow these steps:\n\n1. **Build the Docker image:**\n\n   ```\n   docker build -t true-connector-ui .\n   ```\n\n2. **Run Docker Compose:**\n   Ensure your `docker-compose.yml` is correctly configured with environment variables for the UI application. Example:\n\n   ```\n   version: \"3.7\"\n   services:\n     ui:\n       image: true-connector-ui\n       environment:\n         - SELF_DESCRIPTION_URL: \"https://......\"\n         - ....\n         - ....\n       ports:\n         - \"4200:80\"\n   ```\n\n   Then start the services:\n\n   ```sh\n   docker-compose up\n   ```\n\n   The application will be available at `http://localhost:4200`.\n\n### SSL Deployment with Docker\n\n1. If you want to have both HTTP and HTTPS instances, keep **nginx.conf** file unchanged:\n\n```\n  events {\n  worker_connections 1024;\n}\n\nhttp {\n  include /etc/nginx/mime.types;\n  server {\n    listen 80;\n    server_name localhost;\n\n    root /usr/share/nginx/html/browser;\n    index index.html index.htm;\n\n    location / {\n      try_files $uri $uri/ /index.html;\n    }\n\n    # Redirect all HTTP traffic to HTTPS\n    # Use in case that you want only HTTPS communication\n    # Uncomment out the following lines to allow both HTTP and HTTPS\n    # if ($scheme = http) {\n    #   return 301 https://$server_name$request_uri;\n    # }\n  }\n\n  server {\n    listen 443 ssl;\n    server_name localhost;\n\n    ssl_certificate /etc/nginx/ssl/{CERT_NAME}.crt;\n    ssl_certificate_key /etc/nginx/ssl/{CERT_NAME}.key;\n\n    root /usr/share/nginx/html/browser;\n    index index.html index.htm;\n\n    location / {\n      try_files $uri $uri/ /index.html;\n    }\n  }\n\n```\n\n2. **Update Docker Compose:**\n   Modify your `docker-compose.yml` to include the Nginx configuration and SSL certificates. Example:\n\n```\n   version: \"3.7\"\n   services:\n     ui:\n       image: true-connector-ui\n       environment:\n         - SELF_DESCRIPTION_URL: \"https://......\"\n         - ....\n         - ....\n       ports:\n         - \"4200:80\"\n         - \"4201:443\"\n       volumes:\n         - ./nginx.conf:/etc/nginx/nginx.conf\n         - ./{PATH_TO_CERTS}:/etc/nginx/ssl\n```\n\nEnsure you have your SSL certificates (`{CERT_NAME}.crt` and `{CERT_NAME}.key`) in the `./{PATH_TO_CERTS}` directory.\n\n3. **Start the Services:**\n\n```\n   docker-compose up\n```\n\nThe application will be available at both `http://localhost:4200 (HTTP)` and `https://localhost:4201 (HTTPS)`.\n\n## Usage\n\n### Self Description Management\n\nChoose Self Description Management section from side menu to view self description data, and update it if needed. You can add new offered resources, contract offers or representations, update existing ones, and ensure all necessary metadata is correctly specified.\n\n### Policies Management\n\nIn the Policies Management section, you can view or delete usage policies for your data resources. These policies ensure that data sharing complies with regulations and agreements.\n\n### Contract Negotiation\n\nThe Contract Negotiation feature allows providers and consumers to engage in secure and compliant contract negotiations. This ensures that all data exchanges are legally binding and transparent.\n\n## Contributing\n\nWe welcome contributions to the TRUE Connector UI application. Please follow these steps to contribute:\n\n1. **Fork the repository:**\n\n   ```sh\n   git fork https://github.com/Engineering-Research-and-Development/true-connector-ui.git\n   ```\n\n2. **Create a feature branch:**\n\n   ```sh\n   git checkout -b feature/your-feature-name\n   ```\n\n3. **Commit your changes:**\n\n   ```sh\n   git commit -m \"Add your feature description\"\n   ```\n\n4. **Push to the branch:**\n\n   ```sh\n   git push origin feature/your-feature-name\n   ```\n\n5. **Open a pull request:**\n   Go to the repository on GitHub and open a pull request to the `develop` branch.\n\n## License\n\nThis project is licensed under the AGPL-3.0 License. See the [LICENSE](LICENSE) file for details.\n\n## More information\n\nFor further information, visit our [documentation](https://engineering-ing-inf-rd.gitbook.io/true-connector/) or contact the support team at trueconnector-team@eng.it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineering-research-and-development%2Ftrue-connector-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fengineering-research-and-development%2Ftrue-connector-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengineering-research-and-development%2Ftrue-connector-ui/lists"}