Tenant Settings

Each tenant has general settings that control its identity and accessibility. Tenant Administrators can modify these settings from the tenant configuration page.

Accessing Tenant Settings

1. Navigate to Tenants and click on the tenant you want to configure.
2. Open the Configuration tab.

General Settings

Tenant Name

The display name for the tenant, shown in the Tenant Admin Dashboard and used in notifications. This is a human-readable label that identifies the organization or business unit.

Example: “Acme Corporation”, “Engineering Division”, “Production Environment”

Tenant Slug

The URL-safe identifier used in URL routing. The slug must be unique across all tenants and can only contain lowercase letters, numbers, and hyphens.

Example: acme, engineering, production

Caution

Changing the tenant slug changes all URLs for that tenant. Existing bookmarks and shared links using the old slug will stop working. Coordinate slug changes with tenant users to avoid disruption.

Domain

An optional domain name for domain-based routing. When configured, users can access the tenant directly via the domain without needing a slug prefix in the URL.

Example: acme.ramp.example.com

Note

Domain-based routing requires proper DNS configuration and reverse proxy setup outside of RAMP. The domain must resolve to the RAMP server for routing to work.

Description

An optional description that provides context about the tenant’s purpose or the organization it represents. This is visible only in the Tenant Administration interface.

Editing Tenant Settings

1. Navigate to the tenant’s Configuration tab.
2. Modify the desired fields (name, slug, domain, or description).
3. Click Save to apply the changes.

Tenant Status

The tenant status controls whether users can log in and access the tenant.

Active

The default state for a tenant. Users can log in and work within the tenant normally.

Inactive (Deactivated)

When a tenant is deactivated:

• New logins are blocked for all users in the tenant
• Existing sessions may continue until they expire
• All tenant data is preserved
• The tenant remains visible in the Tenant Admin Dashboard

1. Navigate to the tenant’s page.
2. Use the Status toggle or click the Deactivate button.
3. To reactivate, toggle the status back or click Activate.

Tip

Deactivation is useful for temporarily disabling access to a tenant during maintenance or organizational changes without deleting any data.

Deleting a Tenant

Danger

Deleting a tenant permanently removes all data associated with it. This includes:

• All users and groups within the tenant
• All templates, template versions, and template roles
• All instances, execution history, and instance roles
• All systems, stages, and system roles
• All authentication provider configurations
• All SMTP settings
• All IDP group mappings
• All audit log entries for the tenant

This action cannot be undone.

To delete a tenant:

1. Navigate to Tenants and click on the tenant.
2. Click Delete.
3. A confirmation dialog appears. Type the tenant name exactly as displayed to confirm.
4. Click Confirm Delete.

Tip

Before deleting a tenant, consider deactivating it first. Deactivation blocks access while preserving data, giving you the option to reactivate later if needed.

TenantAdministrator Account Management

TenantAdministrator accounts are managed separately from tenant users.

Managing TenantAdministrator Accounts

1. Navigate to Users in the top-level Tenant Admin menu.
2. Create, edit, or deactivate TenantAdministrator accounts.
3. Reset passwords for TenantAdministrator accounts as needed.

TenantAdministrator Role Assignments

1. Navigate to Role Assignments in the top-level Tenant Admin menu.
2. View and manage role assignments for TenantAdministrator users.

Audit Log

All Tenant Administration actions are logged for compliance and troubleshooting purposes.

Viewing the Audit Log

1. Navigate to Audit Log in the top-level Tenant Admin menu (for all tenants) or to the tenant-specific Audit Log tab (for a single tenant).
2. Filter by:
   • Tenant
   • Action type (Created, Updated, Deleted, etc.)
   • User who performed the action
   • Date range
3. Each entry displays the timestamp, user, action type, and details of the change.

Troubleshooting

Cannot Access Tenant Admin

1. Verify you have the TenantAdministrator application role.
2. Ensure you are using the correct URL: /_tenantadmin/login.
3. Confirm that multi-tenancy is enabled in the system configuration.

User Cannot Log In to a Tenant

1. Check the tenant status — is it active?
2. Verify the user’s account is active within the tenant.
3. Confirm the authentication provider is configured correctly.
4. Test the IDP connection from the Auth Providers page.

Related topics

Tenant Overview Understand multi-tenancy, tenant isolation, and the tenant lifecycle

SMTP Configuration Configure per-tenant email settings for notifications and password resets

External IDP Users Not Appearing

1. Has the user logged in at least once? (Required for CachedOnly mode.)
2. Is directory browsing enabled?
3. Is the Admin API Endpoint configured correctly?
4. Does the OAuth2 client have the required API permissions?