Portal

The SVX Portal is a user-friendly interface that allows users to undertake processes enabled by the SVX API. Following an initial onboarding invitation, Tenant and Organisation Administrators can self-service in order to complete their desired workflows. Depending on their associated Security Rights, an Administrator can undertake the following tasks:

  • Manage their Tenant / Organisation

  • Invite and manage other Administrators

  • Utilise the Credentials Service to:

    • Create and manage credential schemas

    • Create and manage credential templates

    • Issue and revoke credentials

    • Create and manage verification templates

    • Create and manage verification requests

  • Utilise the Enterprise Vault to:

    • Create and manage connections

    • Manage items being shared

  • Create and manage Applications

Tenants

Role, Administrators & Activity

The Portal enables enterprises to manage their own Tenancy. Once a Tenancy has been created, Tenant Administrators can onboard Organisations and invite Organisation Administrators to join. Tenant Administrators have access to Credential Schemas, Applications, End Users, and management of their account.

Note Once a Credential Schema is defined it can be made available to Organisations that will issue credentials. For more information on Credential Schemas see the Credential Schema tutorial.

Responsibilities

During onboarding, all users of the Portal must agree to Meeco’s Terms and Conditions and Privacy Policy. It is the responsibility of the Tenant Administrator(s) to ensure the Organisations within their Tenancy are acting in an ethical, responsible manner.

Organisations

Role, Administrators & Activity

When Organisations are onboarded to the Portal they are invited to join an existing Tenancy. As mentioned above, the Tenant governs the Tenancy that the Organisation conducts business in. Organisation Administrators manage the Organisation and, depending on their Security Rights, can action workflows associated with Credentials, their Enterprise Vault, Applications and account settings.

When utilising credentials, Organisations can act as Issuers and/or Verifiers, thus allowing them to manage:

  • Credential Templates

  • Issue, revoke and verify credentials

  • Verification Templates

  • Verification Requests

Each time an action is undertaken, Organisation Administrators can view and / or archive the item / occurrence. This provides Organisations with fine-grained reporting and transaction management capabilities.

Responsibilities

During onboarding, all users of the Portal must agree to Meeco’s Terms and Conditions and Privacy Policy. It is the responsibility of the Organisation Administrator(s) to ensure all Administrators are acting in an ethical, responsible manner.

Credentials

The Portal provides access to credential management in a simple, user-friendly way. It enables non-technical users to engage with our Verifiable Credential workflows via an intuitive interface. Our credential service utilises the W3C Verifiable Credentials Data Model to ensure standardisation and interoperability with external systems. Additionally, when undertaking credential-based workflows via the Portal, users are engaging in industry leading privacy and security practices that are aligned with current specifications and regulations, specifically the Australian Privacy Principles and General Data Protection Regulation (GDPR) (for details see our Privacy- and Security-by-design page).

Credential Schemas

The Portal provides Tenant Administrators with the option to create Credential Schemas within their Tenancy and make them available to Organisations. With access to a library of Credential Schemas, Organisations can specify which schema is required when creating Credential and Verification Templates. When Organisations within the same ecosystem are referencing the same schemas, credential issuance and verification is accurate and standardised. For further details on how to create and manage Credential Schemas, see the Credential Schemas tutorial.

Credential Templates

Organisations that issue credentials (Issuers) can create Credential Templates which form the base of the credentials they will issue. Credential Templates include the associated credential schema (which determines the information required from the Holder), and credential styling information which enables customisation of credential colour schemes and logos. For further details on how to create a Credential Template, see the Credential Template tutorial.

Issue credentials

The issuance of credentials is made easy via the Portal by a simple step-by-step workflow. Issuers first select one of the Credential Templates they have created previously (see the Credential Template tutorial for details). The Credential Template defines the attributes that are required to be filled in. For example, a First Aid Certificate Credential Template might include attributes such as:

  • Student name

  • Student ID

  • Course ID

  • Subject code

  • Grade

Once the Organisation Administrator has filled in all required attributes specific to the credential recipient (Holder) they are able to issue the credential. For further details on how to issue a credential, see the Issue / Revoke Credentials tutorial.

Revoke credentials

When revoking a credential, an Organisation Administrator simply locates the credential in the list of issued credentials, and selects the option to revoke. For further details on how to revoke a credential, see the Issue / Revoke Credentials tutorial.

Verification Templates

Organisations that verify credentials (Verifiers) can create Verification Templates which form the base of Verification Requests. Verification Templates include the associated credential schema (which determines the information required from the Holder), and if required, a specific Issuer of these credentials can be defined. For further details on how to create a Verification Template, see the Verification Template tutorial.

Note Please note that we acknowledge the term Verifiable Presentation as commonly used in credential specifications, but for the purposes of our Portal, we refer to Verifiable Presentations as Verification Templates.

Verification Requests

In order to verify credentials via the Portal, an Organisation Administrator (Verifier) creates a new Verification Request. Each request requires the Organisation Administrator to select a Verification Template which defines the credential(s) required from the Holder for verification. Once a Verification Template has been selected, the Verifier can view the request in the form of a QR Code. The QR Code can be presented to a Holder in-person, or downloaded and shared via any form of digital sharing method. For further details on how to create a Verification Requests, see the Verification Requests tutorial.

Additional Credential Service Information

For detailed information about our credential service, see our Verifiable Credentials information page or our API documentation.

Enterprise Vault

While the Enterprise Vault (EV) can be directly utilised via the SVX API, it can also be managed by Organisation Administrators via the Portal. By providing an interface to the EV, non-technical Administrators can easily create and manage connections, including the sharing of items on behalf of their Organisation. For further information, see the Enterprise Vault overview page.

Connections

The EV allows Organisations to securely share data with end users via Vault-to-Vault connections. Organisation Administrators can invite end users to connect via a simple invitation workflow. After entering the connection’s full name into the system, they can generate an invitation code. This invitation code is then passed to the new connection which they enter into their own Vault-using application. On acceptance by the connection recipient, the connection between the two Vaults is established. For further details on establishing and managing connections, see the Connections tutorial.

Additional Enterprise Vault Information

For detailed information about our EV offering, see the Enterprise Vault information page or our API documentation.

Last updated