Connections
Introduction
Connections can be established between Organisations and end-users to facilitate secure, end-to-end encrypted sharing of data. An Organisation within the Portal is provided with an Enterprise Vault and end-users who have registered with the Organisation’s associated Tenant, are provided with an end-user Vault. A connection between an Organisation and an end-user allows Organisations to directly issue, revoke and verify an end-user’s credentials.
Invite a user or an Organisation to connect
Organisation Administrators can invite end-users and other Organisations to connect by navigating to Enterprise Vault on the left-side menu of the SVX Portal, and selecting Connections. After selecting the Generate invitation code button, you will be presented with a field titled Recipient identifier. Enter an identifying label in the field.
Note Recipient identifier: Enter a name, email address, unique number etc. to identify the connection.
Once complete select the Generate invitation code button. You will be provided with an invitation code which you will need to send to the connection recipient. You may wish to send the invitation code via email, direct message, or share it in-person.
Return to the Connections list and you will see the connection appear in the Pending connections tab.
Note Once the connection recipient has accepted the invitation, the connection will move to the Existing connections tab.
Accept an invitation to connect
Organisation Administrators can accept an invitation to connect from other Organisations by navigating to Enterprise Vault on the left-side menu of the SVX Portal, and selecting Connections. After selecting the Accept an invitation button, you will be presented with a form. The form consists of the following fields:
Recipient identifier
Invitation code
Note Recipient identifier: Enter a name, email address, unique number etc. to identify the connection.
Note Invitation code: The invitation code will need to be provided by the Organisation requesting to connect. The code may be provided be any means of communication, eg. email, direct message, or in-person.
Once complete, select the Connect button. You will be presented with a confirmation modal that asks you to agree to:
Sharing your Organisation’s name and DID
Enabling the sharing of items between your Organisation and this user.
Select the Confirm button to complete the connection. The new connection will appear in the list of Existing connections. Or, select the Cancel button to reject the connection.
View a connection
Connections can exist in two states:
Pending, and
Existing
To view a Pending connection navigate to Enterprise Vault on the left-side menu of the SVX Portal, and select Connections. Select the Pending connections tab, locate the connection in the list and select the horizontal ellipsis icon ⋯ alongside the connection’s name to reveal menu options. Select View. You will be presented with the following information:
Placeholder name
Connection ID
Token
Date created
To view an Existing connection navigate to Enterprise Vault on the left-side menu of the SVX Portal, and select Connections. Select the Existing connections tab, locate the connection in the list and select the horizontal ellipsis icon ⋯ alongside the connection’s name to reveal menu options. Select View. You will be presented with the following information:
Recipient identifier
Connection ID
Date created
Items that are currently being shared
Note Items being shared: This includes credentials that have been issued via a Vault-to-Vault share.
Cancel and remove a connection
To cancel and remove a connection navigate to Enterprise Vault on the left-side menu of the SVX Portal, and select Connections. Locate the connection in either the Existing connections or Pending connections tab and select the horizontal ellipsis icon ⋯ alongside the connection’s name to reveal menu options. Select Cancel and remove and confirm the cancelation of the connection and the removal of the connection from your Organisation via the modal window. The connection will be removed from the list of connections.
Note To re-establish a connection, you will need to generate a new invitation code, or accept an invitation with the end-user or Organisation once again.
Note When an end-user is removed as a connection, they will be notified in their wallet application that the connection has been cancelled. All issued credentials will remain in their wallet.
Last updated
