Database Users and Roles

GermainUX can authenticate Workspace users against a database through a JDBC authentication provider.

This approach allows administrators to:

Capability

Create and manage users from the Germain Workspace

Use an email address as the login username

Assign permissions through Roles

Control dashboard and data visibility through Teams

Send welcome and password-reset emails

Note: This page describes GermainUX Workspace accounts authenticated through a database. It does not cover database-administrator accounts.

👀 View Users

Go to:

Germain Workspace > Left Menu > System > Auth Settings > Users

The Users page displays the accounts currently configured for the Germain Workspace.

⚙️ Configure JDBC Authentication

  1. Go to System > Auth Settings > Authentication.

  2. Click Add New Configuration.

  3. Select JDBC Provider.

  4. Click Next.

  5. Configure the provider fields.

  6. Click Finish.

Field

Description

Provider Name

Unique name used to identify the JDBC authentication provider.

Query for Usernames

Query used to retrieve and authenticate users. Keep the default value when using the standard GermainUX database schema.

Query for Authorities

Query used to retrieve the Roles or authorities assigned to each user. Keep the default value when using the standard GermainUX database schema.

Screenshot 2022-12-15 at 10.42.07.png

➕ Create a User

  1. Go to System > Auth Settings > Users.

  2. Click Add New User.

  3. Configure the user fields.

  4. Save the account.

Field

Description

Email

User’s email address. It is also used as the login username.

Roles

Determines which operations the user can perform. Assign at least one configured Role.

Teams

Determines the user’s dashboard, data, and Session Replay visibility.

Send Welcome Email

Sends the user an invitation containing password-setup instructions.

Screenshot 2022-12-15 at 10.22.32.png

📧 Welcome Email and Password Setup

When Send Welcome Email is enabled, GermainUX sends the new user instructions for creating a password.

If the welcome email was not sent when the account was created:

  1. Go to System > Auth Settings > Users.

  2. Select the user.

  3. Click Reset Password.

    Screenshot 2022-12-15 at 10.28.18.png
  4. GermainUX sends the user a password-reset email.

✏️ Edit or Remove a User

From System > Auth Settings > Users, select an existing user to:

Action

Update assigned Roles

Update Team memberships

Reset the password

Enable or disable access

Remove the account

Changes to Roles or Teams affect the user’s permissions and visibility within the Germain Workspace.

🔑 Log In

The user can log in from the GermainUX login page using:

Field

Value

Username

Email address configured for the account

Password

Password created through the welcome or reset process

Service: Authentication

Feature Availability: 8.6.0 or later