Appearance
Tenant administration
Also known as
- tenant
- organisation
- workspace
- client onboarding
- provisioning
- new tenant
- enable module
- module subscription
- suspend
- reactivate
Tenant administration covers the life of a client organisation (a tenant) on Roari ERP: the platform admin creates it in the platform console with the modules the client pays for, the client's account admin signs in and sees only those modules, modules are turned on later, the account admin sets up roles and users (with segregation of duties checked by Compliance), and the tenant is suspended or archived when the contract ends.
Who is involved
| Order | Role | Demo user | What they do |
|---|---|---|---|
| 1 | Platform admin | superadmin (password Super-Pass-2026, no organisation) | Creates the tenant, picks modules, later enables more, suspends and archives. |
| 2 | Account admin of the new tenant | admin at flowtest-… | Signs in, checks the modules, creates roles and users. |
| 3 | Account admin of a tenant with Compliance | admin at demo | Sees the SoD warning in the role editor and the refusal on assignment. |
text
Platform console New tenant ─▶ Create tenant ─────────▶ Modules: + Sales & CRM ─────────────────▶ Suspend ─▶ Archive
Tenant admin Sign in (Finance, Inventory) Spine shows Sales Roles + users (SoD) Sign-in refused1. Create the tenant
- Sign in as the platform admin on the base address, without an organisation. You land in the platform console.
- Go to ConsoleTenantsNew tenant.
- Under Organisation, fill in Name, Slug (it becomes the sign-in address,
slug.roari.app), Base currency and Language. The base currency cannot change once documents are posted. - Under Account administrator, fill in Display name, Email, Username and Password (at least 10 characters; Generate makes one). This first user holds the
account_adminrole. - Under Modules, switch on what the client bought. Finance & accounting is Mandatory and always on. Each module shows what it Needs (switched on with it) and what it Works with. In the example, switch on Inventory & warehousing only.
- Select Create tenant. You see … is ready and the tenant's page opens with the Overview, Modules and Users tabs.
2. The account admin signs in
- The account admin opens the tenant's address (or the shared address with Organisation set to the slug) and signs in with the username and password from step 1.
- The spine shows only the enabled modules: Finance and Inventory. Pages and the API of other modules are not reachable (the API answers
module_disabled).
3. Turn on another module
- In the console, open the tenant and the Modules tab.
- Switch on Sales & CRM. The page shows Unsaved changes.
- Select Save modules. You see Modules updated.
- The account admin reloads the app: Sales & CRM is in the spine and its pages work.
Dependencies are checked: a module cannot be switched on without the modules it needs (Manufacturing needs Inventory & warehousing). The tenant's own admin sees the enabled modules in Modules and sets their options there.
4. Set up roles and users, with segregation of duties
- As the account admin, go to SettingsRoles and permissions and create a role: type the Name, use Filter permissions to find permissions and tick them, then select Create role.
- If the permissions break an enforced segregation-of-duties rule, the editor warns you before you save: These permissions break a segregation-of-duties rule: assigning this role to a user will be refused., followed by the rule (for example
ITG-01 … (blocked on assignment)for Manage users together with Manage roles and permissions). The role can still be saved. - Go to SettingsUsersNew user, fill in Full name, Email, Username, Temporary password and Roles, and select Create user.
- When a rule with block enforcement covers the roles, the user is not created: The user was not created. Segregation of duties: this combination of roles is blocked by ITG-01 …. The blocked attempt is logged in Compliance.
Differences by role
- Segregation of duties is checked only in tenants with Governance, risk & compliance enabled and an active rule set (SoD rule sets). A new tenant without Compliance has no SoD rules.
- Rules with warn enforcement let the assignment through and record the conflict; block refuses it.
- The
account_adminrole is a system role: it holds every permission and cannot be edited.
5. Suspend the tenant
- In the console, open the tenant, select More actions and Suspend tenant.
- Type the Reason (recorded in the platform audit log) and select Suspend. The page shows This tenant is suspended.
- Everyone at the tenant is signed out at once. A new sign-in shows This organisation is suspended. Contact your provider. Data is kept.
- To undo, select More actions > Reactivate tenant; users can sign in again straight away.
6. Archive the tenant
- In the console, open the tenant and select More actions > Archive tenant.
- Confirm. This closes the tenant for good: users cannot sign in and the tenant leaves every list. Data is retained under the retention policy.
| Tenant status | Users can sign in | Next |
|---|---|---|
| Active | Yes | Suspend tenant, Archive tenant, Enter tenant |
| Suspended | No; open sessions end | Reactivate tenant, Archive tenant |
| Archived | No | Final. |
Check the result
| Where | What you see |
|---|---|
| Tenants | The tenant with its status, modules and users. |
| Tenant detail | Overview, Modules and Users tabs. |
| Platform audit | Creation, module changes, suspension (with reason) and archiving. |
| Modules | The enabled modules, inside the tenant. |
| Segregation of duties | Blocked assignment attempts and violations. |
Variants
- Support inside a tenant: Enter tenant (active tenants only) lets the platform admin work in the tenant; every action is logged as done on behalf of the platform.
- Locked-out account admin: from the tenant's Users tab in the console, reset the password or unlock the user.
- Notice to clients: post a message to all or selected tenants in Announcements.
Related
- Platform console · Tenants · New tenant · Module catalogue · Platform admins · Health
- Users · Roles and permissions · Role edit · Modules · Company
- Segregation of duties · SoD rule sets
- Sign in
- Permissions and segregation of duties · Audit trail and activity · Legal entities and currencies · Languages and right-to-left
