Managing Resolver Instances

This guide shows you how to create, configure, and manage resolver instances in Vidos. You'll learn how to set up instances with specific configurations, control their status, and integrate them into your applications.

Prerequisites

Before you begin, ensure you have:

  • A Vidos account with appropriate permissions
  • Access to the Vidos dashboard

Creating a Resolver Instance

Resolver instances let you configure specific DID resolution capabilities for different applications or environments.

Steps to Create an Instance

  1. Navigate to the Resolvers section in your Vidos dashboard
  2. Click the Add button to create a new instance
  3. Provide a descriptive name for your instance (for example, "Production-WebApp-Resolver" or "Testing-JWT-Resolver")
  4. Configure the instance settings:
    • Select the DID methods to enable
    • Configure CORS settings if needed for web applications
    • Set any additional parameters required for your use case
  5. Click Save to create the instance
TIP

Create separate resolver instances for different environments (development, testing, production) to maintain clear separation of concerns and prevent configuration changes in one environment from affecting others.

Instance Configuration Options

When creating a resolver instance, consider these configuration options. For complete details on all available options, see the Resolver Configuration Reference:

  • DID Methods: Select which DID methods (did:web, did:key, etc.) your instance will support
  • CORS Settings: Configure Cross-Origin Resource Sharing for web applications
  • Caching Parameters: Set how long resolved DID documents should be cached
  • Rate Limiting: Configure request limits to prevent abuse

Managing Instance State

Control the availability of your resolver instances with start and stop operations.

Starting an Instance

  1. Navigate to the instance details page
  2. Click the Start button
  3. Verify the instance status changes to "Running"

Stopping an Instance

  1. Navigate to the instance details page
  2. Click the Stop button
  3. Verify the instance status changes to "Stopped"
CAUTION

Stopping a resolver instance will cause all resolution requests to that instance will fail.

Next Steps

After creating and configuring your resolver instance, you might want to: