Skip to Content
DocumentationConceptsTenants

Tenants

The Tenants module adds Multi-tenant management to any Application.

Features

  • Multi-tenancy
  • Role-based access control (RBAC)
  • OIDC Authentication
  • Activity logging
  • AI Agent ready (A2A and MCP)
  • Seemless navigation
User authentication and login system
Account management dashboard
Subscription/billing management
User role and permission controls
Data encryption and security measures
Customer support system (chat, email, or help desk)
Onboarding process for new users
Notification system (email, in-app, etc.)
Usage analytics and reporting
Cloud-based data storage
Regular software updates and maintenance
API access for integrations
Mobile responsiveness or dedicated apps
Search functionality
User profile management
Password reset and recovery
Terms of service and privacy policy documentation
Data export/import capabilities
Activity logs and audit trails
Integration with payment processors
Multi-language support
Service status/uptime monitoring
Backup and disaster recovery systems
User feedback collection mechanisms
Settings and preference customization

Data Model

Service

A Service represents a collection of Graphs that work together to support the Tenants’ features.

{
  "id": "test3",
  "displayName": "Good",
  "serviceUrl": "http://localhost:8081",
  //"block": "vault",
  "variants": {
    "V1": {
      "version": "1.1.2-1232132",
      "visuals": {},
      "graph": {}
    }
  }
}

An OpenAPI specification is required for the Service to describe its interface and schema.

// RFC 8631 service-desc link relation
// https://datatracker.ietf.org/doc/html/rfc8631
app.get("/ds/api", (req, res) => {
  res.setHeader("Link", '</ds/api/v3/openapi.yaml>; rel="service-desc"');
  res.status(204).end();
});

Tenant

A Tenant represents a security boundary for managing access to resources provides by the particular Services that the tenant subscribes to.

{
  "id": "PGVtbD5tFj0zULr",
  "displayName": "Team 123"
}

A Tenant will have a Membership (User + RBAC).

The UI can be configured to represent a Tenant as a Family, Group, Workspace, or another word that is more contextual.

A Tenant can subscribe to one or more Services.

Activity

An activity audit is automatically recorded and searchable.

ErrorsIntegrations