About Gateway

The gateway is a unifying service in the Vidos ecosystem that provides a centralized entry point for clients to access the various Vidos services. It functions as an intelligent routing layer that simplifies integration, manages service discovery, and coordinates complex workflows across multiple services.

Why use a Gateway?

When your application needs to interact with multiple Vidos services as part of a verification workflow, the gateway provides simplified access through a single endpoint. Using the gateway:

  • Reduces integration complexity by providing a unified API
  • Enables consistent authentication and authorization across services
  • Simplifies service discovery and versioning
  • Supports complex workflows spanning multiple services
  • Provides centralized logging and monitoring

The gateway makes it easier to build applications that leverage the full power of the Vidos ecosystem.

What is a Gateway?

A gateway is a specialized service that acts as an intermediary between client applications and the underlying Vidos services. Unlike individual services that focus on specific functions (verification, resolution, etc.), the gateway orchestrates interactions across multiple services.

The gateway works by:

  1. Receiving requests from client applications
  2. Routing these requests to appropriate backend services
  3. Orchestrating complex workflows that span multiple services
  4. Aggregating responses and returning unified results
  5. Managing cross-cutting concerns like authentication and logging

Gateway Architecture

The gateway in Vidos has two main components:

  1. Gateway Service: The core implementation that handles routing, orchestration, and client interactions
  2. Gateway Management Service: Enables configuration and management of gateway instances

Vidos supports creating multiple gateway instances, each with its own configuration, to support different integration requirements across your organization.

┌─────────────────────┐ │ Applications │ └──────────┬──────────┘ │ ▼ ┌──────────────────────┐ │ Gateway Instance │ └──────────┬───────────┘ │ ▼ ┌───────────────────────────────────────────┐ │ Service Connectors │ ├─────────┬─────────┬─────────┬─────────────┤ │Resolver │Verifier │Validator│Authenticator│ └─────────┴─────────┴─────────┴─────────────┘

Use Cases

The gateway service supports various integration scenarios:

  • API unification: Provide a single consistent API for all Vidos services
  • Workflow orchestration: Coordinate complex verification processes across services
  • Multi-tenant deployments: Support multiple client organizations with isolated configurations
  • API versioning: Manage API evolution while maintaining backward compatibility
  • Cross-service monitoring: Provide unified insights into service performance and health

By providing these capabilities, the gateway simplifies integration of Vidos services into your applications.

Summary

The gateway is a powerful service in the Vidos ecosystem that:

  • Simplifies integration through a unified API
  • Orchestrates complex workflows across multiple services
  • Manages cross-cutting concerns like authentication and logging
  • Supports service discovery and versioning
  • Enables comprehensive monitoring and troubleshooting

By providing a centralized entry point to the Vidos ecosystem, the gateway makes it easier to build robust, scalable verification solutions.