Skip to Content
Getting StartedGetting Your Tenant

Getting Your Tenant

Overview

Digital Trust Foundry operates as a multi-tenant platform where each organization gets its own isolated tenant. This guide explains how to obtain your tenant and how its first administrator gets access.

Instances and Tenants

What are Instances?

Instances are regional deployments of the Digital Trust Foundry platform. Each instance operates independently and belongs to a region.

What are Tenants?

A tenant is your organization’s isolated environment within an instance. Digital Trust Foundry creates your tenant in one of its instances.

Each tenant has:

  • Unique subdomain: your-tenant.digitaltrustfoundry.com
  • Isolated data: Your data is kept separate from other tenants in the same instance
  • Independent configuration: Your own settings, API keys and user management
  • Dedicated identities: Your own cryptographic identities and signing capabilities

Tenant Structure

Instance (e.g., US1)
└── Tenant (e.g., acme-corp)
    ├── Users
    ├── API Keys
    ├── Enterprise Identity (organizational AID, optionally vLEI-bound)
    └── Officer Identities (delegated signing authority)

Requesting a Tenant

Contact Digital Trust Foundry to request a tenant. Provide:

  • Your organization’s name
  • The subdomain you want. It must be 3 to 50 characters long, use only lowercase letters, numbers and hyphens, and start and end with a letter or number. Some names are reserved.
  • The first administrator’s first name, last name and email address
  • Optionally, a username for the first administrator. If you do not choose one, the email address is used as the username.

First Administrator Access

The first administrator signs in with Foundry Wallet from the start. No password is set for this account.

  1. Receive the invite. When your tenant is created, the first administrator receives an email titled “Set up your Foundry Wallet”. The link in it works once and is valid for 7 days. If the email doesn’t arrive within a few minutes, check your spam folder. If the link has expired, ask Digital Trust Foundry to send a new one.
  2. Install Foundry Wallet on the device you will sign from: the browser extension for Chrome, Edge or Brave on a computer, or the iPhone app. https://wallet.digitaltrustfoundry.com/get takes you to the right one.
  3. Create a passphrase. On a computer, open the Foundry Wallet extension from the browser toolbar and create a passphrase. It protects your keys, and only you know it. The iPhone app needs no passphrase: it is locked by Face ID or your device passcode.
  4. Connect the wallet. Open the link from the email in the browser where the extension is installed and click Connect Foundry Wallet. On the next page, click Connect this browser’s wallet (to use the iPhone app instead, scan the code shown on that page with the app).
  5. Sign in. Click Sign in with this browser’s wallet and approve the sign-in in Foundry Wallet. If you connected the iPhone app, approve the sign-in in the app.

From then on, sign in at https://your-tenant.digitaltrustfoundry.com with Foundry Wallet. The sign-in page finds the extension in your browser, or shows a QR code to scan with the iPhone app.

Sandbox Tenant

Overview

Sandbox tenants are for development, testing and evaluation. They provide the platform’s functionality and APIs in a sandbox instance, separate from production.

Key Features

  • Platform and APIs: The platform’s features and APIs, for building and testing your integration
  • vLEI test network: Request and verify vLEI credentials through a vLEI test network, without involving a Qualified vLEI Issuer
  • Test data: Safe to use with test credentials and sample data
  • No production impact: Operations in a sandbox tenant do not affect production

Sandbox Limitations

  • Test environment only: Not suitable for production workloads

Production Tenant

Production tenants are for live, operational use with real business data. To obtain one, contact Digital Trust Foundry. A production tenant is set up the same way as a sandbox tenant: the first administrator receives the same Foundry Wallet setup email.

Next Steps

After obtaining your tenant:

  1. Set up enterprise identity: See the Enterprise Identity section
  2. Add team members: Configure users and permissions in User Management
  3. Connect your systems: Enable connectors and create API keys in Integrations
  4. Start building: See the Quick Start Guide for a walkthrough
What is Digital Trust Foundry?Quick Start Guide
Getting Your Tenant | Digital Trust Foundry Docs