Naar de inhoud
maarten.
Moderne appartementengevel met kleurrijke geometrische patronen en balkons in Amsterdam.
Alle stories

Multi-tenant software ontwerpen

Maarten Soetens 11 min lezen

Bij multi-tenant software gebruiken meerdere klanten dezelfde applicatie, terwijl hun gegevens gescheiden moeten blijven. Lees hoe gedeelde databases, aparte schema’s en afzonderlijke databases zich tot elkaar verhouden, en welke keuzes nodig zijn voor tenantidentificatie, autorisatie en beheer.

Gegevensisolatie begint bij het dreigingsmodel

Gegevensisolatie draait om het principe dat een tenant alleen eigen, toegestane gegevens kan zien of aanpassen. Je eerste gedachte gaat misschien uit naar de database, maar die laag lost niet alles op. Zelfs een API-bug, exportfout of slordigheid in beheerfuncties kan de grens alsnog omzeilen. Dus kijk eerst goed: wie en wat moet er bij welke data kunnen? Bepaal welke processen data mogen lezen of schrijven, en waar die routes kruisen.

Let op, fouten zijn niet altijd kwaadwillend. Een vergeten filter in een rapport is iets anders dan iemand die bewust een tenant-ID in een verzoek wijzigt. Maar voor beide situaties heb je meerdere beschermlagen nodig. Denk aan autorisatie in je software, restricties op database-niveau, beheer alleen via gecontroleerde workflows en tests die checken dat toegang tot andere tenants geblokkeerd blijft.

Bepaal tenslotte vooraf wat een incident betekent voor jouw toepassing. Is het alleen configuratie van een SaaS dashboard die uitlekt, of praat je over salarisadministratie? Zo’n verschil beïnvloedt onder andere je logging, bewaartermijnen en het soort encryptie. Ook of je alles samen opslaat of liever gescheiden houdt. Wie het dreigingsmodel achterwege laat, focust te snel op technische voorkeuren en mist snel de echte kwetsbaarheden. Voor de technische uitwerking kan een PHP developer helpen.

Gedeelde database met tenant-ID’s in tabellen

Heb je een gedeelde database, dan stop je records van alle tenants simpelweg in dezelfde tabellen. De kolom tenant_id wijst elk record aan een bepaalde klant toe. Dit is heel gangbaar als applicaties voor veel tenants grotendeels dezelfde tabellen nodig hebben. Eén database per klant hoef je niet te beheren, migraties zijn overzichtelijk, en gezamenlijke rapportages zijn makkelijk mogelijk.

Hier loopt het vaak mis op één punt: filters. Eén gemiste tenant_id in een query, en data steekt de grens zomaar over. Zeker als queries over verschillende modules zijn verspreid (backend, jobs, exports), is discipline belangrijk. Maak dit dus standaard: altijd de tenant als filter aanroepen, liefst centraal geregeld. Indexeer de tenant_id in tabellen die per tenant uniek moeten zijn, zoals e-mailadressen. Wat uniek lijkt bij de klant, hoeft in het geheel namelijk niet uniek te zijn.

Soms kun je rijen ook op database-niveau scheiden, bijvoorbeeld met Row Level Security. Maar let op: dat werkt alleen als de context per verbinding klopt, anders filtert de beveiliging niet goed. Test je code altijd met verschillende tenants die dezelfde ID’s gebruiken; zo zie je of filters echt werken. Deze aanpak benut de infrastructuur efficiënt, maar je moet scherp blijven bij iedere datavraag. Deze keuze hangt ook samen met afwegingen rond SQL of NoSQL.

Aparte schema’s per tenant als tussenvorm

Bij gebruik van aparte schema’s organiseer je tabellen van elke tenant onder een eigen naam in één database. Dit voelt duidelijker afgebakend dan alleen een tenantkolom, maar zonder dat je een wirwar van databaseverbindingen krijgt. Het past bij situaties waarin scheiding wel wenselijk is, maar de structuur per klant gelijk blijft.

