liveBook · Manning

Tenant

As explained in Software Security for Developers

A tenant is an independently scoped organization or customer population sharing an identity system while retaining separate users, configuration, and access boundaries.

A tenant is an independently scoped organization or customer population sharing one identity system while keeping its users, settings, roles, and access boundaries separate. OIDC multitenancy lets a single identity provider serve multiple tenants without mixing their identities or permissions. section 13.4 section 13.5

Use tenant boundaries when one platform serves:

  • Multiple SaaS companies or customer organizations with separate users, data, and access controls. section 13.4
  • Enterprise departments, business units, customers, vendors, or partners requiring tailored authentication. section 13.4
  • Different login providers, such as Google, Azure AD, or a native system, routed according to tenant. section 13.5

Preventing tenant mix-ups

Use tenant-specific login URLs and issue tokens containing a tenant-specific claim such as tenant_id. Applications can then associate the authenticated user and permissions with the intended tenant rather than accepting an ambiguous identity. section 13.5 section 13.6

{
  "sub": "user567",
  "tenant_id": "megamart",   #1
  "role": "inventory_manager",
  "permissions": ["view_reports", "manage_suppliers"]
}

A token example makes the boundary visible: tenant_id identifies the organization, while role and permissions describe that user’s allowed actions within it. section 13.4

How Software Security for Developers covers it

How deep it goes
Explains tenant separation, routing, claims, login methods, roles, and sessions, but stops short of implementation code.
Examples
Uses SaaS platforms, enterprise units, customer portals, multiple login providers, and tenant_id-bearing tokens.
What it assumes
Assumes basic identity-system concepts while distinguishing OIDC authentication from OAuth 2 access authorization.
What you can do after
Design tenant-aware identity flows with tenant-specific URLs, claims, login providers, roles, sessions, and permissions.
How it connects
Connects tenants with OpenID Connect, identity providers, claims, roles, permissions, authentication, and access control.

Also explained in

Compare how 4 books explain tenant →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Software Security for Developers. The section links point to the parts of the book it draws on.