Tutorial

Meet Alice

This document will walk through a scenario where Alice will receive a college diploma and prove to her employer she graduated collete to get a job. Included is both a detailed text version and a video summary.

Create Organizations

There are a couple of different entities that Alice with interact with in this scenario. For our demo, we will need to create mock versions of these organizations before we begin.

add_organizations

Steps:

  1. Go to the Trinsic Studio and login.
  2. Click on the + Organization, and create an organization called "Faber College" on the Sovrin Staging Network.
  3. Repeat Step 2 for ACME Corp and Thrift Bank.

Write an organization's public DID to the Sovrin Ledger

During this process, a couple of important interactions happened.

First, a secure wallet was created in the Trinsic ID Agency for each of these organizations. Next, a public decentralized identifier was created for each organization and was written to the Sovrin Staging ledger. Finally, endpoints were set up so that any individual can connect with that organizations when the Public DID is resolved on the ledger. There is more information about this process in the open source documentation of Hyperledger Aires.

Create credentials

Alice will receive her transcript from Faber College in a digital format. But first we need to create the digital credentials that will be used to represent these documents.

Write credential definitions to the Sovrin Ledger

At this point, there are two ways to accomplish this. Either use Trinsic Studio (no coding required), or use our API with one of our SDKs. Both options are included below.

Create Faber College's Transcript

Credential Templates

Steps:

  1. Click on the Faber College organization tab to enter into the organization.
  2. Go to the Credentials Tab and click the + button.
  3. Using the New Schema tab, name the credential "College Transcript" and add these five attributes:
    • First Name
    • Last Name
    • Degree
    • GPA
    • Year
  4. Click Create Template. There will be a 1-3 second delay while the template is written to the ledger.

Congratulations! You now have a credential template written to the ledger.

Create ACME Corp's employee credential

Steps:

  1. Click on the ACME Corp organization tab to enter into the organization.
  2. Go to the Credentials Tab and click the + button.
  3. Using the New Schema tab, name the credential "Employee Certificate" and add these five attributes:
    • First Name
    • Last Name
    • Salary
    • Experience
    • Start Date
  4. Click Create Template.

Alice gets a transcript

As a graduate of Faber College, Alice receives an alumni newsletter where she learns that her alma mater is offering digital transcripts. She logs in to the college alumni website and requests her transcript by clicking the Get Transcript button.

Alice can use her mobile wallet to receive her digital transcript. This mobile wallet will become a building block for Alice's self-sovereign identity. It is a new form of digital identification. One that is portable and belongs to Alice, that nobody can use or correlate without her permission.

Using a self-sovereign identity will require a tool called a digital wallet. It's a simple desktop or mobile application that facilitates the exchange of credentials with third parties. When Alice clicks Get Transcript, Faber College will send a connection request to Alice's wallet. Once she accepts the connection request, this connection request will enable Alice to make a secure channel of communication with another party — Faber College.

In our case, Alice will install a mobile app as her wallet. Whenever she needs to receive a credential, Alice will launch the app and scan a QR code.

Install Trinsic Wallet

Now it's time to become Alice for a moment and take a step into a future where digital credentials are the norm.

As an individual using self-sovereign identity, the first step is to download a digital identity wallet. This is sort of like an Apple Wallet, but it is for all the other credentials that you carry around with you.

Our identity wallet can be downloaded for both iOS and Android.

Once you have downloaded the wallet and walked through the onboarding screens, it's time to connect with Faber College to receive your credential.

This can be done in many ways. The most common way currently is to scan a QR code. Faber College would post this QR code on the student's online account, or send an email.

Alice creates a connection with Faber College

Connections

As a Faber College employee, Use Trinsic Studio to create a connection and send a credential to Alice by:

  1. Go to the Connections tab and click the + button.
  2. Make sure the View invitation QR box is checked, then click the Create Invitation button.

Now, as Alice:

  1. Open your mobile wallet app and tap on Scan Code.
  2. Scan the QR code that is displayed in Trinsic Studio.
  3. When the invitation shows up in the wallet, click on Accept.
  4. The connection will be added to your wallet.

Faber College issues a transcript to Alice

send_creds

As a Faber College employee:

  1. If a new connection does not show up in the Connections list, refresh the page.
  2. Click on the new connection that shows up. Should be named the name of the device
  3. Click on the + Credential and select the College Transcript credential from the drop down.
  4. Fill in all the attributes with Alice's information, then click Issue Credential.

Now, as Alice:

  1. Once the credential has been offer, you will see an Action appear in your wallet.
  2. Open the credential offer and inspect the attributes. If everything looks correct on your end, click Accept.
  3. The credential will be issued to your wallet, and you can view it in the Wallet tab.
  4. The connection will be added to your wallet.

Alice gets a job

Create ACME Corp job application

Now that Alice has her first credential, she can begin to use it to prove things about herself. In this case, she wants to get a job and can use her digital college transcript to do so.

ACME Corp is requesting that Alice fill out a job application.

To create the job application, we will use something called a Verification Template. To prove anything with the credentials you have received, you will need to use a verification. These can be created with Trinsic Studio or through the API.

The job application requires:

- First Name
- Last Name
- Degree
- GPA

All from a valid college transcript

create verifications

First, get the Schema ID for the transcript:

  1. Click on the Dashboard and go to the Faber College dashboard.
  2. Click on the Credentials page. Copy the "schema ID" from the College Transcript credential

Now create the **Job Application** template:

  1. Click into ACME Corp dashboard, go to the Verifications page and click the + button.
  2. Name the verification "Job Application"
  3. Add the attributes
    • First Name
    • Last Name
    • Degree
    • GPA
  4. Click the Filters checkbox next to each of the attributes, and add the "Schema ID" of the College Transcript credential to each one. This will limit which credentials can be used to fill in the attributes.

Alice connects with ACME Corp

Now it's time to become Alice again and send in a job application for ACME Corp.

First, create a connection with ACME corporation. Do this by using the same method used earlier but with the ACME Corporation organization.

ACME Corp Sends Alice a Job Application

Now that Alice has connected with ACME Corp, send a job application to Alice.

send_verifications

As ACME Corp:

  1. Go to the Connections page and click the + Verification button.
  2. Select the Job Application, then send that to Alice.

Now as Alice:

  1. On Trinsic Wallet, you will receive a job application and be asked to fill in your information from your college transcript.
  2. If the information looks correct, press Accept.

ACME Corp verifies Alice's transcript

...

ACME Corp issues Alice a job certificate

Once ACME Corp has verified that Alice received a college transcript, they can choose whether or not to hire her.

Assumming they choose to hire her, Alice should now receive a Job Certificate to prove her employment.

As ACME Corp:

  1. Go to the Credentials tab in ACME Corp.
  2. Click on Issue next to the Job Certificate Credential.
  3. Select the connection to Alice's wallet in the drop down menu.
  4. Fill in the attribute information.
  5. Send the credential.

As Alice:

  1. Once the Job Certificate offer is sent to the wallet, review the information and choose whether to accept or decline it.

Congratulations! If you've gotten this far, you've now used Trinsic Studio and the Credentials API to issue and verify information from an individual.