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.
10 connections · 12 APIs
- Web App → Auth Service
POST /api/v1/sso/startStart single sign-on for a company domainPOST /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 domainPOST /api/v1/auth/refreshSwap a refresh token for a new sessionGET /api/v1/tenants/{tenantId}/membersThe tenant’s members and rolesPUT /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.
Also as a whiteboard
Versions
