From d834f608b0c2cda42845f4f1e2eecbfa5e86a73d Mon Sep 17 00:00:00 2001 From: mk Date: Fri, 19 Jan 2024 16:28:56 +0100 Subject: [PATCH] chore(concept):[#322] remove html links in toc --- ...oning-of-contractAgreementId-for-assets.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/docs/concept/#322-Provisioning-of-contractAgreementId-for-assets/#322-Provisioning-of-contractAgreementId-for-assets.md b/docs/concept/#322-Provisioning-of-contractAgreementId-for-assets/#322-Provisioning-of-contractAgreementId-for-assets.md index 384eb6d89c..9712b8d700 100644 --- a/docs/concept/#322-Provisioning-of-contractAgreementId-for-assets/#322-Provisioning-of-contractAgreementId-for-assets.md +++ b/docs/concept/#322-Provisioning-of-contractAgreementId-for-assets/#322-Provisioning-of-contractAgreementId-for-assets.md @@ -10,17 +10,17 @@ # Table of Contents 1. [Overview](#overview) 2. [Summary](#summary) -3. [Problem Statement](#statement) +3. [Problem Statement](#problem-statement) 4. [Requirements](#requirements) 5. [NFR](#nfr) -6. [Out of scope](#outofscope) +6. [Out of scope](#out-of-scope) 7. [Assumptions](#assumptions) 8. [Concept](#concept) 9. [Glossary](#glossary) 10. [References](#references) -# Overview +# Overview The exchange of assets via the EDC takes place after a successful contract negotiation in which it is checked whether the consumer has authorized access to the data asset. This access is automatically checked by the EDC via so-called AccessPolicies. The consumer is only granted access to the data after a successful check. During contract negotiation the edc stores audits to the artefacts edc:ContractAgreement and edc:ContractNegotiation. These audit information can be requested over the edc management API. @@ -28,28 +28,28 @@ To request the mentioned artefacts over the management API the ContractAgreement This specific id must therefore be stored and linked for the exchanged asset in order to be able to determine the corresponding contract agreement later on. -# Summary +# Summary This feature is responsible for collecting the CIDs of EDC contract negotiations regarding during in the IRS processing. The CIDs are provided in the IRS JobResponse document for collected assets. For shells and submodels CIDs are collected and provided. In case of a usage policy mismatch. The irs policy store does not provide the usage policy of the asset. This circumstance is reported in a tombstone which contains the policy of the asset. -# Problem Statement +# Problem Statement 1. The ContractAgreementDto:@id is currently not delivered via the IRS response, so business apps that use the IRS cannot access the corresponding ContractAggreement under which the assets, delivered by the IRS, were exchanged. 2. The EDC management api does not provide any endpoint to query a contract agreement using an asset id. 3. Business apps must make the contract agreements under which the assets were exchanged available for audit purposes. -# Requirements +# Requirements 1. [ ] Provisioning of ContractAgreementDto:@id via IRS JobReponse for AAS retrieved via EDC. 2. [ ] Provisioning of ContractAgreementDto:@id via IRS JobReponse for submodels retrieved via EDC. 3. [ ] API parameter SHOULD control whether ContractAgreementDto:@id should be returned via the IRSJobResponse -# NFR +# NFR -# Out of scope +# Out of scope -# Assumptions +# Assumptions > - [x] Business app (Trace-X) has access to the management API of the IRS EDC Consumer. - [x] EDC Management API of EDC Consumer is configured as a parameter in Business app (Trace-X). IRS does not provide API url to EDC Management API via JobResponse. - [x] In case there os no valid negotation including contract agreement policy of catalog offer will be collected inside IRS flow and provided to irs requestor. @@ -71,7 +71,6 @@ In case of a usage policy mismatch. The irs policy store does not provide the us - parameter impacts: enables collection of ContractAgreementId in job processing and provides this information in submodelContainers and ShellContainers as well in Tombstone in case policy does not match or other internal error during EDC communication. - ## 1. Case 1: Successful contract negotiation IRS proceed EDC contract negotiation succeeds.