Manage Users
Manage user access to your Dremio organization through internal authentication or external identity providers. This page covers user types, account management, and administrative tasks.
All users in Dremio are identified by their email address, which serves as their username. Invitations are sent to users' email addresses to set up their accounts.
User Types
Dremio supports two user types with different authentication and management workflows:
| Local Users | SSO Users | Service Users | |
|---|---|---|---|
| Purpose | Human access | Human access | Service or application access |
| Authentication | Password set in Dremio | Identity provider (IdP) credentials | OAuth secret or external JWT |
| Credential Management | Within Dremio | Through your IdP | Dremio or external IdP |
| Provisioning | Manual invitation | Manual invitation or SCIM automated | Manual creation |
| Password Reset | Self-service or admin-initiated | Through IdP only | N/A |
Local Users
Local users authenticate with passwords managed directly in Dremio. These users must be invited manually. Use local users when you need standalone accounts for contractors, external partners, or testing and development environments.
SSO Users
SSO users authenticate through your organization's identity provider (IdP) like Microsoft Entra ID or Okta, or through social identity providers like Google or GitHub. These users can be invited manually or provisioned automatically via System for Cross-domain Identity Management (SCIM).
What is SCIM?
SCIM is an open standard protocol that automates user provisioning between your identity provider and Dremio. Instead of manually creating and managing users in multiple systems, SCIM keeps everything synchronized automatically. When you add, update, or remove a user in your IdP, those changes propagate to Dremio without manual intervention.
SCIM Provisioning Benefits
When SCIM is configured, Dremio stays synchronized with your IdP. Deleting a user in your IdP automatically reflects in Dremio. Additional benefits of SCIM integration include:
- Automatic user creation and deactivation
- Synchronized user attributes
- Centralized access management
To learn more:
- Configure SCIM with Microsoft Entra ID
- Configure SCIM with Okta
- Configure SCIM with a generic OIDC provider
Service Users
Service users are non-human accounts for programmatic API access. They authenticate using either OAuth client secrets generated in Dremio or external JWT tokens from your identity provider. They cannot log in to the Dremio console. Use service users for applications, scripts, and automated workflows that need to interact with Dremio APIs.
A service user’s username follows this format:
{name}@{organization-id}.dremiosu.app
For example:
[email protected]
You choose the {name} portion when creating the service user. Dremio automatically appends the domain suffix using your organization ID.
Manage Your Account
Update Your Password
Local users can reset passwords using either method:
If locked out:
- On the login screen, enter your email.
- Click Forgot Password?.
- Check your email for the reset link.
If logged in:
- Hover over the user icon at the bottom of the navigation sidebar.
- Select Account Settings.
- Click Reset Password.
- Check your email for the reset link.
Changing your password ends all existing Dremio web sessions.
SSO users must reset passwords through their organization's identity provider. Contact your authentication administrator for assistance.
Update Your Name
You can change your display name at any time:
- Click the user icon on the side navigation bar.
- Select Account Settings.
- On the General Information page, edit First Name and Last Name.
- Click Save.
Administrative Tasks
The following tasks require administrator privileges or the CREATE USER privilege.
View All Users
- Click
in the side navigation bar and select Organization. - Select User management from the organization settings sidebar.
The table displays all local and SSO users with access to your Dremio instance.
Add a User
SSO users are added automatically when you configure SCIM provisioning.
To add a local user:
- Click
in the side navigation bar and select Organization. - Select User management.
- Click Add Users.
- In the Email address(es) field, enter one or more email addresses separated by commas, spaces, or line breaks.
- For Dremio Role, select the roles where the user will be a member. All users are members of the PUBLIC role by default.
- Click Add.
Each user receives an invitation email to set up their account. You can configure additional roles after users accept their invitations.
A user's email address serves as their unique identifier and cannot be changed after account creation. If a user's email changes, you must create a new account with the new email address.
If invited users don't receive the email, check spam folders and verify the email addresses are correct.
Edit a User
You can modify a user's name and role assignments. Email addresses cannot be edited—if a user's email changes, you must create a new account.
- Click
in the side navigation bar and select Organization. - Select User management.
- Hover over the user's row and click
to edit the user. - Details tab: Edit First Name and Last Name, then click Save.
- Roles tab: Manage role assignments:
- Add roles: Search for and select roles, then click Add Roles.
- Remove roles: Hover over a role and click Remove.
- Click Save.
Reset a User's Password
This option is only available for local users. SSO users must reset passwords through their identity provider. To send a password reset email to a local user:
- Click
in the side navigation bar and select Organization. - Select User management.
- Click the user's name.
- Click Send Password Reset.
The user receives an immediate email with reset instructions.
View All Service Users
- Click
in the side navigation bar and select Organization. - Select User management from the organization settings sidebar.
- Click the Service users tab.
The table displays all service users in your Dremio organization.
Add a Service User
- Click
in the side navigation bar and select Organization. - Select User management.
- Click the Service users tab.
- Click Add service user.
- In the New service user dialog, provide a name and description for the service user.
- Dremio will add a domain suffix
@{organization id}.dremiosu.appto the service username to create the username with the domain. - The username cannot be changed after completing the initial configuration.
- Dremio will add a domain suffix
Edit a Service User
You can update a service user's description and manage role assignments.
- Click
in the side navigation bar and select Organization. - Select User management.
- Click the Service users tab.
- Click the desired service user. You can edit the Description field directly.
- Select Granted roles to manage role assignments.
- Grant roles: Click Grant role and select roles, then click Grant.
- Revoke roles: Hover over the role and click
to the right. Then click Revoke.
Generate an OAuth Client Secret
To authenticate a service user for API access, generate an OAuth client secret that applications will use to obtain access tokens from Dremio.
- Click
in the side navigation bar and select Organization. - Select User management.
- Click the Service users tab.
- Click the desired service user.
- Select Credentials and click Add and select Generate OAuth Secret.
- Provide a Label for the secret and a Lifetime between 90 and 180 days, then select Generate.
- Important: Copy the OAuth Client Secret and store it in a secure location. It will not be available again.
Configure an External Credential
External credentials allow service users to authenticate using JWT tokens issued by your organization's identity provider.
- Click
in the side navigation bar and select Organization. - Select User management.
- Click the Service users tab.
- Click the desired service user.
- Select Credentials and click Add and select Configure an External Credential.
- Provide a Label for the credential.
- Provide the target Audience, which identifies the intended recipient for a JWT from the identity provider. See Audience for details.
- Complete the User Claim to identify the claim mapping in the external JWT for the service principal in the identity provider. The
subandoidclaims typically provide the service principal's unique identifier. See User Claim Mapping for details. - Provide the External ID. For Microsoft Entra ID service principals, this should be the service principal's Object ID.
- Provide the Issuer URL, which is the OAuth provider that issues JWT tokens for the associated service account. This is contained in the external JWT's
issclaim and identifies the identity provider. See Issuer URL for details. - Record the JWKS URL (optional). If not provided, Dremio retrieves the JWKS URL from
{issuer_URL}/.well-known/openid-configuration. See JWKS URL for details. - Click Configure to create the external credential.
Remove a User
To remove an SSO user:
- First, remove the user from your external identity provider.
- Then follow the steps below to remove them from Dremio.
To remove a local user:
- Click
in the side navigation bar and select Organization. - Select User management.
- Click the user's name.
- Click
to remove. - Confirm the deletion.