This step-by-step guide will show you how to create issuer profiles and issue Verifiable Credentials. Each issuer profile is made with a decentralized identifier (DID) which is a globally unique digital identifier.

Issuer Profiles (DIDs)

Create a DID

1. Go to Dock Certs to create an account or sign in with Web3 ID, GitHub, or Google.

The first step to creating a decentralized identifier is to set up a Dock Certs account

2. If you’re just getting familiar with the platform, you can use Test mode on the top right.

Use the digital credential platform in test mode

3. To create your issuer profiles, select Issuer Profiles on the left side menu and then click Create Issuer Profile.

Create an issuer profile on the digital credential platform

4. Fill in the details and you can leave the Key Type to the default setting “ed25519.” Then select Create a DID.

Fill in the details for your decentralized identifier

5. Your issuer profile is now created and all of your profiles (DIDs) will be listed on this page.

All of your issuer profiles (decentralized identifiers) will be displayed

Edit an Issuer Profile

1. Click on Issuer Profiles in the menu, click on the three dots of the DID you want to edit, and select Update DID.

Update a decentralized identifier

2. Update the details and select Update DID.

Update the decentralized identifier details

Export a DID

1. Click on Issuer Profiles in the menu, click on the three dots of the DID you want to export, and select Export DID.

Export a decentralized identifier

2. You can export your DID to a wallet or another platform. Create a password to encrypt the file and select Export.

Confirm the decentralized identifier export

Delete a DID

1. Click on Issuer Profiles in the menu, click on the three dots of the DID you want to delete, and select Delete DID.

Select "Delete DID" to remove a decentralized identifier

2. Select Delete.

Confirm deleting the decentralized identifier

Credentials

Issue Credentials

1. In the Credentials menu, click Issue credentials. Select the credential format you want to use.

2. Select the credential template. You can click on Preview to see what details are on the template.

3. You need to have at least one issuer profile (DID) created before you can issue a credential. If you haven’t created at least one yet, you will be prompted to make an issuer profile before you can select the credential format. 

Create an issuer profile if you don't have one in order to issue a digital credential.

4. If you don’t want to customize the credential, select Continue Without Design on the top right. If you want to customize your design, click here for the steps on how to do so.

Continue making a Verifiable Credential without a design

5. Select which Issuer Profile (DID) you want to use to issue the credentials.

Verifiable Credential options

You have the options to: 

  • Persist credential: This option will encrypt the credential by providing a password to access it and store it on Dock’s servers. The credential can be accessed and verified by a URL or QR Code. The recipient can scan the QR Code to import the credential into a wallet app. The credential can be deleted from Dock’s cloud whenever you decide.
  • Generate PDF: If you choose to persist the credentials, the PDFs will contain a QR code the recipient can scan to view and store their credential in their phone wallet app. 
  • Credential revocation: This can make the credential invalid at any time. If you leave this option unchecked, the credential can never be revoked and will always be verifiable.
  • Anchor credentials: This adds a hash of the credentials you issue on the Dock blockchain that can be referenced later to verify when and who created it. 
  • Use Dock BBS+: Allows credential recipients to share specific data rather than show the whole credential to enhance their privacy.

6. If you want to add recipients one by one, select Add Manually.

Add credential recipients manually

7. Fill in the credential details and select Add recipient.

Fill in the Verifiable Credential details

8. The recipient details show up like this:

The Verifiable Credential is created

9. If you have many credentials to issue, you can issue them in bulk. To do this, select Import Spreadsheet.

10. Download the sample CSV template and fill in all of the details to issue multiple credentials at the same time.

Download the CSV template to add the details of the Verifiable Credentials

11. Once you have added all of the recipients, select Issue Credentials.

11. Once the credential has been issued, it’s important that you download the credentials especially if you didn’t persist them otherwise you can’t get them back.

One Verifiable Credential has been issued

If you chose to generate a PDF format, this is how your files will appear when you download the credentials:

This is how the JSON file looks when you open it. JSON is used if you want to import this to a wallet or send it to another platform.  A JSON file is a file that stores simple data structures and objects in JavaScript Object Notation (JSON) format, which is a standard data exchange format.

JSON format of the Verifiable Credential

12. This is an example of how a credential can look:

Verifiable Credential issued on the digital credential platform

13. This is how the credential looks when it is imported into the Dock Wallet:

Credential imported in a digital identity wallet

Revoke Credentials

If you need to make a credential invalid you can revoke it. You can revoke one credential at a time.

1. Select Credentials, the credential(s) you want to revoke to make it invalid, and select Revoke.

Revoke credentials on the digital credential platform

Viewing and Removing Credentials From the Account View

1. Select Credentials from the menu to see the history of credentials issued.

View all the credentials on the digital credential platform

2. If you don’t want to view certain Verifiable Credentials in your account, select the ones you want to remove and click Delete. This does not delete the credentials themselves, it just removes them from the account view.

If the credential is not revocable, then the recipients will still have the credential in their wallet and be able to present it to verifiers because they have full ownership of it. Only credential holders will be able to delete the credential if they chose to.

How to delete credentials

Verify Credentials

1. Select Verification in the menu and click here to follow these steps in this step-by-step verification guide.

Developer

API Keys

1. To create your first API key, under the Developer menu item, click API Keys. Then select Create API key.

Developers can use the digital credential platform to create API keys.

2. Your API key is created. Under Whitelisted IP’s, you have the option to add additional security by configuring IP's that are allowed to access your services.

API key is created

3. All of your API keys will be displayed like this:

API key displays

Webhooks Endpoints

1. You can add or modify webhook endpoints that will send events when issuing or when transactions occur. Under Developer, select Webhook and click Add Endpoint on the top right.

Developers can use the digital credential platform to add Webhook endpoints.

2. Fill in the Webhook details and click Create Webhook.

Fill in the Webhook details

3. All of your endpionts will be displayed like this:

How endpoints are displayed

Transaction History

History of issued credentials and API transactions

1. To see a historical list of your used API transactions and issued credentials, click on the Activity menu item.

See a list of API transactions

Plan & Billing

How to choose or change your plan

1. Click on the Plan & Billing menu item and select which plan you want.

Choose which plan you want for the Verifiable Credentials platform

Dock Certs Issuer Guide

By
Dock
Updated on
March 16, 2023