Skip to content
plugboard.appRequest a demo

Security and privacy

Tenant isolation

Tenant-owned records are scoped to an institution. Authentication and permissions control which records a request may use; the hostname selects its tenant context.

The shared database wrapper adds tenant conditions and sets transaction-local tenant, campus and department context. Request guards establish the caller’s identity and permissions before the operation.

Production Compose runs the API as the restricted PostgreSQL app_user role and applies row-level security policies. These provide an additional database check on tenant access. Migration commands use a separate owner connection.

The supplied demo Compose and native launcher use a database-owner connection, which can bypass row-level security. Their application checks still run, but they do not provide the same independent database boundary. Verify the deployed database role and policies when assessing a particular installation.

A server of your own. One customer per machine, in the region you chose. No other school’s deployment runs on it, and the provisioning system refuses to place one there. Your database and your secrets are on that machine’s disk. Its server backups are kept by the hosting provider in the same region, and an encrypted offsite copy is held on Cloudflare R2 by a location hint: Oceania, best effort, for an Australian school.

Some things are shared across customers: the control plane that holds licences, billing and the list of deployments (no school records, and after go-live no key that opens a school’s data), Cloudflare in front of every deployment, the container image, the hosting provider, and the escrow: every managed school’s master key is also encrypted to one offline key we hold, never on a server, so a school can be rebuilt from its offsite backups if its server and the provider’s backups of it are both lost. See what we hold on managed hosting. A self-hosted deployment is whatever machine you run it on, and every institution on it shares one database.

That changes three answers:

  • Where the data is is the physical location of one machine, not a setting in a shared system.
  • What another school’s fault can reach is nothing of yours: a fault, a spike or an overloaded database on another customer’s deployment is on another customer’s machine.
  • What deleting your data means is deleting the machine and its backups, rather than removing your rows from tables you share with other schools.

“Can another school see our data?” No. On managed hosting there is no other school on your server to see it, and each customer has a separate database on a separate machine. The application and database separation described above applies as well, and is what keeps two campuses of one group apart within a single deployment. On a self-hosted deployment serving several institutions, that separation is the only boundary between them.

“Can your staff see our data?” Plugboard support reaches a managed deployment through a support channel that opens nothing until your school grants support access, for a set time and with a reason. Every support request is recorded in your audit log before it reads anything. Your master key is also held in escrow, as ciphertext the control plane cannot open. Hosting administrators’ access to the server we run for you is separate from that setting: it is governed by our administrative access control. Self-hosted provisioning issues no support key; you control any access you separately arrange.

“What happens if there is a bug?” Independent database checks in production Compose reduce the consequences of application mistakes. They do not replace authorization tests, security updates or deployment review. Owner connections and infrastructure administrator access need separate controls.

“Where is the data?” Answered in regions and data residency.

A group with several campuses can run several institutions on one deployment, which is what the included count on a plan refers to.

Each campus gets its own people, devices, workflow, branding and roles, and the separation between them is the same as between two unrelated schools.

If you want campuses to share data, make them one institution with several locations instead.

A request is matched by hostname. If your desk is at helpdesk.yourschool.org, that address is recorded against your institution and every request to it lands in your data.

Two consequences:

  • Changing your address is a real change. See your own domain.
  • Unknown tenant means the address does not match the one recorded. It is a one-line fix, covered in troubleshooting.

Health and metrics endpoints skip this, so monitoring keeps answering when nothing else does.

Live updates are filtered by institution before anything is sent, so you see only your own.