Connections

Connections enable tenants to establish secure, encrypted communication channels to interact with other wallets. As an organization, you initiate a connection invitation. When the recipient (e.g., a user or another organization) accepts the invitation, you are securely connected over an encrypted channel. Once connected, the organization can issue verifiable credentials directly to the recipient over this encrypted channel.

To send credentials, connections are a key requirement for 4 ecosystems, Privado, Indicio, Cheqd, and Sovrin. The connections are formed over secure communication protocols to ensure a safe and encrypted exchange of verifiable credentials between issuers, holders, and verifiers. For Privado, we support Iden3, and for Indicio, Cheqd, and Sovrin, we support DIDcomm protocol.

note

For more information regarding communication protocols, please refer to Communication Protocols.

Example: Creating a Connection Request for the Indicio Ecosystem

Follow these steps to create a secure connection in the Indicio ecosystem.

1. Visit the Hovi API Reference.

2. Select the Indicio Ecosystem API tab.

3. Navigate to the POST - Create Connection Invitation endpoint and click “Test Request”.

   1. Ensure you have a tenant set up. If not, refer to the tenant creation guide.

4. Enter the API key as a Bearer Token, provide the body parameters, and click “Send”.

5. The invitation URL will lead to a QR code that the recipient can scan using their preferred digital wallet to accept the connection. Once the recipient accepts, a secure connection is established, allowing the organization to proceed with issuing verifiable credentials.

note

Hovi’s Connections endpoints allow you to create, delete, and retrieve connections, as well as access connection invitations. For more information, please visit Hovi API Reference.