Managing Verifier Instances

This guide shows you how to create, configure, and manage verifier instances in Vidos. You'll learn how to set up instances with specific configurations, control their status, and integrate them into your applications to verify Verifiable Credentials (VCs) and Verifiable Presentations (VPs).

Prerequisites

Before you begin, ensure you have:

  • A Vidos account with appropriate permissions
  • Access to the Vidos dashboard
  • Basic understanding of Verifiable Credentials and their verification requirements

Creating a Verifier Instance

Verifier instances let you configure specific verification capabilities for different applications, environments, or use cases.

Steps to Create an Instance

  1. Navigate to the Verifiers 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-VC-Verifier" or "Testing-Credential-Verifier")
  4. Configure the instance settings:
    • Select the verification policies to enable
    • Configure the supported credential types and formats
    • Set any additional parameters required for your use case
  5. Click Save to create the instance
TIP

Create separate verifier 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 verifier instance, consider these configuration options:

  • Verification Policies: Select which verification policies (Format, ValidAt, Proof) your instance will enforce
  • Credential Types: Configure which credential types (VC V1.1, VC V2.0, VP V1.1, VP V2.0) your instance will support
  • Cryptosuites: Select the cryptographic suites your instance will accept for verification
  • CORS Settings: Configure Cross-Origin Resource Sharing for web applications

Managing Instance State

Control the availability of your verifier 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 verifier instance will cause all verification requests to that instance to fail. Ensure all dependent systems are notified before stopping an instance in production.

Viewing Instance Logs

Access detailed logs to understand verification outcomes and troubleshoot issues:

  1. Navigate to the instance details page
  2. Select the Logs tab
  3. Use filters to narrow down log entries by time period, log level, or keywords
  4. Look for specific error messages or verification outcomes