iSHARE Vocabulary

Semantic definitions for iSHARE Verifiable Credentials schemas

Overview Party Terms Data Rights Terms Certificate Terms Contact Terms Policy Terms Formats

Overview

This vocabulary defines the semantic meaning of terms used in iSHARE Verifiable Credentials schemas. Each term is mapped to a unique URI and includes human-readable descriptions, domain information, and semantic relationships.

The vocabulary is designed to ensure interoperability between different systems implementing iSHARE schemas and provides clear semantic definitions for all properties used in the credential contexts.

Party and Organization Terms

name
https://schemas.ishare.eu/vocab#name
Name of the party or entity
Domain: credentialSubject
registrarId
https://schemas.ishare.eu/vocab#registrarId
Identifier of the party who registered the participant. This can be any of the Party ID from id or alsoKnownAs attributes of that participant.
Domain: credentialSubject
alsoKnownAs
https://schemas.ishare.eu/vocab#alsoKnownAs
Array of registered party ids of the party with which the party is also identified
Domain: credentialSubject

Data Rights and Access Control Terms

datarightsEvidence
https://schemas.ishare.eu/vocab#datarightsEvidence
Evidence supporting data rights claims
Domain: credentialSubject
policySets
https://schemas.ishare.eu/vocab#policySets
Collection of policy sets defining data rights and access control
Domain: credentialSubject
policies
https://schemas.ishare.eu/vocab#policies
Collection of policies within a policy set
Domain: credentialSubject
rules
https://schemas.ishare.eu/vocab#rules
Collection of rules within a policy
Domain: credentialSubject
resource
https://schemas.ishare.eu/vocab#resource
The resource that the rule applies to
Domain: credentialSubject
actions
https://schemas.ishare.eu/vocab#actions
The actions that are permitted or denied on the resource
Domain: credentialSubject
effect
https://schemas.ishare.eu/vocab#effect
The effect of the rule (permit or deny)
Domain: credentialSubject
conditions
https://schemas.ishare.eu/vocab#conditions
Conditions that must be met for the rule to apply
Domain: credentialSubject
licenses
https://schemas.ishare.eu/vocab#licenses
License expressions defining usage rights
Domain: credentialSubject
allOf
https://schemas.ishare.eu/vocab#allOf
Logical AND operation requiring all conditions to be met. Semantically aligned with JSON Schema's allOf combinator (reference)
Domain: credentialSubject
anyOf
https://schemas.ishare.eu/vocab#anyOf
Logical OR operation requiring at least one condition to be met. Semantically aligned with JSON Schema's anyOf combinator (reference)
Domain: credentialSubject

Certificate and Security Terms

subjectName
https://schemas.ishare.eu/vocab#subjectName
Subject name as encoded in the X.509 certificate which corresponds with the party that is being requested from the Participant Registry
Domain: credentialSubject
certificateType
https://schemas.ishare.eu/vocab#certificateType
Type of certificate (e.g., eSEAL, eIDAS)
Domain: credentialSubject
enabledFrom
https://schemas.ishare.eu/vocab#enabledFrom
UTC timestamp which states since when certificate is valid
Domain: credentialSubject
x5c
https://schemas.ishare.eu/vocab#x5c
The base64 encoded pem format value of the certificate identified by its subject name and fingerprint
Domain: credentialSubject
x5t#s256
https://schemas.ishare.eu/vocab#x5t#s256
The SHA256 fingerprint of the certificate
Domain: credentialSubject
value
https://schemas.ishare.eu/vocab#value
Value of the assertion or credential
Domain: credentialSubject
assertion
https://schemas.ishare.eu/vocab#assertion
Value of the identity provider assertion
Domain: credentialSubject
serviceProviderPartyId
https://schemas.ishare.eu/vocab#serviceProviderPartyId
Party id of the Service Provider for which this authorization registry is selected by the Entitled Party
Domain: credentialSubject

Contact and Organization Information Terms