Het echte werk verschuift nu naar je beheer en querylogica. Je app moet altijd het juiste schema kiezen voor elke handeling. Als de namen van schema’s toevallig uit gebruikersinput kunnen komen, open je makkelijk een nieuw beveiligingslek: valideer die keuze dus strikt vanuit jouw interne tenancy-informatie. En zorg dat migraties àltijd alle schema’s meenemen, want een versieachterstand per tenant is zo opgelopen.

Houd in je achterhoofd dat de technische scheiding operationeel minder streng is dan bij losse databases. Fouten, resourceproblemen of verkeerde settings slaan vaak door naar meerdere tenants. Of herstel van één schema kan, hangt af van het type database en hoe die back-ups toelaat. Schema’s alleen geven geen harde scheiding; je beleid, toegang en beheer moeten de rest doen.

Afzonderlijke databases per tenant

Besluit je om elke tenant een eigen database toe te wijzen, dan scheid je data fysiek of logisch op DB-niveau. Handig als klanten eisen stellen aan opslaglocatie, herstel of piekbelasting, of gewoon strengere isolatie willen. Omgekeerd: als er iets gebeurt, weet je meteen welke database erbij hoort.

Dit model vraagt wel organisatorisch meer. De applicatie moet telkens richting de juiste database verbinden, je wil migreren, back-uppen en monitoren per database. Dat is handwerk tot je genoeg automatiseert, want bij veel tenants wordt het anders onwerkbaar. Denk dus vooruit: bouw automatische provisioning, versiecontrole en logging voor wijzigingen, zodat je precies bijhoudt welke database wanneer gewijzigd is. Houd er ook rekening mee dat niet iedere tenant tegelijk op dezelfde versie hoeft te zitten.

Overigens, ook nu is een foute koppeling zo gemaakt: een verkeerd geconfigureerde router kan verkeer alsnog naar een database van een andere klant sturen. Behandel je tenant-naar-database mapping dus als gevoelige configuratie, bewaak toegang en wijzigingen. En: gezamenlijke fora, rapportages of cross-tenant gebruikers vragen expliciete functies, niet een ongemerkte samenvoeging van databases.

Voor de technische uitwerking kun je een freelance developer inschakelen.

Tenantidentificatie in verzoeken en achtergrondtaken

Jouw app moet weten voor welke tenant een verzoek geldt, anders werkt isolatie niet. Die tenant haal je uit het subdomein, een organisatiekeuze na login, claims in een tokentje, een API-key... het verschilt per product. Maar één ding verandert niet: die context moet je na validatie expliciet, gecontroleerd doorgeven in je applicatie. Laat je een client de tenant-ID invullen, dan is dat nog geen bewijs van rechten.

Dus: check altijd de rechten van de aangemelde gebruiker tegen de gekozen tenant. Misschien heeft iemand toegang tot meerdere tenants, maar niet tot elke organisatie die ze via een URL kunnen invullen. Is er verwarring tussen domein, token of sessie? Dan liever geen automatische fallback, maar een duidelijke foutmelding.

Voor achtergrondtaken gelden dezelfde spelregels. Een task of queuebericht moet ondubbelzinnig de tenant bevatten. Gebruik je gedeelde processen (zoals workers), dan moet oude context eerst worden opgeschoond. Geef de tenant-ID expliciet mee, valideer die nogmaals, en zorg dat logs alleen de nodige context bevatten. Gooi tenantdata niet zomaar in foutmeldingen of externe monitoring tenzij het strikt nodig is.

Autorisatie voorkomt toegang over tenantgrenzen

Wie je bent (authenticatie) is wat anders dan wat je mag binnen een tenant (autorisatie). Alleen weten dat iemand bij tenant X hoort is niet genoeg. Controleer steeds of de gebruiker echt lid is, en of diens rol de gewenste actie mag doen. Niet alleen in de UI, maar ook op API, download, export en zelfs in background-processen moet dat beleid gelden.

Baseer rechten niet op onvoorspelbare sleutels. Een UUID lijkt lastig te raden, maar dat maakt geen toegangscontrole. Bij elke datapull moet je checken óók op tenant én toegestane rol. Zo voorkom je dat iemand met een ID uit een andere context alsnog data oppikt. Ook als je relaties tussen objecten legt (bijvoorbeeld: een factuur aan een klant hangen), moet dat binnen dezelfde tenant gebeuren.

