Dashboard Guide

Security Dashboard UI Guide

Complete walkthrough of the SYNTHET Security dashboard (/dashboard/security). Learn how to navigate each section, configure settings, and respond to security alerts.

Dashboard Overview

The Security dashboard is organized into two main sections accessible via tabs: Anti-Nuke and Anti-Raid. Each section contains configuration tools and real-time monitoring.

Navigation: Access the Security dashboard from the sidebar under Protection → Security, or navigate to /dashboard/security in your browser.

Anti-Nuke Configuration Section

The Anti-Nuke tab contains all tools to prevent server nuking attacks. It's organized into subsections:

Threshold Sliders

Four threshold sliders control nuke detection sensitivity:

Channel Deletions Per Time Window

Slider: 1-20

Set how many channel deletions trigger protection (default: 5). Move the slider left to be more sensitive (fewer deletions = alert), right to be less sensitive.

Visual feedback: Real-time label shows "X channel deletions = trigger" as you adjust.

Role Deletions Per Time Window

Slider: 1-15

Set how many role deletions trigger protection (default: 3). More sensitive than channels due to role criticality.

Warning badge: Slider shows red/yellow/green indicator based on current safety level.

Ban Waves Per Time Window

Slider: 5-30

Set how many member bans trigger protection (default: 10). Accounts that hit this threshold can no longer ban members.

Context: Legitimate moderation typically bans 1-2 members per hour during active moderation.

Kick Waves Per Time Window

Slider: 5-40

Set how many member kicks trigger protection (default: 15). Often used as precursor to channel deletion in nukes.

Linked thresholds: All sliders share the same time window setting below.

Time Window Setting

Dropdown: Select 5, 10, 15, 30, or 60 minutes. All thresholds use this window. Shorter windows (5 min) are more sensitive; longer windows (60 min) are more lenient. Default is 10 minutes.

Whitelist Management

Add trusted users and roles to bypass nuke detection:

Add to Whitelist Form

Type Field: Dropdown to select "User" or "Role"

Selection Field: Searchable dropdown (SearchableSelect component):

  • •Type to search for users by username or user ID
  • •Click any result to select
  • •For roles, shows role color indicator and member count

Submit Button: Green button with black text "Add to Whitelist"

Whitelist View

Below the form, shows a table of whitelisted entries:

  • •Name: Username or role name with icon (user or role)
  • •Type: "User" or "Role" label
  • •Added By: Admin who added the entry
  • •Added On: Timestamp
  • •Remove Button: Red "X" button to remove whitelist entry

Warning: Whitelisted accounts bypass all nuke detection. Only add absolutely trusted accounts.

Automatic Protection Actions

Configure what happens when nuke is detected:

Strip Permissions

Enabled

When enabled, the user triggering nuke detection has dangerous permissions removed automatically.

Quarantine User

Enabled

When enabled, the suspicious account is assigned quarantine role.

Notify Owner

Enabled

When enabled, server owner receives DM and alert channel notification of nuke attempt.

Anti-Raid Configuration Section

The Anti-Raid tab contains raid detection and response configuration:

Detection Type Toggles

Enable/disable each raid detection method individually:

Member Join Spike Detection

Alerts when many members join rapidly

Message Flood Detection

Alerts when messages spike in channels

Mention Spam Detection

Alerts on @mention spam patterns

New Account Pattern Matching

Alerts when many new accounts join together

Username Pattern Clustering

Detects similar usernames from bot networks

Sensitivity Configuration

Adjust detection sensitivity with a master slider:

Master Sensitivity Slider

Low ← → High

This slider scales all raid detection thresholds proportionally:

  • •Low: Fewer false positives, may miss subtle raids
  • •Medium (default): Balanced between catch rate and false positives
  • •High: Catches more raids but more quarantines of legitimate users

Tip: Start with High sensitivity. Legitimate users can verify with CAPTCHA, but missed raids cause major damage.

Lockdown Triggers & Configuration

Configure when lockdown activates and how it behaves:

Lockdown Trigger Events

Multi-select checkboxes for which detection types trigger lockdown:

Auto-Lockdown Duration

