Control CoreDocs

📌 General Settings

This guide explains how to configure general platform settings, including platform preferences, security settings, subscription management, and telemetry configuration.

📌 Overview

The General Settings page provides centralized configuration for:

  • Platform Preferences: Timezone and session timeout settings
  • Security Settings: Security-related configurations
  • Subscription: View and manage subscription plan
  • Telemetry: Configure License Server connection and telemetry transmission

📌 Accessing General Settings

  1. Log in to the Control Core admin console
  2. Navigate to Settings → General
  3. Select the appropriate tab for the settings you want to configure

🔧 Platform Preferences Tab

Timezone Configuration

Configure the timezone for audit logs and system timestamps.

Steps:

  1. Navigate to Settings → General → Platform tab
  2. Select your timezone from the Timezone dropdown
  3. Default timezone is UTC
  4. Click Save to apply changes

Impact:

  • All audit logs will use the selected timezone
  • System timestamps will display in configured timezone
  • Changes apply immediately to new logs

Tooltip: "Select the timezone for audit logs and system timestamps. All timestamps will be recorded in this timezone."

Session Timeout Settings

Configure how long users remain logged in before session expires.

Steps:

  1. Navigate to Settings → General → Platform tab
  2. Enter Session Timeout in minutes (default: 60 minutes)
  3. Minimum: 15 minutes, Maximum: 480 minutes (8 hours)
  4. Click Save to apply changes

How It Works:

  • Session timeout is based on idle time (no user activity)
  • Activity includes: mouse movement, keyboard input, clicks, scrolling
  • When timeout approaches, a warning modal appears
  • User can click "Stay Logged In" to extend session
  • Session resets on any user activity

Tooltip: "Set the idle timeout in minutes. Session expires after this period of inactivity. Activity resets the timer."

🔒 Security Settings Tab

Two-Factor Authentication

Two-Factor Authentication (2FA) settings have been moved to the User Management page.

To Configure 2FA:

  1. Navigate to Settings → Users
  2. Select a user from the list
  3. Click Enable MFA or use the MFA tab
  4. Follow the setup wizard to configure Google Authenticator or Microsoft Authenticator

Note: Only TOTP-based 2FA (Google Authenticator, Microsoft Authenticator) is supported.

📌 Subscription Tab

The Subscription tab displays your current subscription plan and license information.

See: Subscription Management Guide for detailed information.

Quick Access:

  • View current plan (Kickstart or Custom)
  • Check trial status and expiration
  • Understand license requirements
  • Contact support for upgrades

👁️ Telemetry Tab

The Telemetry tab allows you to configure License Server connection and telemetry transmission.

See: Telemetry Management Guide for detailed information.

Quick Access:

  • Configure License Admin URL and API Key
  • Test License Server connection
  • Configure transmission frequency
  • Enable/disable encryption and anonymization
  • View telemetry data preview
  • Review transmission history

The General Settings page uses tabs for organization:

  • Platform: Platform preferences (timezone, session timeout)
  • Security: Security-related settings (2FA moved to User Management)
  • Subscription: Subscription plan and license information
  • Telemetry: License Server connection and telemetry configuration

Tip: Use the tab navigation to quickly switch between different setting categories.

📌 Saving Changes

Individual Tab Saving

Each tab may have its own Save button:

  • Platform Tab: Save timezone and session timeout
  • Telemetry Tab: Save telemetry configuration

Note: Some settings are saved automatically when changed (e.g., toggles).

Verifying Changes

After saving:

  1. Check for success message/notification
  2. Verify settings are reflected in the UI
  3. Test functionality (e.g., test connection, verify timezone)

🛠️ Troubleshooting

Settings Not Saving

Issue: Changes are not being saved

Solutions:

  1. Check for error messages in the UI
  2. Verify you have admin permissions
  3. Check browser console for errors
  4. Try refreshing the page and re-entering settings
  5. Check backend logs for errors

Session Timeout Not Working

Issue: Session timeout modal doesn't appear or "Stay Logged In" doesn't work

Solutions:

  1. Verify session timeout is configured correctly
  2. Clear browser cache and cookies
  3. Check browser console for JavaScript errors
  4. Verify backend session management is running
  5. Check that activity tracking is enabled

Timezone Not Applied

Issue: Audit logs still showing UTC instead of configured timezone

Solutions:

  1. Verify timezone is saved correctly
  2. Check that new logs use configured timezone
  3. Existing logs may still show UTC (this is expected)
  4. Verify backend timezone handling is working