Skip to main content

Issuer Node UI Guide

info

Before you actually act as an Issuer and provide credentials, you need to set up a Privado ID Issuer Node. You can find instructions to get your Issuer Node up and running here.

Schemas

To create a credential, you require a schema that contains its JSON vocabulary semantics and links to the JSON-LD Context and JSON URL.

You can create your own schemas and import them to the Issuer Node. Here's how you can do that:

  1. Click on Import Schema:
  1. Then you provide the schema URL:
  1. After you pasted the schema URL, you can click on Preview import.
  1. The preview will show the details of the schema. You can also choose to see the attributes in a formatted way, as a JSON LD context or the JSON schema itself.
  1. Your new schema will be instantly added to your schema list.

Credentials

The Credentials main page shows information about all the credentials that have been granted. Each of one those credentials can be revoked by clicking on the 3 dots at the end of the row.



"Revocation and Issuer state publication"

Whenever an Issuer decides to revoke a credential, they have to publish the issuer state to the blockchain. This can be done on the Issuer state. Notice that there will be a Pending actions right next to the sidebar button.

The main responsibility of an Issuer is to create and provide credentials to ID holders. Here is how you can do it:

Direct Issuance

If you already have a connection with an identifier or you have its DID, you can issue a credential directly to it.

  1. You can start by clicking on the Issue credential button or choosing the Issue action next to one of your Schema types.
  1. Either paste an identifier DID or select one from the list:
  1. Now you will be prompted to choose which Schema Type you would like to create your credential with.

  2. The credential we are trying to issue in this tutorial has one mandatory field: the entryDate. That would represent the day when the person would have joined the DAO.

  1. Click on Issue credential directly and the credential is sent to the Holder.
  1. You can start by clicking on the Issue credential button or choosing the Issue action next to one of your Schema types.
  1. There are some available options for this credential: an expiring date and a maximum number of issuances.
note

If you clicked on the Issue credential button, you will later be prompted to choose which Schema Type you would like to create your credential with.

  1. The credential we are trying to issue in this tutorial has one mandatory field: the entryDate. That would represent the day when the person would have joined the DAO.
  1. After you click on Create credential link, you will have access to the credential link:
info

When the user interacts with the Universal Link , it will launch the Privado ID Web Wallet in the browser or Privado ID Wallet app in case of a mobile phone displaying the credential offer to claim the credential. Deep link could be handled only by mobile wallet app though.


"What happens on the Holder's side?"

Privado ID Web Wallet:

The holder will just have to Sign in using a crypto wallet which creates/retrieves the user identity, click Add to my wallet. The holder finally claims and receives their credential in the wallet.


Privado ID Wallet mobile app:

The holder will just have to log into his Privado ID wallet mobile app, scan the QR code and choose Sign in. After authentication, the holder finally receives their credential.

Connections

This area of the Issuer Node UI shows all the current connections with ID Holders as well as the credentials issued to them.

You can also check the details about each of those connections, issue credentials directly or remove them by clicking on the 3 dots next to each connection.

The Details page shows some useful information, such as identifier(DID), creation date and issued credentials. Some other available actions are direct issuance, credential revocation and removal.

Identities

This area of the Issuer Node UI where you can add new identities and view existing identity details.

To add a new identity, click on Add identity

Fill in the name and details related to this identity. Clicking Add identity would add a new identity for your issuer node.

To switch between different identities for the issuer node, click on the switch and select the desired identity.