Skip to main content

Administration Overview

The CloudQuant Data Liberator admin portal lets organization administrators control who can access the platform and which datasets each user can query. Access is managed through entitlements — explicit grants to datasets, dataset groups, and connections — with optional fine-grained permissions that restrict query scope.

Who Can Manage Access

The admin portal uses a role hierarchy. Each role can assign roles at or below its own level.
RoleDescription
UserQuery entitled datasets. No admin portal access.
AdminManage connections, datasets, and user groups. Can add existing user accounts to the permissions system.
Super AdminFull platform administration — create users, edit roles, assign entitlements, configure fine-grained permissions, and deactivate users.
Most user and entitlement management actions described in this section require Super Admin. Admins can view the Users page and add users to Liberator, but editing user details, assigning dataset entitlements, and deactivating users are Super Admin actions.

Permission Model

Access is layered:
  1. Platform role (user, admin, super_admin) — controls what a person can do in the admin portal.
  2. Connection entitlements — grant access to all datasets within a connection. Datasets inherited from a connection appear as locked in the permissions UI.
  3. Dataset entitlements — grant access to individual datasets at Editor or User level.
  4. Dataset group entitlements — grant access to a curated bundle of datasets defined in Dataset Groups.
  5. Fine-grained permissions — optional per-dataset or per-group restrictions on date range, query type, row limits, keys, and columns.

Editor vs User

For datasets and connections, entitlements are assigned at one of two levels:
LevelMeaning
EditorFull access to query the dataset (or all datasets in a connection).
UserQuery access at the usage level. In the UI this is labeled User; internally it maps to the usage entitlement tier.
When a user has connection-level access, all datasets in that connection are inherited automatically. Those datasets cannot be individually removed until the connection entitlement is revoked.

Admin Portal Navigation

Super Admins and Admins see these relevant sections in the sidebar:
PagePurpose
UsersAdd users, assign entitlements, configure fine-grained permissions
User GroupsManage groups of users for bulk entitlement assignment
Dataset GroupsManage bundles of datasets for bulk entitlement assignment
ConnectionsConfigure data source connections
DatasetsView and manage individual datasets

Managing Users & Entitlements

Add, create, deactivate users and grant or revoke dataset access

Fine-Grained Permissions

Restrict query date ranges, row limits, keys, and columns per user

Security & Access

Authentication, network security, and the end-user view of entitlements

Checking Dataset Access

How users verify their entitled datasets from Python