Login

To login into the Admin UI open the following URL https://CUSTOMER_XYZ.institutional-agent.lissi.id/ in your webbrowser.

Enter your USERNAME and PASSWORD.

Log in


Admin console

Once you are logged in, the Admin UI appears.

The following functions are hidden behind the highlighted elements.

1. Enlarge menu bar

2. Select a tenant (if multi tenant mode is enabled)

3. Receive more information about the agent

Information about your agent

The following information are provided:

  • DID

  • Public

  • Verification key

  • UI Version

  • Controller version

  • Agent Version

  • Agent label: Is the name displayed in the wallet of endusers

  • Ledger genisis url

  • Ledger pool name: Is the ledger where the agent is connected (e.g. IDunion, Sovrin, Indicio,…)

  • Mediator url


Issue Credentials

Step 1: Create a new schema or import a new schema (see description below)

Step 2: Create a new credential definition (see description below)

Step 3: Create a connection with an end user (see description below)

Now there are two possibilities to send out Credentials

Step 4a: In menu bar Credential definition click the “+” button on a specific Credential Definition

Select a specific connection to which the credential should be send

or

Step 4b.) In menu bar Connections search for a specific Connection (either in the list or via the search function)

Once a specific end user has been selected click on the button “Send credentials”

Select a specific Credential Definition

All Credential definition will be displayed in the selection field

Click the “Send” button

Step 5: Define the attributes for the specific end user

Attributes can be text, pictures (.png limited size), .pdf-files (limited size)

Step 6: Click the “Send” button

Step 7: The Credential will be now be send to the selected Connection (end user) and the end user needs to follow the instruction on its wallet


Schemas

Create a new Schema

Step 1: Create or import a new SCHEMA by press the “+” button

eSchema overview

Step 2: Select “New Schema”

Step 3: Enter a name for the schema (e.g. EmployeeID)

The name will be written to the ledger and displayed in your Lissi agent.

Step 4: Set a version number (e.g. 1.0)

The version number will be written to the ledger.

Step 5: Select a picture (.png file) which will later be displayed as a tile in the Agent

Step 6: Define attribute names for the schema

You can add further attributes with the “+” button.

Step 7: Click “Create” button

A new Schema will be created and appear as a new picture in the overview.

Import a new Schema

To import a schema click “Schemas” in the menu bar and then click “Import Schema”.

Step 1: Add the ID of the specific SCHEMA you want to import.

You can look up a specific schema in an Leger Explorer. An example for a schema with in the IDunion Network can be find here: https://idunion.esatus.com/tx/IDunion_Test/domain/11224. This is our StudenID demo credential with the following ID: XmfRzF36ViQg8W8pHot1FQ:2:StudentID:2.7

Step 2: Add an alias

This is the name of the schema which will be displayed in your agent

Step 3: Click the “Select Icon” button and chose a picture (.png file) on your Computer

This is the picture of the schema which will be displayed in your agent

Step 4: Click “Search” button

The specific schema and all related attributes will be written from the ledger.

Step 5: Click the “Import” button and the schema will be created in the agent


Credential Definitions

Menu bar → Credential definition

Attention: Before you can create a new Credential Definition you have to first either create or import a new schema (see above).

Create a new Credential Definition

Step 1: Create or import a new Credential Definition by press the “+” button

Step 2: Select “New credential definition”

Step 3: Enter a name for the Credential definition (e.g. EmployeeID_Neo)

The name will be written to the ledger and displayed in your Lissi agent.

Step: 4: Add a comment what the purpose of the credential definition is (optional)

Step 5: Decide whether the Credential definition should be “revocable” or “not revocable”

Revocable means that a specific credential issued to a user can be revoced.

Not revocable means that a specific credential issued to a user can not be revoced.

Step 6: Select a picture (.png file) which will later be displayed as a tile in the Agent

Step 7: Select a SCHEMA which is the template for the credential definition.

The credential definition will be based on that schema and have the same attributes as the schema.

Step 8: Click “Create” button

A new Credential Definition will be created and appear as a new picture in the overview.

