Step-by-Step Guide

1.1 Creating an Account

Visit credentials.blocktrust.dev and create a new account. This will represent the Holder's account (e.g., the student).

You must confirm your email before logging in.

1.2 Setting Up the Connection

This application uses the Identus Cloud Agent. For demonstration purposes, we've preconfigured an instance of the cloud agent. If you want to deploying your own instance, see the Identus Cloud Agent GitHub repository.

• Navigate to New DID in the navigation bar.

• Click on Generate new DID and then select Save to store it in the browser's local storage.

• Go to Connections, click on Connect, then click Save again.

1.2 Requesting a Credential

Due to current technical limitations, credential issuance must begin with a credential request from the holder (student). Typically, the issuer (university) initiates this process directly, but this functionality isn't yet supported by the Identus agent.

• Navigate to Credentials, then click on New Credential.

• Provide details:

  • Label: A descriptive name (e.g., "Graduation Charles"). The label is just for internal reference.

  • Name: The name of the credential will show up in certain templates. A typical name would be for example "Graduation Credential"

  • Identifier: Typically your previously generated DID, but can be descriptive (e.g., "Charles")

  • Choose Achievement as credential type (it should be preselected)

  • Description: e.g., "Charles successfully graduated (or did he?)"

  • Credential Type: Select Achievement for this example.

  • You mal also add additional information if you like

  • You can upload a badge: Here are some samples:

    • Example1

    • Example2

    • Example3

    • Example4

• Click Create Credential after filling in details.

1.2 Issuer's Role

• Open a new browser window in Incognito Mode.

• Navigate again to credentials.blocktrust.dev.

• Log in as issuer. You can use these demo-credentials:

credentials-admin@blocktrust.dev somePassword1

• Under Dashboard / Requests / Pending, find your requested credential (status: "Waiting Approval").

• Click View and then Approve .a

• The status should change to Approved

• Log out and close the incognito browser.

1.3 Receiving the Credential

Back as the holder (student):

• Click Refresh until the status updates to "Waiting Acceptance".

• Select Accept to finalize credential issuance.

• Continue refreshing until the status reads "Credential Received". This may take a few seconds. In the background the two agents are arranging the issuance.

1.4 Copy Credential

• Click Copy Credential to store it temporarily in your clipboard.

• Save the credential externally (in an editor), as it will be used in the next step.

You may view the raw credential format via tools like jwt.io for verification or understanding purposes.

2.1 Validation Steps

The credential now undergoes validation, including:

• Signature and Expiration check

• Revocation registry check

• Trust registry check (disabled in demo)

If validation succeeds, proceed to badge creation. If validation fails, you should get an error here and cannot continue. If the Credential is valid you can click Continue to Preview

2.2 Selecting a Badge

Choose a badge design:

• Selection varies based on credential type and available properties (e.g., image presence).

• Click on the moon/sun to switch between dark and normal badges.

• Click Continue after making your selection.

2.3 Embedding Your Badge

Your badge snippet is now ready. You can copy it to the clipboard. Here is an example of a snippet:

The snippet includes:

• The embedding ID.

• The script rendering the badge on your website.

2.3 Embedding the Badge

Insert the generated HTML snippet into your desired webpage. No additional modifications are necessary. You can see examples of this here.