Django Tenants URL¶

Official Documentation - https://tarsil.github.io/django-tenants-url/

Table of Contents¶

Django Tenants URL
Table of Contents
About Django Tenants URL
Dependencies
Motivation
Installation
Example
Documentation and Support
License

About Django Tenants URL¶

Django Tenants URL is a wrapper on the top of the django-tenants package that serves a different yet common use case, the multi-tenant implementation via HEADER and not using sub domains.

A special thanks to the team behind Django Tenants.

Dependencies¶

The project contains views, permissions, models and more addons that can be used across projects.

django-tenants-url is built on the top of the following dependencies:

Motivation¶

When implementing multi tenancy architecture there are many factors to consider and cover and those were greatly approached by django-tenants but so summarize, there are 3 common ways:

Shared schemas - The data of all users are shared within the same schema and filtered by common IDs or whatever that is unique to the platform. This is not so great for GDPR.
Shared database, different Schemas - The user's data is split by different schemas but live on the same database.
Different databases - The user's data or any data live on different databases.

As mentioned before, django-tenants-url is a wrapper on the top of django-tenants and therefore we will be approaching the second.

Many companies have limited resources (money, people...) and limited choices from those constraints. When implementing multi tenancy, the default would be to use subdomains in order to access the desired schema. E.g.:

www.mycompany.saascompany.com

My Company is the tenant of the saascompany.com that is publicaly available to the users. When the mycompany is sent to the backend, the middleware splits the subdomain and the TLD (top-level domain) and maps the tenant with the schema associated.

For this work, one of the ways is to change your apache, nginx or any other configurations that accepts and forwards calls to the *.sasscompany.com and performs the above action.

If the frontend and backend are split, extra configurations need also to be made on that front and all of this can be a pain.

What does django-tenants-url solve?

The principle of mapping users to the schemas remains the same but the way of doing it is what diverges from the rest. What if we were able to only use www.sasscompany.com, login as usual and automatically the platform knows exactly to which schema the user needs to be mapped and forward?

This is what django-tenants-url solves. A single url that does the multi tenancy without breaking the principle and architecture and simply using one single url

Installation¶

Prior to install the django-tenants-url, django-tenants needs to be installed as well. Please follow the installation steps from Django Tenants

After installing django-tenants¶

Install django-tenants-url¶

pip install django-tenants-url

The TENANT_MODEL and TENANT_DOMAIN_MODEL from django-tenants need to be also in the settings.py.
Add django-tenants-url to INSTALLED_APPS.

INSTALLED_APPS = [
  ...
  'django_tenants',
  'django_tenants_url',
  ...
]

django-tenants-url offers a special wrapper over the mixins of django-tenants with the same names so you don't need to worry about breaking changes and the additional unique TenantUserMixin that maps the users with a tenant.
Create the models.

# myapp.models.py

from django.db import models
from django_tenants_url.models import TenantMixin, DomainMixin, TenantUserMixin


class Client(TenantMixin):
    """
    This table provides the `tenant_uuid` needed
    to be used in the `X_REQUEST_HEADER` and consumed
    by the RequestUUIDTenantMiddleware.
    """
    pass


class Domain(DomainMixin):
    pass


class TenantUser(TenantUserMixin):
    pass

Add the DTU_TENANT_USER_MODEL to settings.py.

# settings.py

...

DTU_TENANT_USER_MODEL = 'myapp.TenantUser'

...

Update the MIDDLEWARE to have the new RequestUUIDTenantMiddleware. Preferentially at the very top.

# settings.py

...

MIDDLEWARE = [
  'django_tenants_url.middleware.RequestUUIDTenantMiddleware',
  'django.middleware.security.SecurityMiddleware',
  ...
]

...

Generate the migrations.

python manage.py makemigrations

Run the migrations as if it was django-tenants and not the classic migrate.

python manage.py migrate_schemas

The UUID needed for the RequestUUIDTenantMiddleware can be found in your table inherited from the TenantMixin.

None: Do not run python manage.py migrate or else it will sync everything into the public.

And that is it. The RequestUUIDTenantMiddleware should be able to map the TenantUser created with a tenant and route the queries to the associated schema.

Checkout the documentation and understand how to integrate with your views and taking advantage of the utils for your TenantUser (or your implementation),