Testbed

This document describes a testbed for checking conformance of the (Knowledge) Agents KIT (=Keep It Together).

For more information see

• Our Adoption guideline
• The Architecture documentation
• The EDC Deployment description
• The (Data/Function) Provider Deployment description
• The AAS Bridge Deployment description
• The Conformity testbed
• A Data Sovereignity & Graph Policy discussion

Test Scripts

The CAB (Conformity Assessment Body) may use a set of predefined API interactions to run against its own dataspace tenant or let the assessed party run these scripts depending on the assessment method. The scripts are hierarchically organized and can be found under this Postman Collection or online under https://elements.getpostman.com/redirect?entityId=2757771-0ad1b7a6-734c-4289-9221-667fc56a21da&entityType=collection. For the URLs and identities of the CAB or the CAP (Conformity Assessment Party), the appropriate environment variables have to be set.

The scripts are organised as follows:

• 01_TESTASSETS - asset descriptions, policies and contract definitions to be deployed both at the CAB as well as the CAP EDC (Control Plane), see below
• 02_ALL - scripts which need to be run at all CAPs
  • 0201_EDC_CONTROL_PLANE - scripts to be run against control plane (transfer check)
  • 0202_EDC_DATA_PLANE - scripts to be run against the data plane (callback and proxying)
  • 0203_MATCHMAKING_AGENT - scripts to be run against the matchmaking agent
  • 0204_FEDERATED_DATA_CATALOGUE - scripts checking the state of the federated data catalogue
• 03_PROVIDER - scripts which need to run at Provider CAPs
  • 0301_PROVIDER_DATA - scripts to be run at Data Provider CAPs
    • 030101_PROVIDER_DATA_SPARQL - scripts to be run against Data Provider Agents
  • 0302_PROVIDER_FUNCTION - scripts to be run at Function Provider CAPs
    • 030201_PROVIDER_FUNCTION_SPARQL - scripts to be run against Function Provider Agents
• 04_CONSUMER - scripts to be run against Consumer CAPs
  • 0401_CONSUMER_APPLICATION - scripts to be run against a KA-enabled Application
    • 040101_CONSUMER_APPLICATION_SPARQL - scripts to be run against a SPARQL-speaking Application
• 05_CORE - scripts to be run against a Core Service CAP
  • 0501_CORE_ONTOLOGY - scripts to be run against the Ontology Hosting Capability of the Core Service CAP
    • 050101_CORE_ONTOLOGY_MANAGEMENT - scripts to be run against the Ontology Hosting Capability for management
    • 050102_CORE_ONTOLOGY_EDITOR - scripts to be run against the Ontology Hosting Capability for editing

Test Policies and Contract Definitions

The CAB may use the following Policy Definitions and Contract Definitions in its assessment method. The CAB may deploy these objects in its own dataspace tenant or let the assessed party deploy these objects depending on the assessment method.

Open Policy

{
    "@context": {
        "odrl": "http://www.w3.org/ns/odrl/2/",
        "cx-common": "https://w3id.org/catenax/ontology/common#"
    },
    "@type": "PolicyDefinitionRequestDto",
    "@id": "Policy?cab=Asset&mode=open",
    "policy": {
  "@type": "Policy",
  "odrl:permission" : [{
   "odrl:action" : "USE",
   "odrl:constraint" : []
  }]
    }
}

Closed Policy

{
    "@context": {
        "odrl": "http://www.w3.org/ns/odrl/2/",
        "cx-common": "https://w3id.org/catenax/ontology/common#"
    },
    "@type": "PolicyDefinitionRequestDto",
    "@id": "Policy?cab=Asset&mode=closed",
    "policy": {
  "@type": "Policy",
  "odrl:permission" : [{
   "odrl:action" : "USE",
   "odrl:constraint" : {
    "@type" : "Constraint",
    "odrl:leftOperand" : "BusinessPartnerNumber",
     "odrl:operator" : {
                        "@id": "odrl:eq"
                    },
    "odrl:rightOperand" : "{{cabBPNL}}"
   }
  }]
    }
}

Open Contract Definition

{
    "@context": {
         "cx-common": "https://w3id.org/catenax/ontology/common#"
    },
    "@id": "Contract?cab=Asset&mode=open",
    "@type": "ContractDefinition",
    "accessPolicyId": "Policy?cab=Asset&mode=open",
    "contractPolicyId": "Policy?cab=Asset&mode=open",
    "assetsSelector" : {
        "@type" : "CriterionDto",
        "operandLeft": "https://w3id.org/catenax/ontology/common#publishedUnderContract",
        "operator": "=",
        "operandRight": "Contract?cab=Asset&mode=open"
    }
}

Closed Contract Definition

