Details ‐ Agents

Agents Page Documentation

The Agents page in ShellSweepX provides functionality for managing and monitoring remote agents, downloading agent scripts, and configuring agent settings. This page serves as a central hub for all agent-related activities within the ShellSweepX system.

Page Structure

The agents.html template is structured as follows:

1. Header: Contains the ShellSweepX logo and navigation menu.
2. Main Content:
   • Agent Downloads Section
   • Active Agents List
   • Agent Configuration Form
3. Footer: Displays copyright information and a link to Terms of Service.

Key Features

1. Agent Downloads

• Provides downloadable agent scripts for different operating systems:
  • Windows:
    • Windows Agent (PowerShell)
    • Windows Scan Script (PowerShell)
  • Linux:
    • Linux Scan Script (Shell Script)
    • Linux Agent (Python)
• Download links are styled for visibility and to indicate visited status.

2. Active Agents List

• Displays a table of active agents with the following information:
  • Computer Name
  • Last Check-in Time
• The table is populated dynamically using JavaScript (likely in the agents.js file).

3. Agent Configuration

• Allows users to configure various settings for the agents:
  • File Extensions: Dynamically add file extensions to scan.
  • Directories to Scan: Specify directories for the agents to scan.
  • Exclude Paths: Set paths to exclude from scanning.
  • Ignore Hashes: List hashes of files to ignore during scans.
• The configuration form uses expandable textareas for better user experience.

JavaScript Integration

• The page uses a separate JavaScript file (agents.js) for dynamic functionality.
• Key JavaScript functions (implemented in agents.js):
  • addFileExtension(): Dynamically adds input fields for file extensions.
  • Form submission handling for saving the configuration.

Styling

• The page uses CSS styles defined in /static/css/styles.css.
• Custom styling is applied to download links and form elements for better usability.