For the complete documentation index, see llms.txt. This page is also available as Markdown.

Getting Started

Getting Started with VGS CMP

Welcome to the VGS Credential Management Platform! This guide will help you quickly set up your sandbox environment and begin managing your tenants.

1. Create a Sandbox Tenant

Start by creating a sandbox (test) tenant. This allows you to create your organization and experiment with the APIs without affecting your production environment.

Currently, VGS offers two Dashboard experiences that support Sandbox tenant creation:

  • VGS Dashboard: A unified dashboard experience that supports both Credential Management Platform and Secure Data use cases. This dashboard supports all current-state secure data tooling, as well as Sandbox tenant creation, payment credential search, visibility on individual credential details, and configuration of CMP tenants.

Create a Sandbox tenant through the VGS Dashboard (preferred):

  1. Log in and authenticate to the VGS Dashboard, and confirm that your preferred Organization is selected as the active Organization first - this is the Organization the account will be associated to. You can set your active Org by using the dropdown menu next to the title of the Organization reflected in the upper-left of the dashboard. To manage your Organizations, go to Organization Settings.

  1. Navigate to the 'Tenant' scope selector, and select "Create new tenant"

  1. Follow the guided experience to create a Sandbox account. Sandbox accounts created through the VGS Dashboard are enabled for credential management by default, and preconfigured with all available services.

  2. Once the Sandbox tenant is created, locate the Tenant ID by navigating to Tenant Settings.

  • Vault Dashboard: A distinct experience for users of VGS Secure Data products and services, with support for vault/tenant creation, service tenant creation, access credential creation, notifications, route set up, VGS Collect, vaulting, and more.

Create a Sandbox tenant through the Vault Dashboard
  1. Log in and authenticate to the Vault Dashboard and locate the Vault dropdown in the header. Beneath the name of each Vault (also known as a Tenant), an alphanumeric ID is visible. Note: To change the name of a Vault/Tenant, navigate to Vault Dashboard > Vault > Vault settings.

  2. Click the "+New" element within the dropdown to initiate the process of opening a new Sandbox account.

  3. Define a name, region, and confirm the Vault/Tenant environment as Sandbox, then click 'Create Vault.'

  4. Once the Vault/Tenant is created, locate alphanumeric Tenant ID and follow the next steps.

Please note that for security reasons, all dashboard experience sessions automatically expire after 20 minutes.

2. Set Up Services

Sandbox tenants created within the VGS Dashboard are enabled for credential management by detault, and are created preconfigured with all available services enabled.

To create a Sandbox tenant that is not enabled for credential management, please use the Vault Dashboard.

If not relying on the Dashboard experience, follow these steps to begin managing your tenants:

  • Locate Your Tenant ID: Identify and record your Tenant ID (also referred to as a Vault Id), which is the unique identifier for your tenant. This identifier always begins with prefix tnt, and can be found under Tenant Settings.

  • Identify Your Services: Choose the desired card services from the Configuration Options section to tailor your tenant to your specific needs.

  • Contact Customer Support: Once you have identified which services you want applied to the Sandbox tenant, contact support@vgs.io with your Tenant ID to assist with tenant creation.

What happens when I'm done testing and ready to take my changes Live?

When you're ready to begin leveraging VGS in your real business environment, use the Activate Organization option in 'Organization Settings' in the VGS Dashboard. You'll be asked to submit necessary business data, agree to our Standard Master Services Agreement, and begin collaborating directly with our customer success team. If you have specific questions about activating an existing tenant from Sandbox to Live, reach out to support@vgs.io

The next section will cover key actions needed to properly authenticate your new tenant and ensure credential data flows securely.

Last updated