{
    "@context": {
         "cx-common": "https://w3id.org/catenax/ontology/common#"
    },
    "@id": "Contract?cab=Asset&mode=closed",
    "@type": "ContractDefinition",
    "accessPolicyId": "Policy?cab=Asset&mode=closed",
    "contractPolicyId": "Policy?cab=Asset&mode=closed",
    "assetsSelector" : {
        "@type" : "CriterionDto",
        "operandLeft": "https://w3id.org/catenax/ontology/common#publishedUnderContract",
        "operator": "=",
        "operandRight": "Contract?cab=Asset&mode=closed"
    }
}

Test Graph Assets

The CAB may use the following Graph Asset Descriptions (referring to the contract definitions in the last section) in its assessment method. The CAB may deploy these objects in its own dataspace tenant or let the assessed party deploy these objects depending on the assessment method.

Open Graph Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "xsd": "http://www.w3.org/2001/XMLSchema#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "GraphAsset?cab=Conforming&mode=open", 
        "properties": {
            "name": "Open Conforming Asset.",
            "description": "A graph asset/offering hosting a conforming agent for testing and conformity checking.",
            "version": "1.11.16",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Asset&mode=open",
            "rdf:type": "cx-common:GraphAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/common>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SPARQL",
            "sh:shapesGraph": "@prefix : <GraphAsset?cab=Conforming&mode=open#> .\n",
            "cx-common:isFederated": "true^^xsd:boolean"
        }
    },
    "dataAddress": {
        "id": "GraphAsset?cab=Conforming&mode=open", 
        "@type": "DataAddress",
        "baseUrl": "{{cabConformingAgent}}/bind",
        "type": "cx-common:Protocol?w3c:http:SPARQL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

Closed Graph Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "xsd": "http://www.w3.org/2001/XMLSchema#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "GraphAsset?cab=Conforming&mode=closed", 
        "properties": {
            "name": "Closed Conforming Asset.",
            "description": "A graph asset/offering hosting a conforming agent for testing and conformity checking.",
            "version": "1.11.16",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Asset&mode=closed",
            "rdf:type": "cx-common:GraphAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/common>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SPARQL",
            "sh:shapesGraph": "@prefix : <GraphAsset?cab=Conforming&mode=closed#> .\n",
            "cx-common:isFederated": "true^^xsd:boolean"
        }
    },
    "dataAddress": {
        "id": "GraphAsset?cab=Conforming&mode=closed", 
        "@type": "DataAddress",
        "baseUrl": "{{cabConformingAgent}}/bind",
        "type": "cx-common:Protocol?w3c:http:SPARQL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

Unfederated Graph Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "xsd": "http://www.w3.org/2001/XMLSchema#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "GraphAsset?cab=Conforming&mode=unfederated", 
        "properties": {
            "name": "Unfederated Conforming Asset.",
            "description": "A graph asset/offering hosting a conforming agent for testing and conformity checking.",
            "version": "1.11.16",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Graph&mode=open",
            "rdf:type": "cx-common:GraphAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/common>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SPARQL",
            "sh:shapesGraph": "@prefix : <GraphAsset?cab=Conforming&mode=unfederated#> .\n",
            "cx-common:isFederated": "false^^xsd:boolean"
        }
    },
    "dataAddress": {
        "id": "GraphAsset?cab=Conforming&mode=unfederated", 
        "@type": "DataAddress",
        "baseUrl": "{{cabConformingAgent}}/bind",
        "type": "cx-common:Protocol?w3c:http:SPARQL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

Test Skill Assets

The CAB may use the following Skill Asset Descriptions (referring to the contract definitions in the last section) in its assessment method. The CAB may deploy these objects in its own dataspace tenant or let the assessed party deploy these objects depending on the assessment method.

Open Skill Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "SkillAsset?cab=Conforming&mode=open", 
        "properties": {
            "name": "Open Skill",
            "description": "A conformity assessment skill.",
            "version": "1.11.16",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Asset&mode=open",
            "rdf:type": "cx-common:SkillAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/core>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SKILL",
            "cx-common:distributionMode": "cx-common:SkillDistribution?run=all",
            "cx-common:isFederated": "true^^xsd:boolean"
        },
        "privateProperties": {
            "cx-common:query":"# Sample Skill accessing a graph\n\nSELECT ?subject ?predicate ?object WHERE { \n    SERVICE <edcs://knowledge.dev.demo.catena-x.net/oem-edc-control/BPNL00000003COJN> {\n        GRAPH <GraphAsset?cab=Conforming&mode=open> { \n            ?subject ?predicate ?object. \n        }\n    } \n}"
        }
    },
    "dataAddress": {
        "id":"SkillAsset?cab=Conforming&mode=open",
        "@type": "DataAddress",
        "type": "cx-common:Protocol?w3c:http:SKILL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

Closed Skill Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "SkillAsset?cab=Conforming&mode=closed", 
        "properties": {
            "name": "Closed Skill",
            "description": "A conformity assessment skill.",
            "version": "1.11.16",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Asset&mode=closed",
            "rdf:type": "cx-common:SkillAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/core>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SKILL",
            "cx-common:distributionMode": "cx-common:SkillDistribution?run=all",
            "cx-common:isFederated": "false^^xsd:boolean"
        },
        "privateProperties": {
            "cx-common:query":"# Sample Skill accessing a graph\n\nSELECT ?subject ?predicate ?object WHERE { \n    SERVICE <edcs://knowledge.dev.demo.catena-x.net/oem-edc-control/BPNL00000003COJN> {\n        GRAPH <GraphAsset?cab=Conforming&mode=closed> { \n            ?subject ?predicate ?object. \n        }\n    } \n}"
        }
    },
    "dataAddress": {
        "id":"SkillAsset?cab=Conforming&mode=closed",
        "@type": "DataAddress",
        "type": "cx-common:Protocol?w3c:http:SKILL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

Provider Skill Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "SkillAsset?cab=Conforming&mode=provider", 
        "properties": {
            "name": "Provider-Forced Skill",
            "description": "A conformity assessment skill.",
            "version": "1.11.16",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Asset&mode=open",
            "rdf:type": "cx-common:SkillAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/core>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SKILL",
            "cx-common:distributionMode": "cx-common:SkillDistribution?run=provider",
            "cx-common:isFederated": "true^^xsd:boolean"
        },
        "privateProperties": {
            "cx-common:query":"# Sample Skill accessing a graph\n\nSELECT ?subject ?predicate ?object WHERE { \n    SERVICE <edcs://knowledge.dev.demo.catena-x.net/oem-edc-control/BPNL00000003COJN> {\n        GRAPH <GraphAsset?cab=Conforming&mode=open> { \n            ?subject ?predicate ?object. \n        }\n    } \n}"
        }
    },
    "dataAddress": {
        "id":"SkillAsset?cab=Conforming&mode=provider",
        "@type": "DataAddress",
        "type": "cx-common:Protocol?w3c:http:SKILL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

Consumer Skill Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "SkillAsset?cab=Conforming&mode=consumer", 
        "properties": {
            "name": "Consumer-Forced Skill",
            "description": "A conformity assessment skill.",
            "version": "1.11.16",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Asset&mode=open",
            "rdf:type": "cx-common:SkillAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/core>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SKILL",
            "cx-common:distributionMode": "cx-common:SkillDistribution?run=consumer",
            "cx-common:isFederated": "true^^xsd:boolean"
        },
        "privateProperties": {
            "cx-common:query":"# Sample Skill accessing a graph\n\nSELECT ?subject ?predicate ?object WHERE { \n    SERVICE <edcs://knowledge.dev.demo.catena-x.net/oem-edc-control/BPNL00000003COJN> {\n        GRAPH <GraphAsset?cab=Conforming&mode=open> { \n            ?subject ?predicate ?object. \n        }\n    } \n}"
        }
    },
    "dataAddress": {
        "id":"SkillAsset?cab=Conforming&mode=consumer",
        "@type": "DataAddress",
        "type": "cx-common:Protocol?w3c:http:SKILL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

Unfederated Skill Asset

{
    "@context": {
        "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
        "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
        "cx-common": "https://w3id.org/catenax/ontology/common#",
        "sh": "http://www.w3.org/ns/shacl#"
    },
    "asset": {
        "@type": "Asset",
        "@id": "SkillAsset?cab=Conforming&mode=unfederated", 
        "properties": {
            "name": "Unfederated Skill",
            "description": "A conformity assessment skill.",
            "version": "1.9.4-SNAPSHOT",
            "contenttype": "application/json, application/xml",
            "cx-common:publishedUnderContract": "Contract?cab=Asset&mode=open",
            "rdf:type": "cx-common:SkillAsset",
            "rdfs:isDefinedBy": "<https://w3id.org/catenax/ontology/core>",
            "cx-common:implementsProtocol": "cx-common:Protocol?w3c:http:SKILL",
            "cx-common:distributionMode": "cx-common:SkillDistribution?run=all",
            "cx-common:isFederated": "false^^xsd:boolean"
        },
        "privateProperties": {
            "cx-common:query":"# Sample Skill accessing a graph\n\nSELECT ?subject ?predicate ?object WHERE { \n    SERVICE <edcs://knowledge.dev.demo.catena-x.net/oem-edc-control/BPNL00000003COJN> {\n        GRAPH <GraphAsset?cab=Conforming&mode=open> { \n            ?subject ?predicate ?object. \n        }\n    } \n}"
        }
    },
    "dataAddress": {
        "id":"SkillAsset?cab=Conforming&mode=unfederated",
        "@type": "DataAddress",
        "type": "cx-common:Protocol?w3c:http:SKILL",
        "proxyPath": "false",
        "proxyMethod": "true",
        "proxyQueryParams": "true",
        "proxyBody": "true"
    }
}

_{^{(C) 2021,2023 Contributors to the Eclipse Foundation. SPDX-License-Identifier: CC-BY-4.0}}