Skip to content

WIT-Systems/LegacyWebBox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 

Repository files navigation

LegacyWebBox

A lightweight, zero-dependency standalone utility designed to access and manage legacy networking infrastructure, hardware appliances, and web interfaces that rely strictly on antiquated internet technologies.

The Problem

Many End-of-Life (EOL) enterprise assets—such as legacy managed switches, old IP cameras, power distribution units (PDUs), and server management cards—rely heavily on archaic, non-standard JavaScript architectures (like document.all) or proprietary Microsoft components.

Modern browsers (Chrome, Edge, Firefox) have completely deprecated these frameworks or strictly block the insecure/legacy security layers required to view them. This results in missing frame components, broken layouts (such as the infamous "black bar" menu glitch), or complete page-rendering failures.

Some devices (such as the Linksys SRW2048 managed switch) also rely on window.open() popups for core configuration tasks like VLAN assignment. These popups fail entirely in modern browsers and lose session state even in partial compatibility modes — making it impossible to save configuration changes without a native IE session.

The Solution

LegacyWebBox generates and launches a temporary VBScript that opens a real Internet Explorer instance with the correct IE8 document mode pre-configured via registry. Because it uses the actual iexplore.exe process rather than a WebBrowser control wrapper, it handles session cookies, popups, modal dialogs, and proprietary add-ons (such as MSXML 3.0) exactly as the device manufacturer intended — with no layout errors, no authentication failures on popups, and no manual compatibility mode switching required.

The temporary VBScript is written to the user's temp directory, executed, and deleted automatically — leaving no residue.

Key Features

  • 🛠️ Zero Dependencies: No external runtimes or framework installation required.
  • 📦 Completely Standalone: Compiles into a single, highly portable executable (~15 KB).
  • 🔒 Interactive Connection Prompt: Input any IP address or host URL directly at startup.
  • 🛑 No Licensing Hurdles: Avoid bloated third-party browser extensions or commercial subscriptions.
  • 🪟 Native IE Session Handling: Popups, modal dialogs and MSXML add-ons work correctly because real iexplore.exe is used — not a browser control wrapper.
  • 🧹 Clean Execution: The temporary VBScript is auto-deleted after launch.

How to Build Locally

You do not need Visual Studio or complex development suites to build this project. Windows includes the native C# compiler framework out of the box.

Prerequisites

  • A machine running Microsoft Windows (Windows 10 or Windows 11).
  • Internet Explorer must be present on the system (iexplore.exe). On Windows 10/11, IE is disabled by default in the browser sense but the executable and Trident engine remain available. If iexplore.exe is missing, re-enable it via: Control Panel → Programs → Turn Windows features on or off → Internet Explorer 11.

Step-by-Step Compilation

  1. Open a command prompt (cmd.exe) or terminal in your project directory.
  2. Run the following command to invoke the native .NET compiler and compile the binary:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /target:winexe /r:Microsoft.VisualBasic.dll /out:LegacyWebBox.exe Program.cs
  1. The resulting LegacyWebBox.exe is fully self-contained and portable.

How It Works

At launch, LegacyWebBox performs the following steps:

  1. Prompts the user for the target device IP address or URL.
  2. Writes a temporary VBScript to %TEMP%\legacywebbox_tmp.vbs that:
    • Sets the FEATURE_BROWSER_EMULATION registry key to 8888 (IE8 document mode) for iexplore.exe.
    • Pre-approves the MSXML 3.0 COM add-on ({F5078F32-C551-11D3-89B9-0000F81FE221}) to suppress the security prompt required by some device interfaces.
    • Launches iexplore.exe via InternetExplorer.Application and navigates to the target URL.
  3. Executes the VBScript via wscript.exe.
  4. Waits 2 seconds for the script to be read, then deletes it.

Because the session lives entirely within a real IE process, all popups and child windows opened by the device's web interface automatically inherit the same session cookies — solving the authentication failure that affects WebBrowser control wrappers and modern browsers alike.

Registry Keys Written

Key Value Purpose
HKCU\...\FEATURE_BROWSER_EMULATION\iexplore.exe 8888 Forces IE8 document mode
HKCU\...\Ext\Settings\{F5078F32...}\Flags 0 Pre-approves MSXML 3.0 add-on

These keys are written to HKCU (current user only) and do not require administrator privileges.


Tested Devices

  • Linksys SRW2048 48-port managed switch (VLAN management, port configuration)

If you have tested LegacyWebBox with other legacy devices, contributions and issue reports are welcome.


Known Limitations

  • Requires Internet Explorer to be present on the system (the executable, not necessarily enabled as a default browser).
  • IE8 document mode may not be appropriate for all legacy devices — future versions may allow the document mode to be configured per-host.
  • The 2-second delay before VBScript deletion is fixed; on very slow systems the script may be deleted before IE finishes reading it (harmless, but the registry keys would not be set).

About

a simple program to acess old tech specifically the linksys RSW2048

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages