Identity and RBAC
Purpose
TheExplains how authentication and authorization work across the hierarchy, and how the CMSisenforcesbuiltleast-privilegeon a hierarchical model that reflects both technical resource allocation and commercial relationships.access.Platform AdministratorsAuthentication- Supports
OwnCMS credentials andoperatefederatedthe CMS instance. Responsible for global configuration, branding, pricing, and overall governance.Publish the plans and offers that define what downstream consumers can access.
DistributorsRepresent the top commercial tier beneath the platform.Manage one or more partners and receive commission structures defined at the distributor level.Can view aggregated billing, usage, and commission data across all associated partners and tenants.
PartnersManage tenants directly and act as the customer-facing entity.Receive commission rates defined either at the partner level or inherited from their distributor.Responsible for tenant onboarding, subscription assignment, and first-line customer support.
TenantsRepresent the consuming organizationssign-in (e.g.,endMicrosoftcustomers or internal business units)Entra).- Tokens
Eacharetenantvalidatedisforisolatedissuer, audience, lifetime, andmanages its own subscriptions, users, and administrators. - Federation
Billingsettingsandcontrolusagewhether CMS login and/or Entra/Google login aretrackedallowed.
attheAuthorization
tenantmodeland- Role-based
level,access control withvisibilitybuilt-inextendedroles aligned to theparenthierarchy. - Access
andisdistributor.scoped to the entity where the role is granted (platform, distributor, partner, tenant).
subscriptionpartnerSubscriptionsCommon roles (illustrative):- PlatformAdministrator
The/unitPlatformReaderof/consumption within a tenant. - DistributorAdministrator
Each/subscription is tied to a published plan, which defines available services and quotas. - PartnerAdministrator
Usage/dataPartnerReader - TenantAdministrator
collected/per subscription and feeds into billing and commission calculations.
isPlansScope andOffersinheritance- Roles
do not leap across unrelated branches. A
planPartnerdefinesadminservicecannotavailabilitysee a Tenant owned by a different Partner. - Platform roles supersede lower scopes for operations and
quotassupport.
Audit and accountability
- All sensitive actions (pricing, commission, usage processing, role assignment) should be traceable to an authenticated identity.
- Logs and audit trails enable operational forensics and compliance reporting.
Federation controls (examples)
- Settings can enable/disable specific identity paths (e.g.,
VMallowsizes,Entrastorageonly).limits, network allocations). - First-login
MultiplechecksplansshouldcanenforcebeMFAbundled into an offer to provide a combined service package. Platform administrators publish plansrequirements andoffers,passwordwhichchangearewherethen assigned downstream to subscriptions.
Why This MattersThis model ensures that bothtechnical operations(resource allocation, usage metering) andcommercial operations(billing, pricing, commissions) are aligned.Distributors see their margin and aggregate activity across partners.Partners focus on tenant-level management and customer billing.Tenants consume services without needing awareness of the upstream layers.
- Supports