Skip to main content

Clients

The Clients page displays all browser clients and devices connected to GEM, including user agents, connection status, IP addresses, and session information.

Overview​

Client tracking provides:

  • Active Connections: Currently connected clients
  • Session History: Recent connection history
  • Device Information: Browser, OS, device type
  • User Association: Which user is logged in
  • Identify Feature: Flash screen to identify which physical device
  • Client Management: Disconnect or delete client records

Summary Statistics​

Cards showing aggregate metrics:

Total Clients: All client records (active and historical)

Connected Now: Currently connected browsers/apps

Authenticated: Clients with logged-in users

Active Last Hour: Clients seen within the past 60 minutes

Auto-Refresh: Updates every 30 seconds

Client List​

Table of all client records:

Columns:

  • Status: Online (green) / Offline (red) indicator
  • IP Address: Client IP address
  • Device & Browser: Parsed user agent with device icon
  • User: Logged-in username (if authenticated)
  • Auth Method: Authentication method used (e.g., token type)
  • Last Seen: Last activity timestamp
  • Session Age: How long since session was created
  • Push Notifications: Whether client has push notifications enabled
  • Default UI: The UI assigned to this client
  • AV Zone: The AV zone assigned to this client

Device Information Display​

User agents are parsed into a short device + browser label:

Examples:

iPhone 15.2 · Safari 15
macOS 12.1 · Chrome 96
Windows 10/11 · Edge 95
Android 12 · Firefox 94

Client Actions​

View Details​

Click the View icon on a row to open the client detail modal. The modal shows the full user agent, session age, token creation time, last-seen timestamp with relative age, assigned default UI and AV zone, authentication method, push-notification status, and the underlying IP and client ID. The same modal opens from the client-ID links in Request History.

Identify Client​

Click Identify button to flash the client's screen:

How It Works:

  1. Button clicked in admin interface
  2. Signal sent to specific client
  3. Client screen flashes or shows overlay
  4. Helps identify which physical device is which client

Use Cases:

  • Multiple tablets in same room
  • Unknown client connections
  • Verifying client after configuration change
  • Training users on which panel is which

Identify All Button: Flashes all connected clients simultaneously

Delete Client​

Remove client record from database:

When to Delete:

  • Old inactive client records
  • Test clients no longer used
  • Duplicate client entries

Confirmation: Shows client details before deletion

Impact:

  • Client record removed
  • If client reconnects, new record created
  • User can log in again

Connection Status​

Connected​

Green indicator:

  • Client actively connected via WebSocket
  • Receiving real-time updates
  • Can send commands

Disconnected​

Red/gray indicator:

  • Client not currently connected
  • Record exists (historical)
  • Last seen time shows last activity

Session Duration​

Calculated from session start to:

  • Current time (if connected)
  • Last seen time (if disconnected)

User Sessions​

Authenticated Clients​

Clients with logged-in users:

  • User column shows username
  • Associated with user account
  • Subject to user's role permissions

Unauthenticated Clients​

Clients connected but not logged in:

  • User column empty
  • Limited or no access
  • May be on login screen

Auto-Refresh​

Client list refreshes automatically:

Interval: 30 seconds

Updates:

  • Connection status
  • Last seen timestamps
  • New clients added
  • Disconnected clients marked

Manual Refresh: Click refresh button anytime

Troubleshooting​

Unknown Clients​

Symptom: Client shown but unknown who/where

Solutions:

  1. Use Identify button to flash screen
  2. Review IP address (correlate to network DHCP)
  3. Check user agent for device hints
  4. Delete if unused/old record

Client Not Showing​

Check:

  1. Client actually connected (check on device)
  2. Page auto-refreshed (or manual refresh)
  3. Network connectivity
  4. Client not blocked by firewall

Identify Not Working​

Check:

  1. Client is connected (not disconnected)
  2. Browser supports the identify feature
  3. Client browser not in background/minimized
  4. JavaScript enabled on client

Too Many Old Clients​

Cleanup:

  1. Sort by last seen
  2. Identify old clients (months old)
  3. Delete individually or in batches
  4. Or use Data Retention settings for automatic cleanup (if applicable)

Security Considerations​

Monitoring for Intrusions​

Watch for:

  • Unknown IP addresses
  • Connections outside normal hours
  • Multiple failed authentication attempts
  • Suspicious user agents

Rogue Client Detection​

Indicators:

  • Client from unexpected IP range
  • User agent doesn't match expected devices
  • Connection during off-hours
  • Unauthenticated client persisting

Actions:

  1. Investigate IP address
  2. Review network logs
  3. Change passwords if compromised
  4. Block IP at firewall if malicious
  5. Enable 2FA for users