Issuing credentials is only half of the story when it comes to verifiable credential exchange. The other essential piece is verifying those credentials. In this post, we walk through the steps of how to verify credentials in Trinsic Studio. For a more in-depth explanation of verifications and how they work, please visit our documentation.
Before we begin
For this tutorial, we will be referring to Alice Smith who is a recent graduate of Faber College. Alice is looking to apply for a job at ACME Corp. and has started the process of filling out the company’s online application form.
In previous “how to” posts, we walked through the scenarios of 1) Faber College issuing Alice a university diploma in the form of a verifiable credential and 2) Alice creating a connection with ACME Corp. to securely begin applying for a job online. If you have not already completed these steps, we suggest you go back and complete those steps before continuing with the tutorial below.
Log in to Trinsic Studio
Create a verification template
Before Alice can fill out an online job application from ACME Corp., the company must create one. Let’s assume that ACME Corp. wants to request the following information in the application:
- First Name
- Last Name
Because ACME Corp. wants to ensure the legitimacy of an applicant’s responses, the information listed above must come from a valid college diploma. So let’s get started creating the verification template.
First, get the Schema ID for the transcript. To do so:
- First, click on the Faber College organization card on the dashboard screen.
- Click on the “Credentials” tab.
- Copy the “Schema ID” from the College Diploma credential template.
Now create the job application template:
- Return to the dashboard screen and click on the ACME Corp. organization card.
- Click on the “Verifications” tab, and click the “+ Template” button.
- Name the verification “Job Application”.
- Now we are going to set the policies. Policies are a way to specify what data to request from a digital wallet. Click on the “+ Policy” dropdown, and you will see that there are two types of Policies—”Predicate” and “Attribute”. Select “Attribute”.
- Enter “Diploma Verification” as the policy name.
- In the “Select Credential Template” dropdown, select “Define Custom Attributes”.
- In the “Define Attributes” text box, enter the attribute names exactly as they appear in the credential template that you created for Faber College. So we will write in First Name, Last Name, Degree, and Year.
- In the “Credential Restrictions” dropdown, select “Schema ID” and paste the transcript schema ID into the text box that appears. This is so that only credentials issued from the template you created previously will pass the verification.
- Click the “Save Policy” button and wait a few seconds for the template to be saved.
Send a verification request
Now that ACME Corp. has set up its verification template, it can send its verification to Alice!
As ACME Corp.:
- In the “Verifications” tab, locate the verification template you’ll use to request a verification from Alice. Click on the “Request” button which corresponds to this template.
- In the list of “Send verification request via options”, select the “Connection” option.
- Click on the connection you’ve made for Alice.
- Click “Send Request”.
Now as Alice:
- Your Trinsic Wallet should get a push notification for the verification request from your ACME Corp. connection.
- From your home screen, select the verification request to respond. Once you’ve opened it, you can customize the information you share if you have more than one credential that can satisfy the request. In this case, we do not.
- If the information looks correct, press “Present”.
And just like that, Alice has securely sent ACME Corp. the information it asked for in the online job application.