Data Model

A certificate is a tamper-proof and verifiable collection of data that represents a process, a file/document, an accomplishment or any activity that can benefit from the immutability and authenticity. Thanks to certificates, it allows you to assure any fact in your business case recording the information along with parameters that everyone can verify (e.g. signatures, issuance/expiration time, network evidences, etc..). Every certificate is identified by a unique ID and is composed of three complementary but different parts: Data, Metadata and Access.

Data

Data contains the immutable information about the certificate: who issued it, when it was issued, when it will expire and of course what it is certified and what does it mean. The certificate data contains the following fields:

Field	Type	Optional	Description
`name`	`string`	❌	Name of the certificate.
`description`	`string`	❌	Description of the certificate.
`type`	`string`	❌	Type of the certificate.
`content`	`object`	❌	JSON of the certificate content. It contains the required information to be certified.
`issuer`	`string`	❌	Issuer of the certificate.
`issuedOn`	`integer`	❌	Date and time of issuance in which the certificate was issued (Unix format).
`expires`	`integer`	✅	Date and time of expiration in which the certificate will expire (Unix format).
`hash`	`string`	❌	Hash of the certificate.

Metadata

Metadata contains the additional information that feeds the certificate in order to update the status of the certificate (e.g. revocation, evidences) or to add required data to be valid and know how to verify it (e.g. signatures). The certificate metadata contains the following fields:

Field	Type	Optional	Description
`type`	`string`	❌	Type of the transaction (Evidence/Signature/Revocation).
`networkId`	`integer`	❌	ID of the blockchain network.
`smartContract`	`string`	❌	Address of the smart contract in the blockchain network.
`transactionHash`	`string`	❌	Transaction hash in the blockchain network.
`trustPointHash`	`string`	❌	Hash of the evidence (trustpoint) in the blockchain network.
`timestamp`	`integer`	❌	Date and time of the transaction in which the certificate was issued (Unix format).

Access

The property access contains the information to access the certificate. This information collects the personalized identifier of the certificate externalId if it has been established and its privacy. Certificate access contain the following fields:

Field	Type	Optional	Description
`externalId`	`string`	✅	Custom identifier of the certificate. It can be used to access the certificate instead of the ID.
`public`	`boolean`	❌	Indicates if the certificate is public or private.
`certificatePin`	`string`	✅	Encrypted pin for access to the certificate if it is private.

API Overview

Certificate Issuance

Certificate Management

Qualified Signature

Utils

Data

Metadata

Access

​Data

​Metadata

​Access

Data

Metadata

Access