Dropdown: Select how long automatic lockdown lasts before auto-lifting (5, 10, 15, 20, 30, or 60 minutes). Default: 15 minutes.

Note: Can be manually extended or lifted by admins anytime.

Lockdown Scope

Radio buttons:

If specific channels selected, a multi-select shows all channels to choose from.

Quarantine System Configuration

Configure how suspicious accounts are quarantined:

Quarantine Role Selection

Searchable Dropdown (SearchableSelect): Select or create a role to use as quarantine. Shows role colors and current member count.

Auto-create option: If role doesn't exist, option to auto-create with safe default permissions.

Account Age Threshold

Dropdown: Select which accounts are considered "new" for automatic quarantine.

  • •Instant (0 hours)
  • •Same Day (24 hours) — default
  • •Same Week (7 days)

Action on New Account

Radio buttons: Choose what happens when a new account joins.

Verification Type

Radio buttons: How quarantined users can self-verify.

Quarantine Timeout

Number input: Hours until unverified quarantine members are kicked (default: 24). Set to 0 for no timeout (manual only).

Alert Channel Configuration

Configure where raid alerts are sent:

Alert Channel Selection

Searchable Dropdown (SearchableSelect): Select which channel(s) receive raid alerts. Can select multiple channels.

Typical choice: #raid-alerts, #mod-alerts, or #security

Alert Severity Configuration

Per alert channel, choose minimum severity to send:

Owner DM Notification

Toggle: Enable to send direct message to server owner when Critical raids are detected.

Security Alerts Dashboard

The Alerts tab displays recent security events in real-time:

Alert List View

Chronological list of recent security alerts. Each alert shows:

  • •Alert Type: "Nuke Attempt", "Raid Detected", etc. with icon
  • •Severity Badge: Low (blue), Medium (yellow), High (orange), Critical (red)
  • •Triggered By: User who caused alert (if applicable)
  • •Timestamp: When alert was generated
  • •Action Taken: What SYNTHET did (Quarantine user, Strip perms, Trigger lockdown)

Alert Details Expansion

Click any alert to expand and see full details: exact timestamps, affected users/channels, detailed reason codes, and available actions (undo, investigate, etc.).

Filter & Search

Search and filter alerts by:

  • •User name or ID
  • •Alert type (Nuke, Raid, Ban Wave, etc.)
  • •Severity level
  • •Date range

UI Component Style Reference

All dashboard components follow consistent styling patterns:

Button Styles

Primary (Action) Buttons: Green background with black text. Used for "Save Settings", "Add to Whitelist", etc.

Danger Buttons: Red background with white text. Used for "Remove", "Delete", "Ban".

Secondary Buttons: Gray/muted background. Used for "Cancel", "Reset".

Dropdown Components

All dropdowns that require user selection use the SearchableSelect component. These are:

  • •Typeable for quick search
  • •Show icons for user/role types
  • •Filterable results as you type

Info Boxes

Information, tips, and warnings use colored boxes:

  • •Blue info: General information and feature explanations
  • •Green tips: Best practices and recommendations
  • •Yellow warnings: Important cautions and considerations

Common Dashboard Tasks

Quick how-to guides for frequently performed actions:

Respond to a Nuke Alert

  1. 1. Go to Anti-Nuke tab
  2. 2. Click alert in alerts section at bottom
  3. 3. Review details of nuke attempt
  4. 4. Click "Undo Actions" to restore permissions, or "Investigate User" to review their history

Whitelist a Trusted Bot

  1. 1. Go to Anti-Nuke → Whitelist Management
  2. 2. Select "User" from Type dropdown
  3. 3. Search for bot username in SearchableSelect
  4. 4. Click "Add to Whitelist"

Lift Raid Lockdown

  1. 1. Go to Anti-Raid tab
  2. 2. Find the "Active Lockdowns" section
  3. 3. Click "Lift Lockdown" next to affected channel/server

Review Quarantined Members

  1. 1. Go to Anti-Raid → Quarantine section
  2. 2. View list of quarantined members with their join dates
  3. 3. Click member to see details, manual verify, or remove from quarantine
← Anti-Raid ProtectionRBAC Overview →