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

verificationHash

https://schemas.ishare.eu/vocab#verificationHash

The calculated hash of the agreement file that has been uploaded. The verificationHash must be calculated using the SHA256 hashing algorithm.

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

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

agreementId

https://schemas.ishare.eu/vocab#agreementId

ID that refers to the agreement

Domain: credentialSubject

agreementType

https://schemas.ishare.eu/vocab#agreementType

Descriptive type of the agreement. Framework or dataspace may define agreement types

Domain: credentialSubject

roleId

https://schemas.ishare.eu/vocab#roleId

Name of the role as defined by the framework or dataspace

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

Available Formats

This vocabulary is available in multiple formats:

JSON-LD: vocab.jsonld - Machine-readable format for web applications
Turtle: vocab.ttl - RDF format for semantic web applications
HTML: index.html - Human-readable documentation (this page)

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"
  }
}