Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
outlinetrue

...

Panel
bgColor#F4F5F7

An issuance template defines an issuance process, including:

  • What credential schema will be used (which in turns defines the type of credential: e.g. a driver’s license, an academic diploma, or a national ID)

  • Which claims within the schema will be actually issued

  • What authentication requirements and security constraints are needed for a user to get the credential (e.g. sharing other existing credentials from the Wallet, 2FA)

When accessing Gataca Studio, you can create a new issuance template from the main dashboard or click New issuance in the issuance templates section.

...

Creating an Issuance template involves a 4-step process:

Step 1: Basic configuration

Issuance ID - Name the issuance template

The first step is to select define your issuance template name. We recommend this name to be descriptive of the Issuance credential to be issued.

This name will be associated with the issuance process for users and will also serve as a the main reference to the credential the user is requesting when interacting with your process when adding it to API Keys and throughout the platform.

Example:

...

“Employee Card Teachers Template”

Requester DID

In an SSI ecosystem, Issuers, Users, and Verifiers are all represented by one or more DIDs. You will have to select which DID you want to state as the Issuer of this credential.

By default, a DID has already been created for you (My DID)with alias name “My DID”. This DID can be selected for issuing your first issuance template. You can also decide to create a another DID first.

Info

Jump to the tutorial on creating DIDs

Verifiable Credentials are associated with a specific DID as the owner or holder of that credential. In an SSI ecosystem, Issuers, Users, and Verifiers are all represented by one or more DIDs. As an issuer, you will have to select the DID you want to associate with this credential.

Example:

...

Issuance

Credential Types - How to select the credential type to be issued?

...

This data must be necessary for you to verify your user before issuing the credential.

...

Scroll the list and tick those credentials you want to select, or use the search bar on top.

...

  • API Key Name

  • Select the DID associated with the new API Key

  • Select the credential issuance template you want to associate with this API Key from the SSI Operations dropdown.

...

You will be presented with the ID and password of the API Key created.

...

Once you reach the end of creating an issuance template, you can select to add this template to an API Key. Alternatively, on the issuance templates list, click on the three dots next to the issuance template you would like to test and select Edit.

...

Once the issuance template opens, on the top right, click on Try it.

...

  1. Select the API Key you want to associate with the new template created.

  2. Insert the password provided when creating the API Key.

  3. Callback: Insert the URL of a service that is notified by a post notification with the session data when the session has been validated.

...

Click the Scan Now button to access the QR Code to join your sandbox and scan it with your wallet. The sandbox will allow you to perform private and secure tests of the platform.

...

Once the connexion with your sandbox has been successful, click on Generating test.

...

Scan the QR code generated to start testing.

...

Your Wallet will then ask for the requested credentials. Consent.

Once you’ve given your consent, you will receive a notification that you’re credential needs to be verified first.

From Gataca Studio, to test a credential issuance template, you can do it from Credential Activity and in the pending section where you can take action toallow or deny the issuance of a specific credential. To issue a credential, click on the green tick and to revoke, click on the red cross.

...

When deciding to issue a credential when testing, you will need to fill in the information relative to this credential. This user data validation will depend on the type of credential to be issued.

Once the data is filled, click submit.

...

The credential will now appear under Issued Credentials and in your Wallet.

...

4. Integrate SSI with your application

...