Blockcerts 2.0 Assertion schema. Extends Open Badges v2.0 schema: https://w3id.org/openbadges#Assertion
The schema defines the following properties:
Defined by id
property in https://w3id.org/openbadges#Assertion. This may be an HTTP IRI, but only if the issuer plans to host the assertions on a long-term basis, or (at least) until their expiration. Otherwise it is recommended to use a urn:uuid:<UUID>
-formatted IRI.
Defined by type
property of https://w3id.org/openbadges#Assertion
Defined by recipient
property of https://w3id.org/openbadges#Assertion, with Blockcerts extensions for recipient proof of ownership.
Defined by badge
property of https://w3id.org/openbadges#Assertion, with Blockcerts extensions for (display) signature images.
Defined by verification
property of https://w3id.org/openbadges#Assertion, with Blockcerts extensions for verification of badges on a blockchain.
Defined by issuedOn
property of https://w3id.org/openbadges#Assertion
Defined by image
property of https://w3id.org/openbadges#Assertion
Defined by evidence
property of https://w3id.org/openbadges#Assertion
Defined by narrative
property of https://w3id.org/openbadges#Assertion
Defined by expires
property of https://w3id.org/openbadges#Assertion
The schema defines the following additional types:
A link to a valid JSON-LD context, or array of JSON-LD contexts
This property must be one of the following types:
string
array
A type or an array of types defined in a referenced JSON-LD context.
This property must be one of the following types:
string
array
Open Badges must express timestamps as strings compatible with ISO 8601 guidelines, including the time and a time zone indicator. It is recommended to publish all timestamps in UTC. Previous versions of Open Badges allowed Unix timestamps as integers. Open Badges v2.0 requires string ISO 8601 values with time zone indicators. For example, 2016-12-31T23:59:59+00:00 is a valid ISO 8601 timestamp. It contains the year, month, day, T separator, hour number 0-23, minute, optional seconds and decimal microsecond, and a time zone indicator (+/- an offset from UTC or the Z designator for UTC).
Open Badges SHA-256 Hash
From https://w3id.org/openbadges#IdentityObject.
Properties of the IdentityObject
object:
Defined by identity
property of https://w3id.org/openbadges#IdentityObject
The object must be one of the following types:
HashString
undefined
Defined by type
property of https://w3id.org/openbadges#IdentityObject
This element must be one of the following enum values:
email
Defined by hashed
property of https://w3id.org/openbadges#IdentityObject
Defined by salt
property of https://w3id.org/openbadges#IdentityObject
From https://w3id.org/openbadges#VerificationObject, with extensions for Blockcerts verification
Properties of the VerificationObject
object:
Defined by type
property of https://w3id.org/openbadges#VerificationObject. Blockcerts extension: this should contain the entry MerkleProofVerification2017
Blockcerts extension: the expected blockchain address for the signer of the transaction containing the merkle proof. In Blockcerts publicKey
s are typically represented with a <scheme>:
prefix. For Bitcoin transactions, this would be the issuer public Bitcoin address prefixed with ecdsa-koblitz-pubkey:
; e.g. ecdsa-koblitz-pubkey:14RZvYazz9H2DC2skBfpPVxax54g4yabxe
An image representative of the entity. In Blockcerts this is typically a data URI (https://en.wikipedia.org/wiki/Data_URI_scheme) embedded as a base-64 encoded PNG image, but it may also be a URI where the image may be found.
From https://w3id.org/openbadges#AlignmentObject
Properties of the AlignmentObject
object:
Defined by targetName
property of https://w3id.org/openbadges#AlignmentObject
Defined by targetUrl
property of https://w3id.org/openbadges#AlignmentObject
Defined by targetDescription
property of https://w3id.org/openbadges#AlignmentObject
List of objects describing which objectives or educational standards this badge aligns to, if any.
List of tags that describe the type of achievement.
From https://w3id.org/openbadges#BadgeClass
Properties of the BadgeClass
object:
Defined by id
property of https://w3id.org/openbadges#BadgeClass. This field is now required in V2. This may be an HTTP IRI, but only if the issuer plans to host the BadgeClass definitions on a long-term basis, or (at least) until expiration of certificates referencing this BadgeClass. Otherwise it is recommended to use a urn:uuid:<UUID>
-formatted IRI.
Defined by type
property of https://w3id.org/openbadges#BadgeClass
Defined by name
property of https://w3id.org/openbadges#BadgeClass
Blockcerts extension: optional subtitle of the certificate
Defined by description
property of https://w3id.org/openbadges#BadgeClass
Defined by image
property of https://w3id.org/openbadges#BadgeClass
Defined by criteria
property of https://w3id.org/openbadges#BadgeClass. This field is required in Open Badges. If migrating from an earlier version, a quick change is to reuse the description
field
Defined by issuer
property of https://w3id.org/openbadges#BadgeClass, with Blockcerts extensions for blockchain verification of badges.
Defined by alignment
property of https://w3id.org/openbadges#BadgeClass
Defined by tags
property of https://w3id.org/openbadges#BadgeClass
Blockcerts extension: array of signature lines for display.
Defined by https://w3id.org/openbadges#Profile. This type is used in certificates, and in the issuer-hosted identification page. The minimal set of properties required in the certificate are id
and type
. In this case, additional issuer-identification properties are assumed to be available at the issuer-hosted identification page.
Defined by id
property of https://w3id.org/openbadges#Profile
Defined by type
property of https://w3id.org/openbadges#Profile
Defined by name
property of https://w3id.org/openbadges#Profile
Defined by url
property of https://w3id.org/openbadges#Profile
Defined by telephone
property of https://w3id.org/openbadges#Profile
Defined by description
property of https://w3id.org/openbadges#Profile
Defined by image
property of https://w3id.org/openbadges#Profile
Defined by email
property of https://w3id.org/openbadges#Profile
Defined by revocationList
property of https://w3id.org/openbadges#Profile. If embedded in a Blockcert and the issuer-hosted Profile, the value in the Blockcert should take preference.