Loading
Loading...
Groq LLM AI Engine Strict RBAC xterm.js Console

FlowForge IT Automation
Orchestrated by AI

A unified enterprise IT automation platform designed for modern infrastructure. Draft complex topologies with natural language, enforce Role-Based Access Control, manage server inventories, and execute remote commands securely across Linux and Windows fleets.

50-Worker Pool Capacity
AES-256-GCM Credential Vault
AD / LDAP Federation
FlowForge Visual Editor — Workflow #882 LIVE
Running
1. Pre-Flight Check
Validate disk space & SSH connectivity across 12 target hosts.
Success
2. Git Deploy & Build
Pull latest production branch, compile dependencies, verify binaries.
Success
3. OpenSSH Win Script
Execute PowerShell to migrate Windows VMs from WinRM to OpenSSH.
Manual Gate
4. Restart Nginx & IIS
Awaiting operator approval before restarting edge routing services.
[worker-pool] Active: 18 / 50  |  WS: Connected
View Logs

System Roles & User Mappings

FlowForge enforces strict Role-Based Access Control (RBAC) at both the UI and REST API layers. Users are organized into three distinct tiers with granular operational boundaries.

Super Admin

Local Fallback Operator

The emergency system setup operator. Validates credentials solely via local database fallback without requiring Active Directory or LDAP connectivity. Locked to Admin level — cannot be demoted or deleted.

  • Full administration & canvas rights
  • Manage primary Super Admin profile
  • Reset passwords for all user tiers
  • Troubleshoot AD / LDAP bind failures

Administrator (Admin)

AD / LDAP + Local Fallback

IT Operators responsible for architecting automation workflows, registering server inventories, and managing infrastructure. Authenticated via Active Directory or local credentials.

  • Access Visual Workflow Editor Canvas
  • Invoke Groq LLM AI Workflow Generator
  • Manage Servers Inventory & SSH Keys
  • Full Interactive Terminal (xterm.js) access

Standard User

Restricted Execution Tier

Support personnel, database operators, or server engineers who run pre-approved, safe automation tasks. Cannot modify DAG topologies, add servers, or open raw SSH shells.

  • Restricted Dashboard for assigned tasks
  • Trigger mapped automations only
  • Stream live WebSocket execution logs
  • Blocked from DAG Canvas & Terminals

Access Matrix & Capability Comparison

Granular feature permissions enforced across UI modules and REST API endpoints.

RBAC Policy Engine v2.4
Feature / UI Module Super Admin Administrator Standard User
System Dashboard / Full Access Full Access Assigned Only
Workflows Directory /workflows View & Execute All View, Edit, Execute Execute Assigned
Visual Canvas Editor /workflows/:id Authorized Authorized Blocked
AI Workflow Generator (Groq LLM) Authorized Authorized Blocked
Servers Inventory /servers Authorized Authorized Blocked
OpenSSH Win Script Generation Authorized Authorized Blocked
Interactive SSH Terminal /terminal Authorized Authorized Blocked
Audit Logs /audit-logs View All Logs View All Logs Own Logs Only
Users & Access Panel /users Full Access Full Access Blocked
Promote / Demote Admins Authorized Authorized Blocked
Delete Super Admin Account Protected Protected Blocked
Clean Up Stale Sessions & Logs Authorized Authorized Blocked

Core Modules & Page Walkthroughs

The FlowForge interface is organized into modular sections, each catering to specific operational workflows and infrastructure management tasks.

System Dashboard
/

Quick status indicators, metrics cards, and real-time execution streams for global infrastructure oversight.

  • Metrics Cards: Total Workflows, registered Servers, Active/Completed/Failed counters.
  • Worker Pool Monitor: Tracks load against hard-capped maximum of 50 workers (Admin-Only).
  • Executions Stream: Real-time log of latest 10 runs with clickable inspection badges.
Workflows Directory
/workflows

Central repository listing all available automations with pre-flight compiler validation and trigger controls.

  • 3 Trigger Types: Auto (end-to-end), Manual (step gates), recurring Cron schedules.
  • Execution Preview: Pre-flight compiler flags circular dependencies & missing targets.
  • Backup & Migration: Import/export JSON definitions across environments.
Visual Editor Canvas
/workflows/:id

Admin-only DAG canvas powered by React Flow and Dagre layouts to construct step topologies visually.

  • The Canvas: Render execution steps as Directed Acyclic Graphs from Start to End nodes.
  • Sidebar Config: Assign target Linux/Win hosts, Pre/Post-Conditions, and setup commands.
  • Inline SFTP: Configure remote folder uploads/downloads within workflow steps.
AI Workflow Generator
Groq LLM

Intelligent automation drafting powered by ultra-fast Groq LLM integration (Admin Only).

  • Natural Language Input: Enter "Deploy update from git, compile, and restart nginx".
  • AI Topology Parser: Automatically designs steps, connects dependencies, maps OS commands.
  • Instant Canvas Insertion: Inserts generated DAG directly onto the visual canvas for testing.
