HomeGuidesAPI ReferenceChangelog
Log In
Guides

Multi-Tenancy

This page contains information to assist our customers with utilizing the Multi-Tenancy feature in RegScale. It describes what it is, why you would use it, the benefits, and provides instructions on getting started.

What is it?

The multi-tenancy feature is a way to logically carve up the RegScale application into separate instances which can be managed by the customer as a single installation. This is not like traditional multi-tenancy where the application is cloud-hosted and many tenants are managed in a single Software as a Service (SaaS) instance. RegScale can run anywhere (on premises, classified/air-gapped networks, and within the customer's cloud (i.e. AWS VPC)). Instead of forcing our customers to the cloud, we bring cloud functionality to their installation; wherever they may choose to run it. How it works:

  • Single database where every record has a defined tenant
  • All tenant IDs are tied to users which are set on the server side to avoid client spoofing
  • No ability to move across tenants with a single user
  • NOTE: Only the "Global Admin" (the break glass account) can be used to create new tenants and its permissions are limited to setup tasks only

Why would you use it?

There are many reasons to use this feature which include:

  • Establishing need to know controls across groups
  • Allowing custom configurations for different groups (i.e. modules enabled, workflows, custom fields, etc.)
  • Establishing discrete authentication and role-based access control per instance
  • Consolidating separate tools into a single RegScale instance
  • Supporting separate compliance functional areas in a single install (i.e. safety, internal audit, cyber security, environmental, etc.)

What are the benefits?

This feature has multiple benefits for an organization; to include:

  • Enhanced flexibility - configure separately amongst different constituent groups without having to enforce standardization where it doesn't fit. Deploy anywhere without being forced into a shared SaaS instance in the cloud.
  • Improved security - limits access to specific groups and even allows setting different authentication mechanisms across tenants
  • Cost savings - allows large organizations to consolidate multiple compliance tools into a single RegScale instance
  • Reduced Operations and Maintenance - only one install to manage across all of the different tenants resulting in less patching, upgrades, backups, etc.

How do I use it?

Instructions for using this feature are provided below:

  • NOTE: Multi-tenancy is only available in Enterprise Edition and not available in the free Community Edition of RegScale
  • Login using the "Global Admin" (break glass) account
  • You should be directed to <{yourDomain}/admins/tenants>
  • If not:
    • Click the admin name in the top right
    • Scroll down to "Configuration"
  • This page shows the licensing information (number of licensed users and expiration date) and tenant list
  • Click "View" to display or change any tenant information
  • Click "Create New" to add a new tenant
  • NOTE: This account has limited permissions. It should be used to create a tenant, create the first Administrator, and then all subsequent work should be done using the new Administrator account.