ExTenant (ExTenant v0.1.1) View Source

by calling the use macro we should be able to inject all the required behaviour to allow us to handle multi-tenancy.

In your application Repo file call the use macro as per this example

use ExTenant,

config: [
  otp_app: :name_of_your_elixir_phoenix_app,
  adapter: Ecto.Adapters.Postgres,
  tenanted_field: "tenant_id"
]

In order to get the tenant_id into the progress dictionary in Phoenix we recommend to use a plug - there you should retrieve the tenant name from something like the sub domain in the url. Then using the tenant name retrieve the tenant, and call:

  • Repo.put_tenant_id(tenant_id)

to insert the tenant_id into the process dictionary.

(The next version of this library will provide a Plug that you can use. Watch this space!)

From here all your Repo callbacks (Repo.get/Repo.one/Repo.all etc) will have a where clause applied to them with the tenant_id injected into the clause.

In order to set the tenant_id on insert and update functions do this:

def changeset(params \ :empty) do
  params
  |> Repo.inject_tenant_id()
  |> default_changeset()
end

defp default_changeset(params) do
  %__MODULE__{}
  |> cast(params, [:field1, :field1, :tenant_id])
end

NB: If the tenant_id is not set in the changeset, Repo.insert/update callbacks will raise a Postgrex.Error (not_null_violation)