System Architecture
This document describes the full-stack infrastructure of the GSCX platform, including client endpoints, load balancing, redundant web and database tiers, and the integrated Beezifi cybersecurity stack — from on-host intrusion detection through to the Beezifi Cybersecurity Command Center (BC3).
Architecture Diagram
The diagram below illustrates all tiers from client devices through to the database layer and the parallel security telemetry pipeline feeding BC3.
Desktops
Health Checks · SSL Termination
VRRP / Floating IP
128 GB SSD · Node.js/Express
Beezifi IDS ✦
128 GB SSD · Node.js/Express
Beezifi IDS ✦
24 TB SSD · MariaDB/MySQL
Beezifi IDS ✦
24 TB SSD · MariaDB/MySQL
Beezifi IDS ✦ · Sync Replication
Inbound + outbound IP capture
Auto-block malicious IPs
Command Center
Security Analysts + AI Agents
Proactive IP blocking & response
Pattern analysis
Autonomous response
Traffic Flow
The following steps describe the complete path of a client request from origin to data and back.
Client Tier
The GSCX platform is device-agnostic. All three client categories connect using standard HTTPS (port 443) with TLS 1.3 enforced at the load balancer.
Client Security Requirements
- TLS 1.3 minimum — older protocol versions are rejected at the load balancer
- All session tokens stored in
sessionStorage(not persisted to disk) - TOTP second factor required for privileged role actions
- No sensitive data cached in browser localStorage
Load Balancer Tier
A redundant load balancer pair sits at the internet edge. The primary node handles all active traffic; the standby node monitors via VRRP heartbeat and assumes the floating public IP within seconds of a detected failure.
Load Balancer Responsibilities
- Terminate inbound TLS; forward to web servers over internal mTLS
- Distribute traffic evenly across Web Server A and Web Server B
- Remove unhealthy web server nodes from the rotation automatically
- Rate-limit excessive connection attempts per source IP
- Forward real client IP via
X-Forwarded-Forheader for IDS logging
Web Server Tier
Two identical web server nodes run in an active-active configuration behind the load balancer. Both nodes serve live traffic simultaneously, maximizing throughput and providing immediate redundancy.
Hardware Specification
Web Server Software Stack
| Component | Software | Role |
|---|---|---|
| Application Runtime | Node.js | Execute GSCX Express application |
| Web Framework | Express 4.x | REST API routing, middleware pipeline |
| Process Manager | PM2 | Cluster mode (8 workers), auto-restart, zero-downtime reload |
| Reverse Proxy | Nginx | Internal TLS termination, static asset cache |
| Intrusion Detection | Beezifi IDS | Real-time IP inspection, automatic blocking, telemetry |
| Host Firewall | iptables / nftables | Enforce blocklist pushed from BC3 |
| Log Shipping | Filebeat | Forward access and error logs to BC3 SIEM |
Active-Active Redundancy
Both web server nodes run identical application versions at all times. The load balancer performs health checks every 5 seconds against each node's /api/health endpoint. If a node fails its health check three consecutive times, it is removed from rotation and the surviving node absorbs all traffic until the failed node recovers.
Database Server Tier
Two database servers — Primary and Replica — operate in a synchronous replication configuration. Writes go to the Primary; the Replica is promoted automatically on Primary failure. Both nodes run Beezifi IDS for east-west traffic monitoring.
Hardware Specification
Database Software Stack
| Component | Software | Role |
|---|---|---|
| Database Engine | MariaDB 10.x | Relational data store for all GSCX platform data |
| Replication | Semi-Sync Replication | Writes acknowledged only after replica confirms receipt |
| HA Orchestration | Orchestrator / MHA | Monitors topology, triggers automatic failover |
| Backup | Percona XtraBackup | Hot physical backups — no downtime required |
| Intrusion Detection | Beezifi IDS | Monitor DB connection attempts, query anomalies, lateral movement |
| Audit Log | MariaDB Audit Plugin | Capture all DDL/DML for compliance and forensics |
Beezifi Intrusion Detection System
Beezifi IDS is deployed as an on-host agent on every web server and database server node. It provides real-time inspection of all network traffic entering and leaving each host and enforces automatic blocking of identified malicious actors.
Core Capabilities
DROP rule into the host firewall (iptables / nftables). No manual intervention required. Blocks take effect in under 100ms.Beezifi IDS Endpoint
The Beezifi Intrusion Detection Endpoint is the per-host telemetry agent that bridges on-host detection activity to the centralized BC3 Command Center.
Endpoint Data Pipeline
| Data Collected | Direction | Destination | Frequency |
|---|---|---|---|
| Source IP of every inbound connection | Inbound | BC3 Threat Intelligence | Real-time stream |
| Destination IP of every outbound connection | Outbound | BC3 Threat Intelligence | Real-time stream |
| Block events (auto-blocked IPs) | Event | BC3 Incident Queue | Immediate push |
| Anomaly alerts (behavioral deviation) | Alert | BC3 Analyst Dashboard | Immediate push |
| Host health metrics (CPU, mem, net) | Health | BC3 Monitoring | Every 30 seconds |
Beezifi Cybersecurity Command Center (BC3)
BC3 is the centralized security operations platform that aggregates telemetry from all Beezifi IDS Endpoint agents across the infrastructure. It provides the tooling, dashboards, and orchestration layer for both human security analysts and AI Security Agents.
BC3 Architecture
BC3 Functional Modules
AI Security Agents
BC3 integrates AI Security Agents that operate autonomously alongside human analysts. These agents continuously analyze telemetry streams, learn from historical patterns, and execute response actions without waiting for human approval — compressing threat response time from minutes to milliseconds.
AI Agent Capabilities
Human-AI Collaboration Model
| Threat Confidence | AI Action | Analyst Role |
|---|---|---|
| High (>95%) | Autonomous block pushed to all nodes | Notified; can override within 15 min |
| Medium (60–95%) | Temporary block + escalate to queue | Reviews and confirms or reverses |
| Low (<60%) | Flag and watch; no block | Reviews enriched alert; decides action |
| Unknown / Novel | Capture and sandbox; immediate escalate | Hands-on forensic investigation |
Redundancy Strategy
Every tier of the infrastructure is designed with a redundant peer. The following table summarizes redundancy across the full stack.
| Tier | Primary | Redundant Peer | Failover Mode | RTO |
|---|---|---|---|---|
| Load Balancer | LB Primary | LB Hot Standby | VRRP / Floating IP | < 5 sec |
| Web Server | Web Server A | Web Server B | Active-Active; LB removes failed node | Instant (no failover needed) |
| Database | DB Primary | DB Replica | Semi-sync replication; auto-promote | < 30 sec |
| BC3 / IDS | BC3 Primary | BC3 Warm Standby | State sync; manual or auto-promote | < 60 sec |
No Single Points of Failure
- Client connectivity: Multiple ISP uplinks on the load balancer pair
- Load balancer: Hot-standby with shared virtual IP via VRRP
- Web application: Two active nodes; either can serve all traffic alone
- Database writes: Semi-synchronous replication — replica is always current
- Database reads: Can be offloaded to replica during primary maintenance
- Security monitoring: BC3 warm standby preserves telemetry continuity
Failover & Recovery Procedures
Load Balancer Failover
- VRRP keepalive packet is missed by the standby LB (threshold: 3 missed at 1-second interval)
- Standby LB claims the floating public IP via gratuitous ARP broadcast
- DNS / BGP upstream sees no change — the IP is the same
- Traffic resumes through the standby within 2–5 seconds
- On-call alert fires to the operations team for investigation
Web Server Node Failure
- Load balancer health check fails three consecutive times against the affected node
- Node is removed from the active rotation — zero new requests are sent to it
- Surviving node absorbs 100% of traffic (8 PM2 workers provide ample headroom)
- PM2 on the failed node attempts automatic process restart
- Once health check passes, the node is reintroduced to the rotation gracefully
Database Primary Failure
- Orchestrator detects Primary DB is unreachable (3 consecutive missed heartbeats)
- Replica is confirmed up-to-date (semi-sync guarantees no data loss)
- Replica is promoted to Primary — VIP / DNS CNAME updated automatically
- Web servers reconnect to new Primary using connection pool retry logic
- A new Replica is provisioned from the promoted Primary to restore HA state
Hardware Summary
| Node | Count | CPU Cores | RAM | Storage | Role |
|---|---|---|---|---|---|
| Load Balancer | 2 | — | — | — | Traffic routing, TLS termination, HA pair |
| Web Server | 2 | 8 | 32 GB | 128 GB SSD | Node.js/Express API, SPA serving |
| Database Server | 2 | 32 | 128 GB | 24 TB SSD | MariaDB Primary + Replica |
Software Summary
| Software | Deployed On | Purpose | Status |
|---|---|---|---|
| Node.js / Express | Web Server A, B | GSCX REST API and SPA backend | Active |
| PM2 | Web Server A, B | Cluster process manager, zero-downtime deploys | Active |
| Nginx | Web Server A, B | Reverse proxy, static asset serving, mTLS | Active |
| MariaDB | DB Primary, Replica | Relational data store | Active |
| Beezifi IDS | Web Server A, B · DB Primary, Replica | On-host intrusion detection, auto IP blocking | Security |
| Beezifi IDS Endpoint | Web Server A, B · DB Primary, Replica | IP telemetry collection, streaming to BC3 | Security |
| BC3 (Beezifi Cybersecurity Command Center) | Dedicated BC3 Server (HA pair) | Centralized threat intelligence, analyst dashboard, AI agents | Command |
| AI Security Agents | BC3 | Automated threat detection, behavioral analysis, autonomous response | Command |
| Percona XtraBackup | DB Primary, Replica | Hot physical database backups | Ops |
| Filebeat | All server nodes | Log shipping to BC3 SIEM | Ops |