description
https://schemas.ishare.eu/vocab#description
A brief description of the party, service, or entity
Domain: credentialSubject
logo
https://schemas.ishare.eu/vocab#logo
URL pointing to the endpoint where company logo can be found
Domain: credentialSubject
website
https://schemas.ishare.eu/vocab#website
Website address of the party
Domain: credentialSubject
companyPhone
https://schemas.ishare.eu/vocab#companyPhone
General company phone number of the party
Domain: credentialSubject
companyEmail
https://schemas.ishare.eu/vocab#companyEmail
General company email id of the party
Domain: credentialSubject
publiclyPublishable
https://schemas.ishare.eu/vocab#publiclyPublishable
Consent to publicly publish the information contained in this object
Domain: credentialSubject
countriesOfOperation
https://schemas.ishare.eu/vocab#countriesOfOperation
An array of ISO names of the countries where the party operates
Domain: credentialSubject
sectorIndustry
https://schemas.ishare.eu/vocab#sectorIndustry
An array of GICS based sectors/industry that party serves in
Domain: credentialSubject
tags
https://schemas.ishare.eu/vocab#tags
A free text field containing keywords relevant for party
Domain: credentialSubject
resolverUrl
https://schemas.ishare.eu/vocab#resolverUrl
URL where the issuer can be resolved.
Domain: issuer
validFrom
https://schemas.ishare.eu/vocab#validFrom
Date and time from which the credential or claim is valid.
Domain: credentialSubject
validUntil
https://schemas.ishare.eu/vocab#validUntil
Date and time until which the credential or claim is valid.
Domain: credentialSubject
verificationHash
https://schemas.ishare.eu/vocab#verificationHash
Hash value used to verify an assertion or related evidence.
Domain: credentialSubject

Policy and Agreement Terms

dataspaceId
https://schemas.ishare.eu/vocab#dataspaceId
Identifier of the dataspace of which the participant is a member of
Domain: credentialSubject
frameworkId
https://schemas.ishare.eu/vocab#frameworkId
ID of the framework the compliance is claimed for
Domain: credentialSubject
title
https://schemas.ishare.eu/vocab#title
The name of the agreement, role, or entity
Domain: credentialSubject
loa
https://schemas.ishare.eu/vocab#loa
Party's level of assurance. Available values are low, substantial and high
Domain: credentialSubject
compliancyVerified
https://schemas.ishare.eu/vocab#compliancyVerified
Compliance requirements of this role has been met by party. Possible values are yes, no and not-applicable
Domain: credentialSubject
legalAdherence
https://schemas.ishare.eu/vocab#legalAdherence
Legal requirements of this role has been met by party including signing of appropriate agreements
Domain: credentialSubject
authRegistryId
https://schemas.ishare.eu/vocab#authRegistryId
The Id of the authorisation registry provider
Domain: credentialSubject
authUrl
https://schemas.ishare.eu/vocab#authUrl
The URL pointer specific to the party where authorisations can be queried/checked from
Domain: credentialSubject
capabilityUrl
https://schemas.ishare.eu/vocab#capabilityUrl
Capabilities endpoint of the party in the dataspace
Domain: credentialSubject
additionalInfo
https://schemas.ishare.eu/vocab#additionalInfo
Object which contains additional general contact information of the party
Domain: credentialSubject

Framework and Dataspace Participation Terms

frameworks
https://schemas.ishare.eu/vocab#frameworks
Array of frameworks the participant adheres to, each with its roles, agreements, certificates, and identity provider assertions
Domain: credentialSubject
dataspaces
https://schemas.ishare.eu/vocab#dataspaces
Array of dataspaces the participant takes part in, each with its rulebook, roles, and agreements
Domain: credentialSubject
roles
https://schemas.ishare.eu/vocab#roles
Array of roles held by the participant within a framework or dataspace
Domain: credentialSubject
agreements
https://schemas.ishare.eu/vocab#agreements
Array of agreements signed by the participant within a framework or dataspace
Domain: credentialSubject
version
https://schemas.ishare.eu/vocab#version
Version identifier of the framework or rulebook
Domain: credentialSubject
defUrl
https://schemas.ishare.eu/vocab#defUrl
URL pointing to the machine-readable definition of the framework or rulebook
Domain: credentialSubject
rulebook
https://schemas.ishare.eu/vocab#rulebook
The dataspace rulebook the participant adheres to, with its identifier, name, version, and reference URLs
Domain: credentialSubject
typeName
https://schemas.ishare.eu/vocab#typeName
Human-friendly display name for a role or agreement type (the machine-readable code is carried by 'type').
Domain: credentialSubject

Available Formats

This vocabulary is available in multiple formats:

Usage in JSON-LD Contexts

To use this vocabulary in your JSON-LD contexts, reference the base URI:

{
  "@context": [
    "https://www.w3.org/ns/credentials/v2",
    "https://schemas.ishare.eu/vocab"
  ]
}

Direct Term References

You can also reference individual terms directly:

{
  "@context": {
    "legalName": "https://schemas.ishare.eu/vocab#legalName",
    "dataspaceId": "https://schemas.ishare.eu/vocab#dataspaceId"
  }
}