Credential Issuance Configuration

Manage Issuance Configuration to enable your application with Credential Issuance.

To issue a Verifiable Credential, it is required to setup the Issuance Configuration on your project, where you select the issuing wallet and supported schema to create a credential offer that the application issue. In this section we will create and test Credential Issuance Configuration.

Configuration details

Below are the relevant fields when managing Credential Issuance Configuration:

Required fields

  • Name of configuration: Assigns name for the configuration for your personal convenience.

  • Issuing Wallet: Create a new wallet and provide the new wallet name or select an existing Wallet that will sign and issue the credentials to the user. Read more about Wallets here.

  • Lifetime of Credential Offer: Credential Offers have a limited lifetime to enhance security. Consumers must claim the offer within this timeframe.

  • Supported Schemas: List of allowed schemas for creating a credential offer. Issuance will validate the credential data based on the supported schema before creating the Credential Offer. Create the Schema through the Schema Builder.

The Credential Configuration ID specified on each supported schema is required as a credentialTypeId parameter when creating a Credential Offer. The JSON Schema URL and JSON-LD Context URL can be found in the Schema you have created in the Schema Builder.

Optional field

  • Description: Provides description of the configuration purpose and usage.

Create Credential Issuance Configuration

You can easily do this using the Affinidi Portal:

  1. Go to the Credential Issuance page of the  Affinidi Portal, click Create Configuration and set the required fields.
Create Credential Issuance
  1. After setting the fields, click Add Credential Data and add supported schemas to create a credential offer.
Create Credential Issuance
  1. Once all the required fields are populated, including the list of supported schemas, click Create configuration.

Test Your Issuance Configuration

Affinidi Portal allows you to test your Credential Issuance configuration and issue Verifiable Credentials to your Affinidi Vault based on the list of supported schemas configured to ensure your setup works.

To do this, click the Test button at the top-right of the Issuance Configuration detail view.

Credential Issuance Configuration Test

Upon loading the page, the Holder’s DID is populated with your Decentralised Identifier (DID), which is used to log in to the Affinidi Portal.

You can specify the Claim Mode whether to generate a Transaction Code to claim the Verifiable Credential or claim normally without a Transaction Code.

After specifying the Claim Mode, you must select which Schema to use from the list of supported schemas in your configuration.

Credential Issuance Configuration Test Page

Selecting the Supported Schema will dynamically render the fields based on the Schema definition. Fill out the fields and then click on the Issue Credential button to create a Credential Offer.

Once the Credential Offer is created, a popup is shown with the details like the Expiration of the Credential Offer based on your configuration, the Claim Link, and the QR code to complete the process of claiming the credential to your Affinidi Vault.

Credential Issuance Configuration Test Output

Test each Credential Type to make sure your configuration and Schema definition meet your requirements.