Vue Vault

A Vue component to embed Apideck Vault in any Vue application.

This guide will get you up and running with the Vault component. To get started, follow these 3 steps:

• Step 1: Setup Apideck
• Step 2: Create a session
• Step 3: Add Vue Vault

Step 1: Setup Apideck

Create an account

If you haven't already, head over to our Signup page and create an account. Choose an application name and a subdomain. Afterward, you will be redirected to the Apideck dashboard.

Enable Unified APIs and connectors

Go to the Unified APIs page in the Apideck dashboard. Choose one or more Unified APIs to enable. You'll see a list of the available connectors for each Unified API. Choose a couple of connectors to enable. The Unified APIs and connectors you select become available to your users in Vault.

Get your API key and Application ID

Go to the API Keys page in the Apideck dashboard. Copy your application ID and API key. If your API key ever gets compromised, you can regenerate it on this page.

Step 2: Create a session

Vault lets your users (called consumers in Apideck) easily connect and configure integrations. You can create a consumer through a Vault session through the following endpoint https://developers.apideck.com/apis/vault/reference#tag/Sessions.

Most of the time, this is an ID of your internal data model that represents a user or account in your system. E.g., account:12345. If the consumer doesn't exist yet, Vault will upsert a consumer based on your ID.

Use the API call below to create a session for a consumer. This will return a Vault URL that you forward to a consumer to connect integrations.

curl --request POST \
  --url 'https://unify.apideck.com/vault/sessions' \
  --header 'Authorization: Bearer {API_KEY}' \
  --header 'x-apideck-app-id: {APP_ID}' \
  --header 'x-apideck-consumer-id: {CONSUMER_ID}' \

You can also use one of our SDKs to create a session, like for example the Node SDK:

npm install @apideck/node

Below is an example of creating a function to create a session:

import { Apideck } from '@apideck/node'

const createSession = async (_, res) => {
  const apideck = new Apideck({
    apiKey: `${process.env.API_KEY}`,
    appId: `${process.env.APP_ID}`,
    consumerId: 'test-consumer'
  })
  const settings = {}
  const { data } = await apideck.vault.sessionsCreate(settings)

  res.json(data)
}

export default createSession

The returned

data

session_token

jwt

Vault

session_uri

react-vault

Step 3: Add Vue Vault

Vue Vault lets your users authorize connectors and manage integration settings. It stores the credentials securely and lets you make authorized API calls on your consumers` (users) behalf. To get started, install the component using NPM or Yarn.

Package

npm install @apideck/vue-vault

Usage

Pass the JWT you got from the Vault session to

@apideck/vue-vault

open

<script setup lang="ts">
import { VueVault } from '@apideck/vue-vault'

const sessionJwt = 'REPLACE_WITH_SESSION_TOKEN'
</script>

<template>
  <main>
    <VueVault :token="sessionJwt" v-slot="vaultProps">
      <button @click="vaultProps.open()">Open</button>
    </VueVault>
  </main>
</template>

If you want to only show integrations for a single Unified API, you can do that by passing the

unified-api

service-id

<script setup lang="ts">
import { VueVault } from '@apideck/vue-vault'

const sessionJwt = 'REPLACE_WITH_SESSION_TOKEN'
</script>

<template>
  <main>
    <VueVault
      :token="sessionJwt"
      unified-api="accounting"
      service-id="quickbooks"
      v-slot="vaultProps"
    >
      <button @click="vaultProps.open()">Open</button>
    </VueVault>
  </main>
</template>

If you want to get notified when the modal opens and closes, you can provide the

onReady

onClose

<script setup lang="ts">
import { VueVault } from '@apideck/vue-vault'

const sessionJwt = 'REPLACE_WITH_SESSION_TOKEN'

function onClose() {
  console.log('closed!')
}

function onReady() {
  console.log('ready!')
}
</script>

<template>
  <main>
    <VueVault :token="sessionJwt" :on-close="onClose" :on-ready="onReady" v-slot="vaultProps">
      <button @click="vaultProps.open()">Open</button>
    </VueVault>
  </main>
</template>

Props

Demo

See a working demo here