It could take some time once the Credential is created (30-60 seconds)

Import a new Credential Definition

To import a credential definition click “Credential definition” in the menu bar and then click “Import Schema”.

Step 1: Add a Credential ID and the respective Schema ID

You can look up a specific credential definition on a leger explorer. An example for a credential definition with in the IDunion Network can be find here: https://idunion.esatus.com/tx/IDunion_Test/domain/2149. This is an specific demo employee credential with the following IDs:
Credential ID: 2SCqNkxA5jCbomz2C4tx1R:3:CL:2143:Employment
Schema ID: 2SCqNkxA5jCbomz2C4tx1R:2:Employment-SAP:1.0

Attention: Please make sure that your agent is connected with the same ledger you would like to import the credential definition from. Otherwise you will get a error message.

Step 2: Add an alias

This is the name of the alias will be displayed in your agent

Step 3: Click the “Select Icon” button and chose a picture (.png file) on your computer

This is the picture of the schema which will be displayed in your agent

Step 4: Click “Search” button

The specific credential definition and all related attributes will be written from the ledger.

Step 5: Click the “Import” button and the credential definition will be created in your agent


Connections

Menu bar → Connections

Create a new connection

Step 1: Click the button “New connection”

Step 2: Select generate invitation link

Step 3: Enter a name for the connection (e.g. Max Mustermann)

Step 3: Click the button “Create”

Step 4: A QR-Code is automatically created

The end user could either scan the QR-Code with a compatible SSI Wallet or you can use the “Copy link” button to copy the link and send the information within the link to the end user via email or messenger.

The QR-Code and link is compatible with many SSI Wallets, however we recommend the “Lissi Wallet” to ensure the best user experience on your end user side.

Step 5: The end user needs to either scan the link with a SSI wallet or open the link in a browser and follow the further instructions (depending on the specific end user wallet).

Delete a connection

You can delete a connection by clicking the “delete connection” button and confirm.

If you wish to delete all user related data you need to click “Delete all” and confirm.


Proof requests

Menu bar → Proofs

A “Proof request” is a request to an end user’s wallet to provide certain predefined credentials based on specific credential definition. It is possible to do proof requests for credential definitions which you have created or imported from a ledger.

Before you can send out a proof you need to first create a “Proof Template”.

Create a proof request

Step 1: Create a “Proof template” by clicking on the button “New proof template”

You can only create a proof template for credential definition which has been created or imported into your Lissi agent → you can see all created and imported credentials definitions in the menu bar → Credential definitions.

Step 2: Enter a name for the proof template which will be later displayed in the Lissi agent

Step 3: Enter a version number (e.g. 1.0)

Step 4: If the Credential which was issued is revocable you can check whether the credential

a.) has not been revoked when your proof request has been sent

b.) has not been revoked during a predefined time periode

Step 3: Select one or more credential definition and the attributes which should be included in the proof request

It is also possible to add filters here. This is for the purpose of so called Zero Knowledge Proofs (ZKP) and is currently only available for integer values.

Step 4: Add self attributes for self-attestation (if required) by entering the name of the attribute and click the “+” button

Self attributed attributes will be displayed as input fields in SSI wallets where the end user can add informations about themselves. These information, however, are not validated by a third party.

Step 5: Click the create button


Send a proof request to an end user

Step 1: Click on the plus button within the tile of a proof request

Option 1: Send out a proof request to a connection which the agent already know (see above how to create connections)

Step 2: Select “Send to connection”

Step 3: Select a specific connection

Step 4: Click the “send button”

The proof request will now be send to the end user’s SSI wallet.

Step 5: Once the end user answers the proof request the information will be send to your agent

Option 2: Send a connectionless proof request

This is a proof request there you do not need to create a connection with the end user’s wallet so you can just send out the request.

Step 2: Select “Connectionless”

An QR-code will be created.

Step 3: End user needs to scan the QR-code with it's SSI wallet or you can copy the information of the QR-code and send it to the end user via email or messenger.

Step 4: Once the end user answers the proof request the information will be send to your agent