Beheerderstoegang werkt weer anders. Interne medewerkers hebben soms breder zicht, maar elk extra recht vergroot de schade bij accountproblemen. Gebruik tijdelijke rechten, log gevoelige acties en toon wie wat doet. Tests zijn niet compleet als je alleen toegang van bevoegde gebruikers checkt. Controleer juist óók dat anderen buiten blijven; een vergissing valt pas op als toegang actief geweigerd wordt.

Migraties, back-ups en herstel per tenant

Hoe je database is opgezet, bepaalt veel over het uitvoeren van updates of herstelacties. In één gedeelde database voer je modificaties meestal één keer uit, maar een fout raakt alles. Bij aparte schema’s of databases draai je hetzelfde script meerdere keren. Dan telt de volgorde, registratie van voortgang en een aanpak voor fouten, je wilt precies weten wie waar blijft hangen.

Maak wijzigingen stapsgewijs waar het kan. Begin met nieuwe structuren die naast het oude kunnen bestaan, zodat je beide even ondersteunt. Overschrijf of verwijder pas als alles is omgeschakeld. Let vooral op bij omgeving waarin tenantdatabases in verschillende stadia kunnen zitten; deels geslaagde migraties mogen niet tot onduidelijke situaties leiden. Registreer resultaten per tenant en zorg dat de migratie te hervatten is zonder nieuwe risico’s.

Back-ups zijn nutteloos als herstel niet kan zoals jij wilt. Check dus altijd of je per tenant kunt terugzetten, zonder andermans data aan te raken. In gedeelde tabellen vraagt dat misschien handmatige exports, bij losse databases lijkt dat simpeler maar versie- en configverschillen blijven tellen. Vergeet de bestanden en metadata buiten je database niet. Ook bij herstel mag je niet ongemerkt over tenantgrenzen heen glippen.

Tenantbeheer en operationele scheiding

Een tenant is meer dan een nummertje in de database. Denk ook aan status, gekoppelde domeinen, lidmaatschappen, instellingen, locatie van opslag en links met externe systemen. Leg vast wie welke onderdelen mag aanpassen. Je wilt niet dat een verwisseling van een domein of databaseadres ineens verzoeken naar het verkeerde account stuurt.

Maak de levenscyclus concreet: aanmaken, activeren, blokkeren, wijzigen, verwijderen. Het eerste provisioning-script moet direct de rollen, instellingen en monitoring goed inregelen. Is een tenant geblokkeerd of verwijderd, dan mag je niet via een verouderde sessie, API-key of taak toch nog toegang krijgen.

Operationeel: dashboards moeten tenantinformatie tonen zonder dat deze als autorisatiemiddel wordt gebruikt. Beperk overbelasting: laat niet toe dat één klant de volledige resource opslokt. Bij gedeelde infra kun je met quotas werken, bij losse databases tellen beheerlast en connecties op. Door alles tenantgericht te monitoren, zie je sneller wie wat doet en waar het spaak loopt. Werk ook logging en foutafhandeling zorgvuldig uit.

Veelgestelde vragen

Hoe kies ik de juiste databasearchitectuur voor mijn multi-tenant applicatie?

Kies de databasearchitectuur op basis van risico, herstelbehoeften en beheerlast, niet alleen op basis van het verwachte aantal tenants. Bepaal eerst hoeveel schade een tenantoverschrijdend incident kan veroorzaken en of klanten eisen stellen aan afzonderlijke opslag of datalocatie.

  • Vergelijk de modellen op kosten, operationele complexiteit en mogelijkheden voor tenantgericht herstel.
  • Test hoe migraties, rapportages en beheerfuncties in elk model werken.
  • Begin met een model dat je team veilig kan beheren en plan vooraf hoe tenants later kunnen worden verplaatst.

Een kleine praktijkproef met representatieve gegevens en hersteltests maakt aannames over prestaties en beheer vaak eerder zichtbaar dan een theoretische vergelijking.

Hoe verplaats ik een tenant naar een aparte database zonder gegevensverlies?

