Credential Issuance from DICE ID Console
Step-by-Step guide for issuing credentials using DICE ID platform console UI
DICE ID is a platform that provides ability to onboarded organizations to issue credentials to their end users and customers for variety of use cases. The steps to issue a credential can be summarized as:
Schema Creation - this is a one-time setup required to define the attributes of a credential. Once a schema is created then any number of credentials can be issued based on that. For credentials that represent skill of an individual and should contain a certificate generated on DICE ID platform, Cred_URL attribute is mandatory.
Creating Certificate Template - This is an optional one time setup required only if the credential is required to contain a certificate then a certificate template needs to be setup. Based on the certificate template the Cred_URL attribute will be populated with link to the certificate.
Onboarding User / Customer - this is a one-time activity in which the user or customer is to be notified to take action for establishing a secure connection with DICE ID platform using DICE ID mobile app.
Sending Credential Offer - this activity can be done any number of times by specifying the schema to be used and the user to who the credential is to be sent. Once credential offer is sent the user has to scan QR code in their email to download it into DICE ID mobile app. This tutorial will cover steps for manual issuance via platform console UI
The sections below will cover each of the above steps in detail.
1. Sign-up an Sign-in to DICE ID Platform Console
Open https://console-uat.diceid.com/ in your browser and complete the signup and sign-in steps as described in Platform Console. Goto step 2 if this is already completed.
2. Create Schema for your use case
We will take example of a Skill based credential which represents course completion or skill assessment for an individual for which a certificate is also provided.
In DICE ID console UI navigate to Credentials --> Schemas page from the left hand menu. Click on Add Schema option on this screen.
On the Add Schema screen, enter the name of the credential, version number and attributes.
Since this schema is being created to represent the structure for a skill based credential and will contain a certificate, the "Schema used for Certificate Issuance?" should be selected, which will automatically add Cred_URL attribute. During credential issuance this attributed will get auto-populated with the link to the certificate generated from DICE ID platform.
The rest of attributes and data types will be:
Name - name of the individual who completed the course or assessment
Skill - name of the skill or course for which the individual got certified
Issued Date - the date on which the certificate was issued
Valid Till - the date till which this credential and certificate is valid.
dice_display_name - A user friendly name for the credential that will get displayed in DICE ID mobile app
Click on "Create Schema" at the bottom of the screen to submit so that the schema and corresponding credential definition gets created on blockchain. You should see a confirmation message and schema listed on the following screen.
3. Onboard user and setup Credential issuance from Console UI
Navigate to Credentials screen from the left hand menu and click on "Issue Credential to New Customer"
On the next screen specify the name of the user / customer to whom this credential is to be issued e.g. Alice and her email. Depending on your requirement it is advisable to select one of the modes of invitation
If you want to send a contextual email to your customers then create a email template by following steps in Email Template section so that it is available in the Email template drop down for selection.
Select the checkbox "Auto Issue credentials" to select the "Sample Skill Schema" created in previous step and specify the values for each of the attributes.
Since this credential is based on a Schema containing "Cred_URL" attribute that will contain the certificate URL so it is mandatory to select the Certificate Template. Detailed steps on how to create a certificate template are covered in Certificate Template
Click "OK" to save the auto issuance details and navigate back to the previous screen. Click on "Onboard" button to initiate the invitation mail to the user / customer.
The different stages sending invite to customer, and a secure connection being established for onboarding can be tracked from Customers page. The different stages of credential issuance can be tracked from Credentials page.
How will user / customer get the credentials?
User needs to have access to their inbox on which email was received from no-reply@diceid.com. The email contains instructions to download DICE ID app and scan the QR code in the email. Once the QR code is scanned from DICE ID app a secure connection is established with user's device and the credentials get downloaded and stored in the app.
If the user opens their email on phone then they need to click on the button provided below the QR code which redirect them to the DICE ID app installed on their phone.
Please note that once you are done with development and testing then you should use DICE ID Production environment (https://console.diceid.com) to issue the credentials to your end users.
Last updated
