# 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](https://docs.meeco.me/platform/vault/enterprise-vault) and end-users who have registered with the Organisation’s associated Tenant, are provided with an [end-user Vault](https://docs.meeco.me/platform/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.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-8abc2c9eab1d4ef32cdf6267af5080999644caa5%2FOA_12_Generate_connection_code.gif?alt=media" alt="How to invite a user or Organisation to connect tutorial video." width="80%"></div>

### 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.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-05374c9ce6bf93aa5b05940badd6ba1b55d42324%2FOA_33_%20Accept_a_connection_invitation.gif?alt=media" alt="How to accept an invitation to connect tutorial video." width="80%"></div>

### 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

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-c7c7ca1adf1cacd96faba8dbf6f96051d9f01dfd%2FOA_13_View_pending_connection.gif?alt=media" alt="How to view a pending connection tutorial video." width="80%"></div>

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.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-21909294e70c6a8a7e5c016afbe8b62a8da59a18%2FOA_14_View_existing_connection.gif?alt=media" alt="How to view an existing connection tutorial video." width="80%"></div>

### 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.

<div align="center"><img src="https://4269219262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjJbpzCN8I6igFFpr6ws9%2Fuploads%2Fgit-blob-9e60b305ac744714508c6aacbcf6a856704db5ef%2FOA_15_Cancel_and_remove_connection.gif?alt=media" alt="How to cancel and remove a connection tutorial video." width="80%"></div>