Verplaats een tenant met een gecontroleerd migratieproces waarin je gegevens kopieert, controleert en pas daarna het verkeer omschakelt. Leg vooraf vast welke tabellen, bestanden, instellingen en externe koppelingen bij de tenant horen, zodat de verhuizing geen afhankelijke gegevens overslaat.

  • Maak een consistente kopie en vergelijk aantallen, sleutels en belangrijke totalen met de bron.
  • Beperk of pauzeer schrijfacties tijdens de laatste synchronisatie, of gebruik een gecontroleerd wijzigingslog.
  • Schakel de tenant-routering pas om nadat controles slagen en houd een terugvalplan klaar.

Voer de procedure eerst uit in een testomgeving en meet hoe lang kopiëren en controleren werkelijk duren. Zo kun je downtime beperken zonder een ongeteste dubbele schrijfroute te introduceren.

Hoe voorkom ik dat één tenant de prestaties van andere tenants vertraagt?

Voorkom dat één tenant de prestaties van anderen domineert door gebruik te meten en grenzen te stellen aan gedeelde resources. Een gedeelde database kan technisch goed geïsoleerd zijn, maar zware rapportages, grote imports of veel achtergrondtaken kunnen alsnog capaciteit van andere klanten gebruiken.

  • Stel limieten in voor verzoekfrequentie, gelijktijdige taken en omvangrijke exports.
  • Gebruik wachtrijen met eerlijke verwerking, zodat één tenant niet alle workers bezet.
  • Monitor responstijden, databasebelasting en wachtrijlengte per tenant.

Maak overschrijdingen zichtbaar en bepaal vooraf of je taken vertraagt, afwijst of naar een aparte capaciteit verplaatst. Test limieten met piekbelasting, zodat ze ook onder druk voorspelbaar werken.

Hoe beheer ik datalocatie-eisen voor verschillende tenants?

Beheer datalocatie-eisen door per tenant vast te leggen in welke regio gegevens mogen worden opgeslagen en verwerkt, en door die keuze technisch af te dwingen. Alleen een regionale database is niet voldoende als bestanden, back-ups, logs of externe verwerkingsdiensten buiten die regio terechtkomen.

  • Registreer de toegestane regio als gecontroleerde tenantconfiguratie.
  • Routeer opslag, back-ups en herstelacties op basis van die configuratie.
  • Controleer ook de locaties van monitoring, exports en gekoppelde diensten.

Leg vast wat er gebeurt wanneer een regio niet beschikbaar is: uitwijken naar een andere regio kan in strijd zijn met de eis. Test daarom ook herstelprocedures en wijzigingen van regio, inclusief de verplaatsing en verificatie van bestaande gegevens.

Welke gegevens moet ik per tenant monitoren om problemen snel te herkennen?

Monitor per tenant vooral gegevens die helpen om fouten, capaciteitsproblemen en ongebruikelijke toegangspatronen te onderscheiden. Zonder tenantdimensie kunnen gemiddelden over de hele omgeving verbergen dat één klant structureel fouten ervaart of uitzonderlijk veel resources gebruikt.

  • Meet foutpercentages, responstijden en aantallen verzoeken per tenant.
  • Volg wachtrijvertraging, opslaggroei en mislukte achtergrondtaken.
  • Registreer relevante wijzigingen in tenantstatus, domeinkoppelingen en gegevensroutering.

Beperk toegang tot deze informatie en voorkom dat gevoelige inhoud in logs belandt. Gebruik tenant-ID’s om incidenten te onderzoeken, maar stel bewaartermijnen en toegangsrechten zo in dat monitoring zelf geen onnodige gegevensbron wordt.

Foto: Jan van der Wolf

Portret van Maarten

Maarten

Freelance developer in Nijmegen

Even kennismaken?

Vertel kort wat er speelt. Dan hoor je wat er kan, wat ik anders zou doen en waar AI bij jou wél en niet iets toevoegt. Vrijblijvend.

Het kantoor in Nijmegen
© 2026 maarten.online Sitemap Privacy Algemene voorwaarden
Het kantoor in Nijmegen

Maarten.

Freelance developer in Nijmegen. Liever direct contact? Dat kan ook.

Kennismaken

Laat je gegevens achter, dan kijken we of het klikt. Vrijblijvend en zonder verkooppraat.

Maarten

Stuur een bericht via WhatsApp

Hoi! Waar kan ik je mee helpen?

nu