Skip to main content
Applies to:
Cockpit v2RBAC (roles & permissions)Users · OUs · Identity providers

Users​

Users are the identities that sign in to a tenant. Each user carries a full authentication state and can be assigned roles and organizational units.

AspectDetail
PasswordProtected with strong, industry-standard password hashing
Two-factorTOTP 2FA with recovery codes
LockoutFailed-login counter with automatic lockout and timed release
ApprovalPending users can be approved / rejected before activation
AssignmentRoles and organizational units assigned at creation or later

Administrative actions include approve, reject, lock / unlock, suspend / unsuspend, reset password, manage TOTP, and review or revoke active sessions and sign-in logs.

Roles and permissions​

Authorization is role-based (RBAC). A role is a named bundle of permissions; users are granted roles, and each user's effective permissions are the combined set expanded from all of their roles.

Hierarchical permissions

Permissions are organized as a hierarchy, so granting a broad permission (for example "manage keys") automatically implies the more specific actions beneath it.

Host vs tenant scope

Each permission is scoped to the host, a tenant, or both, so host-only actions never appear inside a tenant — a foundation for separation of duties.

Built-in & default roles

Built-in roles cannot be deleted and stay aligned with the current capability set; a role can be marked default so new users receive it automatically.

Permissions are grouped by area — Administration (users, roles, settings), Operations (the cryptographic capabilities such as key management, vaults, PKI and PQC), Host, and cross-cutting areas like access policies, identity providers, notifications and billing. See Features for how the capabilities these permissions govern are toggled per edition.

Super administrator

The platform has a dedicated host super-administrator. Its authority is managed separately from ordinary tenant roles (see Host).

Organizational units​

Organizational units (OUs) add a second scoping layer inside a tenant. They form a tree that mirrors teams or departments, and resources like apps can be scoped to a specific OU (or left visible to the whole tenant). Roles can be assigned at the OU level, and membership is managed per OU.

Identity providers and SSO​

External identity providers let users sign in with corporate credentials. Providers are configured with their client credentials, authority/metadata URLs, scopes and claim mappings, and can auto-provision users into default roles.

ProviderStatus
Azure AD / Entra IDSupported
OktaSupported
KeycloakSupported
UAE PassSupported
Ping IdentitySupported
RSA SecurID AccessSupported
ForgeRockSupported
SSO is feature-gated

Single sign-on is governed by the identity-provider entitlements: the provider must be enabled for the tenant's edition — see Features.

Authentication mechanisms​

MechanismDetail
PasswordStrong, industry-standard password hashing, with a configurable password policy (see Host settings)
TOTP 2FATime-based one-time passwords with recovery codes
WebAuthn / FIDO2Passkeys, security keys and Windows Hello
External SSOAzure AD, Okta, Keycloak and other supported identity providers via the identity-provider module

Sessions can be invalidated on password change, revocation or logout, so access can be cut off immediately when needed.

Access policies (ABAC)​

Beyond RBAC, administration includes an attribute-based access-policy engine (ABAC) that governs runtime cryptographic operations by user, IP, location, time and group. That model is documented in full on the Access Policies page.

API reference​

Administration exposes management operations for users, roles, organizational units, identity providers, access policies and impersonation, each governed by the corresponding administration permissions.

API reference
Detailed API endpoints are documented separately in the Developer Docs → Administration API.