Servers Inventory
/servers

Register and maintain SSH target hosts with encrypted credential vaults and automatic OpenSSH enablement.

  • AES-256-GCM Vault: Passwords and .pem/.key private keys encrypted at rest.
  • WinRM → OpenSSH: Auto-generates downloadable PowerShell .ps1 for Windows VMs.
  • Health Wizard: Live handshake test confirms credentials before saving.
Interactive Terminal
/terminal

Secure web-based terminal client powered by xterm.js for direct command-line operations (Admin Only).

  • Tabbed Sessions: Multiple concurrent active SSH connections side-by-side.
  • Full Tool Support: Interactive tools (nano, vim, htop) run without timeouts.
  • Cross-Platform: Connect to Linux Bash/Zsh or Windows PowerShell consoles.
Executions & Logs
/executions

Real-time telemetry, WebSocket streaming, and interactive step attachment for active automation runs.

  • Dynamic DAG Canvas: 🔵 Running · 🟢 Completed · 🔴 Failed · 🟡 Manual Gate color states.
  • Live WebSocket Stream: Real-time stdout/stderr streaming directly into the log console.
  • Interactive Attachment: Interact directly with commands mid-execution if flagged as interactive.
Audit Logs Ledger
/audit-logs

Immutable compliance ledger tracking system-wide user activities and security modifications.

  • Comprehensive Telemetry: Tracks logins, workflow edits, terminal commands, user alterations.
  • Detailed Metadata: Records timestamp, username, target resource, action, and client IP.
  • Security Isolation: Admins see all logs; Standard users view only their own records.
Users & Access Panel
/users

Centralized identity provisioning and workflow assignment mapping for IT administrators.

  • Profile Provisioning: Manage usernames, passwords, system roles, and emails.
  • Workflow Assignment Modal: Granular panel to assign specific automations to standard users.
  • Zero-Trust Default: Standard users see no workflows unless explicitly mapped here.

Core Subsystems & Execution Models

Behind the visual interface, FlowForge operates on specialized execution modules to orchestrate commands reliably and securely across distributed environments.

01

Direct Mode (Synchronous)

Executes the target script directly on the remote host, streaming logs in real-time via WebSockets, and terminates cleanly when the process returns an exit code. Ideal for fast configuration scripts and health checks.

02

Screen / Detached Mode

Runs long-running tasks inside a detached background environment (e.g., Linux screen utility). Execution continues uninterrupted even if the browser is closed or connection drops. The engine polls for validation status at set intervals.

03

Interactive Live Console

Opens standard streams for bidirectional user input/output to handle prompts. Observes a critical 5-second silence stabilization delay to allow slow remote shell profiles (like .bashrc) to initialize without dropping command outputs.

Enterprise Identity Federation

Active Directory (AD) & LDAP Integration

The system intercepts login requests and issues secure bind queries to your AD / LDAP domain controllers using the User Principal Name (UPN) format: username@letshego.com. If AD verification passes, it cross-references the local database profile. If the profile exists, login succeeds instantly; if not, an admin must first provision a local record to enforce authorization boundaries.

// AD Auth Flow Handshake
> UPN: user@letshego.com
> LDAP Bind: SUCCESS
> Local Profile: VERIFIED
[AUTH GRANTED] Session Active
Section 4: Operational Tools

Administrative Scripts & Maintenance

Administrators can execute local CLI maintenance scripts on the FlowForge host environment for emergency recovery, user creation, domain testing, and automated database backups.

CLI User Creation & Recovery
create-user.ts User Provisioning

Creates a new user profile manually with a temporary password (enforces password change on first login).

npx tsx create-user.ts <username> <password> <role> <email>
reset-admin.js Emergency Recovery

Resets the emergency user sysadmin back to password sysadmin and grants full admin permissions.

node reset-admin.js
check-ad-user.js AD Diagnostics

Tests connectivity to the LDAP / Active Directory domain controller and reports account lockout or disabled status.

node check-ad-user.js
Automated Database Backup Pipeline
backup_db.sh & restore_db.sh Cron Pipeline

Configured inside the platform as a scheduled recurring cron workflow that dumps the PostgreSQL database into compressed archives. Weekly backup archives are stored on the target host (e.g., week24.sql.gz) and can be securely retrieved via SFTP by standard operators.

// Scheduled Docker Cron Command:
docker exec -t flowforge-db pg_dump -U flowforge flowforge | gzip > /backup/week$(date +%V).sql.gz
Storage Directory: /backup/*.sql.gz
Schedule Frequency: Weekly — Every Sunday @ 02:00 UTC
Start Automating Today

Ready to Automate Your IT Infrastructure?

Join the world's most innovative engineering teams scaling with FlowForge. Unify roles, orchestrate scripts with AI, and secure your remote operations.