Tenants¶
This is where you'll see and manage the tenants of your workspace.
What is a tenant?
A tenant is a sub-division of your workspace. Each client and user is tied to a specific tenant.
This is mostly useful if you want to create a product sold in white-label where each of your client has its own space. It allows for example for a user to have several accounts with the same email address inside one workspace, but actually tied to different tenants. From a user point-of-view, this is a different application on which they login with different credentials.
If you don't plan to do this, that's okay: you'll always use a single tenant in your workspace.
Each workspace has at least one default tenant.
Base URL¶
Each tenant is tied to a base URL: each routes, like login or registration, will be derived from this base. When you integrate Fief in your application, you'll need this base URL.
Each workspace has one default tenant with a base URL pointing to your root subdomain, like https://example.fief.dev.
Other tenants gets a path prefix, like https://example.fief.dev/other-tenant.
Tip
You can copy the base URL directly using the clipboard button in the list.
Create a new tenant¶
You can create a new tenant by clicking the Create Tenant button. A modal will open where you'll be able to input:
- Its name.
- If user registration is allowed.
The base URL is automatically generated from the name.
Optionally, you can also set:
- A logo URL that will be shown on the top-left of authentication pages.
- A UI theme to use when users authenticate with this tenant. If left empty, the theme set as default is used.
- The list of OAuth Providers allowed to be used on this tenant.
Edit an existing tenant¶
If you click on one of the tenant in the list, you'll see its details on the right.
If you click on the Edit Tenant button, you'll be able to update its properties.
Disable user registration¶
You can choose to disable user registration on a tenant. To do this, you have to uncheck the Registration allowed checkbox in the tenant details.
When registration is disabled, users can't access the registration page and create a new account on this tenant.
Delete a tenant¶
If one your tenant is not useful anymore, you can delete it by clicking on it on the list and click on the Delete button on the right.
Users and clients will be removed as well
When you delete a tenant, all its associated users and clients will be deleted as well. The data won't be recoverable. Be sure of what you're doing!