Rabbinatix
Sign inGet started
Store

Multi-tenant SaaS with single sign-on

FreeSystem map
@rabbinatix/multi-tenant-sso-architecture by Rabbinatixupdated Oct 13, 2026

Each customer company is its own tenant. Its people sign in through the company’s identity provider; an admin console manages tenants, roles and the bill.

7 systems and 12 APIs. Every API is declared on both sides, so every contract starts healthy. Rename or change anything once it is on your map.

As the map's Connections view shows it: traffic flows from the system that calls to the system it calls.

10 connections · 12 APIs

  • Web App → Auth Service
    • POST/api/v1/sso/startStart single sign-on for a company domain
    • POST/api/v1/auth/refreshSwap a refresh token for a new session
  • Tenant Admin Console → Auth Service
    • POST/api/v1/sso/startStart single sign-on for a company domain
    • POST/api/v1/auth/refreshSwap a refresh token for a new session
    • GET/api/v1/tenants/{tenantId}/membersThe tenant’s members and roles
    • PUT/api/v1/tenants/{tenantId}/ssoConnect the company’s identity provider
  • Identity Provider → Auth Service
    • POST/api/v1/sso/callbackThe identity provider sends the person back, signed
  • Auth Service → Identity Provider
    • GET/.well-known/openid-configurationThe provider’s sign-in settings and keys
  • Product API → Auth Service
    • POST/internal/v1/tokens/verifyCheck a token and say whose tenant it is
  • Web App → Product API
    • GET/api/v1/projectsThe tenant’s projects
  • Product API → Tenant Database
    • POST/queryRead or write rows, always filtered by tenant
  • Tenant Admin Console → Product API
    • GET/api/v1/billing/subscriptionThe tenant’s plan and seats
  • Product API → Billing Provider
    • POST/v1/subscriptionsStart or change a tenant’s subscription
  • Billing Provider → Product API
    • POST/api/v1/webhooks/billingThe provider tells us a subscription changed

Systems (7)

Web App
The product, under each tenant’s own address.
Tenant Admin Console
Where a customer’s admins manage members, roles and single sign-on.
Product API
The product’s data, always for one tenant.
Auth Service
Tenants, members, roles, sessions and single sign-on.
Tenant Database
Every row carries its tenant.
Identity Provider
The customer’s own sign-in, like Okta, Microsoft Entra ID or Google Workspace (SAML or OIDC).
Billing Provider
Subscriptions per tenant, like Stripe or Paddle.

A system you already have under the same name is used, not copied. Outside APIs don't count towards your plan.

Versions