LimaCharlie Automated Reporting Extension Documentation

The LimaCharlie Report Extension is a webservice that automatically generates and emails comprehensive cybersecurity reports for your organization. It collects detection data, usage statistics, DNS queries, EDR insights, and sensor information to create PDF reports on weekly, monthly, or custom schedules.

Support Contact: support@magonia.io
Support Hours: Best effort between 8-5pm EST (though we'll do our best to reply ASAP regardless of time)

Example Report Screenshots

An example of the report - NOTE: This is NOT all of the pages

How It Works

Architecture Overview

  1. Extension Service: Receives report generation requests from LimaCharlie via scheduled rules or manual triggers
  2. ValKey Queue: Stores pending report requests
  3. Backend Service: Processes queued requests
  4. Data Collection: Queries LimaCharlie for security data using LCQL
  5. Report Generation: Creates charts and PDF reports
  6. Email Service: Sends reports via SMTP

Report Types

  • Weekly Reports: Generated automatically every week on your configured day
  • Monthly Reports: Generated automatically on the last day of each month
  • Custom Reports: Generated on-demand with configurable lookback periods

Configuration Fields

SMTP Configuration (Required for Email Delivery)

Field Description Required Example
smtp_username SMTP username for sending emails Yes reports@example.com
smtp_password SMTP password for authentication Yes your-smtp-password
smtp_server SMTP server hostname Yes smtp.gmail.com
smtp_port SMTP server port Yes 587
contact_email Email address to receive reports Yes security@example.com

Report Customization

Field Description Required Example
client_name Name displayed on report cover No (default: "SECOPS Monthly Report") Acme Corporation
mssp_company_name Your company name on report No SecureIT Solutions
mssp_company_address Your company address No 123 Security Lane,\nSuite 100,\nNew York, NY 10001
weekly_pdf_filename Filename for weekly PDFs No Weekly_Security_Report.pdf
monthly_pdf_filename Filename for monthly PDFs No Monthly_Security_Report.pdf

Theme Customization

Field Description Required Example
bg_color Background color (hex) No (default: #0a0f2c) #1a1a2e
text_color Text color (hex) No (default: #FFFFFF) #FFFFFF
accent_color Accent color (hex) No (default: #00f0ff) #00D9FF
title_font_size Cover page title size (0-87) No (default: 86) 72

Report Scheduling

Field Description Required Example
enable_weekly_report Enable weekly reports No (default: true) true
weekly_report_day Day for weekly reports (0=Mon, 6=Sun) No (default: 6) 5 (Friday)
enable_monthly_report Enable monthly reports No (default: true) true
enable_debug Enable debug logging No (default: false) false

Manual Report Generation

To generate a custom report, use the "Generate Cybersecurity Report" action with:

Parameter Description Required Example
hours_lookback Hours of data to include (max: 8764) Yes 720 (30 days)

Getting Help

For assistance, contact support@magonia.io with:

  • Organization ID
  • Error messages from logs
  • Report type and time range
  • Configuration details (excluding passwords)