Summary
File Browser: Command Injection via Authentication Hook Shell Substitution (Pre-Authentication RCE)
Full technical description
Overview
The Hook Authentication feature in File Browser allows administrators to delegate login verification to an external shell command. User-supplied credentials (username and password) are interpolated into this command string using os.Expand without sanitization. An unauthenticated remote attacker can inject shell metacharacters in the username or password field at the login screen, causing the server to execute arbitrary OS commands before any authentication takes place. This is a critical pre-authentication RCE.
Affected Location
- File:
auth/hook.go - Function:
HookAuth.RunCommand
CVSS v4.0
| Metric | Value | Rationale |
|---|---|---|
| Attack Vector (AV) | Network (N) | Exploitable via the login endpoint over HTTP from any network |
| Attack Complexity (AC) | Low (L) | Single crafted HTTP request; no preparation needed |
| Attack Requirements (AT) | None (N) | No race condition or special timing required |
| Privileges Required (PR) | None (N) | No account required, pre-authentication attack |
| User Interaction (UI) | None (N) | Fully automated; no victim action needed |
| Vulnerable System Confidentiality (VC) | High (H) | Full read access to server filesystem and env |
| Vulnerable System Integrity (VI) | High (H) | Arbitrary file write/modification |
| Vulnerable System Availability (VA) | High (H) | Can kill processes, exhaust resources |
| Subsequent System Confidentiality (SC) | None (N) | No direct impact on downstream systems assumed |
| Subsequent System Integrity (SI) | None (N) | , |
| Subsequent System Availability (SA) | None (N) | , |
Vector String: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N
Base Score: 9.3 (Critical)
Note: PR:None is the critical differentiator from vulnerabilities 01 and 02. Because the injection point is the unauthenticated login endpoint, no account or session is required. A single HTTP request to the login API is sufficient to achieve RCE.
CWE
| ID | Name | Role |
|---|---|---|
| CWE-78 | Improper Neutralization of Special Elements used in an OS Command ('OS Command Injection') | Primary, attacker-supplied credentials embedded in shell command string via os.Expand |
| CWE-88 | Improper Neutralization of Argument Delimiters in a Command ('Argument Injection') | Secondary, $USERNAME/$PASSWORD expansion injects additional shell commands |
| CWE-306 | Missing Authentication for Critical Function | Secondary, OS command execution is reachable before any authentication is verified |
Technical Details
HookAuth.RunCommand builds the authentication command and substitutes credential values using os.Expand:
// auth/hook.go
envMapping := func(key string) string {
switch key {
case "USERNAME":
return a.Cred.Username // directly from the HTTP login request body
case "PASSWORD":
return a.Cred.Password // directly from the HTTP login request body
default:
return os.Getenv(key)
}
}
for i, arg := range command {
if i == 0 { continue }
command[i] = os.Expand(arg, envMapping) // no escaping applied
}
os.Expand performs plain text substitution. There is no escaping, quoting, or validation of the credential values before they are embedded into the command string.
If an admin has configured the hook authentication command as:
sh -c "test $USERNAME = 'admin'"
...and an attacker submits the username ; id # at the login screen, the expanded command becomes:
sh -c "test ; id # = 'admin'"
The ; terminates the test expression and the shell executes id. The # comments out the remainder, preventing a syntax error. The attacker's command runs with the privileges of the File Browser process, without needing a valid account or password.
Attack Scenario / Reproduction Steps
- Admin enables Hook Authentication and sets the command to:
sh -c "test $USERNAME = 'admin'" - An unauthenticated attacker sends a login request (e.g., via
curlor the web UI) with:- Username:
; id # - Password: (any value)
- Username:
- The server executes:
sh -c "test ; id # = 'admin'" - The
idcommand runs on the server, confirming pre-authentication RCE.
No account is needed. The attacker does not need to know any valid credentials. A single request is sufficient.
Proof of Concept
package auth
import (
"os"
"strings"
"testing"
)
func TestPoC_AuthHookInjection(t *testing.T) {
// Simulate the admin-configured hook authentication command.
// This represents a realistic configuration: verify the username via a shell expression.
a := &HookAuth{
Command: "sh -c $USERNAME",
Cred: hookCred{
// Attacker-supplied username from the login form.
// The password is irrelevant.
Username: "id ; echo injected",
Password: "anything",
},
}
// Simulate the RunCommand logic in auth/hook.go
command := strings.Split(a.Command, " ")
envMapping := func(key string) string {
if key == "USERNAME" {
return a.Cred.Username
}
return os.Getenv(key)
}
for i, arg := range command {
if i == 0 {
continue
}
// os.Expand substitutes $USERNAME with the attacker's input.
// The result is treated as a shell script, no escaping is applied.
command[i] = os.Expand(arg, envMapping)
}
// The shell will execute: sh -c "id ; echo injected"
expectedArg := "id ; echo injected"
if command[2] != expectedArg {
t.Errorf("Expected command argument %q, got %q", expectedArg, command[2])
}
t.Logf("Confirmed: malicious username was injected as a shell script. Executing: %v", command)
}
Impact
An unauthenticated remote attacker can execute arbitrary OS commands on the server under the privilege level of the File Browser process. This is the most severe class of vulnerability in this codebase:
- No authentication required, exposed to the entire internet if the service is public-facing.
- Single request, no setup, no enumeration, no prior foothold.
- Full server compromise: data exfiltration, persistent backdoor installation, lateral movement to internal networks.
Any internet-facing File Browser instance with Hook Authentication enabled is fully compromised by a single malformed login attempt.
Untrusted input reaches a shell command, allowing arbitrary commands to run on the host. Typical impact: code execution in the application's environment.
Affected versions
Security releases
Kodem intelligence
Severity tells you how bad this could be in the worst case. It does not tell you whether you are exposed. Exploitability and impact are functions of runtime truth: whether the vulnerable code is present, reachable, and actually executes in your application. A vulnerable package can sit in your dependency tree and never run.
Kodem, an Intelligent Application Security platform, uses runtime intelligence to reveal which vulnerabilities actually execute in production, so teams prioritize the ones that genuinely matter. Kodem's runtime-powered SCA identifies whether this CVE is reachable in your applications.
Already deployed Kodem?
See it in your environmentNew to Kodem? Get a demo →Remediation advice
Pass credentials exclusively as environment variables, not as shell string substitutions. This feature is undocumented, so removing it should not cause issues.
Frequently Asked Questions
- What is CVE-2026-54088? CVE-2026-54088 is a critical-severity OS command injection vulnerability in github.com/filebrowser/filebrowser/v2 (go), affecting versions <= 2.63.5. It is fixed in 2.63.6. Untrusted input reaches a shell command, allowing arbitrary commands to run on the host.
- Which versions of github.com/filebrowser/filebrowser/v2 are affected by CVE-2026-54088? github.com/filebrowser/filebrowser/v2 (go) versions <= 2.63.5 is affected.
- Is there a fix for CVE-2026-54088? Yes. CVE-2026-54088 is fixed in 2.63.6. Upgrade to this version or later.
- Is CVE-2026-54088 exploitable, and should I be worried? Whether CVE-2026-54088 is exploitable in your environment depends on whether the vulnerable code is present and reachable. A CVSS score is a worst-case rating; it does not account for your specific deployment, configuration, or usage patterns. Kodem, an Intelligent Application Security platform, uses runtime intelligence to show which vulnerabilities actually execute in production, so you can focus on the ones that represent real risk. Get a demo
- What actually determines whether CVE-2026-54088 is exploitable, and how bad it is? Exploitability and impact are not fixed properties of a CVE. They depend on runtime truth: whether the vulnerable code is present, reachable, and actually executes in your application. A high CVSS score on a dependency that never runs is not the same as real risk. Kodem, an Intelligent Application Security platform, uses runtime intelligence to reveal which vulnerabilities actually execute in production, so teams prioritize the ones that genuinely matter.
- How do I fix CVE-2026-54088? Upgrade
github.com/filebrowser/filebrowser/v2to 2.63.6 or later.