User Management
Manage users, control access permissions, and monitor user activity across your George AI instance
User Management Overview
George AI uses Keycloak for authentication and provides a built-in user management interface for administrators. You can monitor user activity, manage permissions, and control access to resources.
User Directory
Browse all users with search, filtering, and pagination capabilities
Access Control
Manage admin privileges and control who can access administrative features
User Analytics
Track user counts, registration status, and activation states
User Information
Each user account contains the following information:
Basic Information
| Username | Unique username for login |
| User's email address | |
| Name | Full name (given_name + family_name) |
| Business | Company or organization |
| Position | Job title or role |
| Avatar URL | Profile picture |
Account Status & Dates
| Registered | Whether user has completed registration |
| Is Admin | Whether user has admin privileges |
| Created At | Account creation date |
| Last Login | Most recent login timestamp |
| Confirmation Date | When email was confirmed |
| Activation Date | When account was activated by admin |
Understanding User States
Confirmation Status
User has verified their email address by clicking the confirmation link
User has not yet confirmed their email address
Activation Status
Account has been activated by an administrator and can access the system
Account requires admin activation before full system access is granted
Administrator Privileges
Administrators have access to:
- User management (view, activate, grant admin rights)
- Queue management (processing and enrichment queues)
- System-wide statistics and monitoring
- All libraries and assistants across the instance
Finding Users
Text Search
Search across multiple user fields simultaneously:
- Username - Unique login identifier
- Email - Email address
- Name - Full name (given and family name)
Status Filters
Filter users by account status:
Pagination
Control how many users to display per page:
User Statistics
The user management dashboard displays real-time statistics about your user base, helping you monitor registration completion and activation rates.
Administrative Actions
Grant/Revoke Admin Privileges
What it does: Toggle administrator privileges for a user account
When to use:
- Promote a trusted user to help manage the system
- Remove admin access when someone changes roles
- Distribute administrative responsibilities across team members
How to use:
- Locate the user in the user table
- Click the checkbox in the "Is Admin" column
- Confirm the action (changes take effect immediately)
Security Warning
Only grant admin privileges to trusted users. Admins have full access to all system resources.
View User Details
What it does: Opens detailed view of user information and activity
When to use:
- Investigate user issues or support requests
- Review user's profile information
- Check account status and history
How to use:
- Locate the user in the user table
- Click the "Details" button in the Actions column
- View comprehensive user information
Common Management Scenarios
Likely causes:
- User hasn't confirmed their email (check Confirmation Status)
- Account requires admin activation (check Activation Status)
Solution:
- Filter by "Unconfirmed" or "Unactivated" to find the user
- Check their status indicators (colored dots)
- If unconfirmed: Ask user to check spam folder for confirmation email
- If unactivated: Activate the user account through user details page
Solution:
- View the user table (sorted by creation date by default)
- Check the "Last Login" column
- Users with no recent login will show older dates or null values
- Use this to identify inactive accounts
Solution:
- Identify trusted team members in different regions/departments
- Toggle admin status for each selected user
- Communicate admin responsibilities and best practices
- Document who has admin access for accountability
Solution:
- Filter by "Unactivated" status
- Increase page size to 50 or 100 for better overview
- Review each user's business and position information
- Click "Details" for suspicious accounts to see more information
- Activate legitimate accounts, take appropriate action on suspicious ones
Best Practices
Do
- ✓ Regularly review unactivated users and approve legitimate accounts
- ✓ Monitor the "Unconfirmed" count - high numbers may indicate email delivery issues
- ✓ Grant admin privileges only to trusted, experienced users
- ✓ Check user details before granting admin access
- ✓ Maintain at least 2-3 admins for redundancy
- ✓ Use filters and search to quickly find specific users
- ✓ Review last login dates to identify inactive accounts
Don't
- ✗ Grant admin privileges without verifying user identity and trust level
- ✗ Leave unconfirmed users waiting indefinitely - follow up on email issues
- ✗ Remove your own admin status (you can't, by design)
- ✗ Ignore suspicious registration patterns (multiple accounts, fake emails)
- ✗ Activate all new registrations automatically without review
- ✗ Forget to communicate role changes when granting/revoking admin access
- ✗ Have only one admin (creates single point of failure)