[7.1.0] - 2026-10-14
- Updated Starkiller to v4.1.0
Security
- Fixed the
persistence/osx/LaunchAgentmodule staging its plist through a predictable/tmppath and runningchown/mvviasubprocesswithshell=True; the plist is now written directly to the LaunchAgents directory with no shell (BC-SECURITY/Empire#828). - Fixed the
persistence/osx/CreateHijackermodule writing its patched dylib to a predictable, world-writable/tmp/<dylib name>path; it now patches amkstempfile in place. - Fixed command injection through the global obfuscation command: it is no longer passed through a shell, and is validated against the Invoke-Obfuscation command grammar before use.
- Fixed command injection through the
MSF_Formatoption of thewindows/cmd_execstager: msfvenom is now invoked with an argument list instead of a shell command string. - Fixed arbitrary file write through the
BinaryFileoption of thelinux/pyinstallerstager: the build now runs in a server-owned temporary directory and only the option's file name is used. - Hardened the http listener's unauthenticated
?stager=endpoint so unknown languages are rejected before any database query, and removed the temp artifacts compiled stager builds leave behind on both listeners. - Stopped a staging-key holder provoking a listener 500 -- and with it the IIS cover story -- by discarding routing packets whose session ID is not valid UTF-8 and rejecting invalid Diffie-Hellman peer keys in all four STAGE1 branches.
- Confined the
http_hoplistener'sOutFolderand the redirect listener's profile URIs todownloads/http_hop, closing an arbitrary file write available to any non-admin operator. - Confined the
OutFileoption of the PowerBreacheventlog,deaduserandresolvermodules todownloads/generated-modules, closing an arbitrary file write available to any non-admin operator. - Rejected an
OutFolderorOutFilethat resolves onto the shared output directory itself, which one operator could turn into a regular file and wedge every other operator's writes. - Confined the
ExtFile,FileandShellcodemodule path options to the downloads directory, closing an arbitrary file read available to any enabled operator. - Anchored the upload directory to the downloads root in
_secure_upload_location, so a traversinguser.usernameorsubdirectorycannot place a file outside it. - BREAKING: STAGE1 Ed25519 signatures now cover the handshake transcript instead of the constant
"SIGNATURE", so a captured certificate cannot be replayed with a substituted DH key. Re-stage all pre-7.1 agents. - BREAKING: The AES-CBC payload layer derives separate AES and HMAC keys from the shared key with HKDF-SHA256 (
empire-enc/empire-mac) instead of reusing one key. - C# (Sharpire) agents now authenticate the server: the
csharpstaging branch sends a transcript-bound server certificate, which the agent verifies before deriving the session key.
Added
- Added
logging.file_logging(envEMPIRE_LOGGING__FILE_LOGGING) for console-only container logging, pluslogging.max_bytesandlogging.backup_countrotation limits.
Changed
persistence/osx/LaunchAgentandpersistence/osx/CreateHijackernow refuse to generate while the shipped Mach-O templates link Apple's removed Python 2.7 framework, instead of planting a binary that cannot load on macOS 12.3 or later; the module descriptions say so, pending a template rebuild.- BREAKING: The
linux/pyinstallerstager'sBinaryFileoption is now a bare file name defaulting toempirerather than/tmp/empire— any directory component is ignored and the built binary is no longer left on the server at that path, though it is still delivered underOutFileas before. - BREAKING: The http and http_malleable listeners now serve their default response instead of a Werkzeug 500 page for any error that escapes a view.
- BREAKING: The
http_hoplistener'sOutFolderis now relative todownloads/http_hopand defaults toredirectors; hop listeners stored with an absolute path outside it no longer start. - BREAKING: OpenAPI operation ids are now
{tag}_{route name}(e.g.agents_read_agent) instead of FastAPI's path-and-method default, which also renames the three generatedBody_*request schemas — a generated client needs no post-processing of the spec, but every method name it produces changes. - BREAKING: The agent-task and plugin-task routes are tagged with only their primary resource, dropping the
taskstag group. - BREAKING: The
/api/v2/obfuscationroutes moved from thekeywordstag toobfuscation. - BREAKING:
empire_server.logandlistener_<name>.lognow rotate at 10 MB with 5 backups, deleting older data; setlogging.max_bytes: 0for unbounded logs. - BREAKING: The
ExtFile,FileandShellcodemodule options must now name a path inside the server's downloads directory; saved workflows pointing elsewhere are rejected until the file is uploaded through the API. - A listener's
Hostmay now carry the public port whilePortstays the bind port, for deployments behind a reverse proxy. AHostwithout a port still advertises the bind port. The listener-generated HTTP-family and malleable launchers and stagers use the advertised address; thewindows/c_launcherstager and PIC shellcode still pair the hostname with the bindPort. The malleable listener still decides whether it serves TLS, and whether its agent comms trust a self-signed certificate, from the scheme inHost. ThePort cannot be provided in a host namevalidation error is gone. (#808) - C# (Sharpire) stagers now embed the listener's server Ed25519 public key so the agent authenticates the server during staging; requires Empire-Compiler v2.0.3, which this release pins.
Fixed
- Fixed gopire ignoring the listener's 401 (tasking polls now GET with the listener's session cookie instead of a hard-coded
session) and a lost limit that never fired (0now disables it); undecodable or empty 200s and a profile with no task URIs now count as misses. - Empire Compiler downloads now retry transient GitHub failures with backoff and are installed atomically; a failed or corrupt download no longer crashes server startup.
- Fixed
multi/generate_agentignoring theBypassesoption when generating a stageless agent; bypasses matching the agent's language are now prepended to it, and IronPython drops Python bypasses as staged generation does (BC-SECURITY/Empire#778). - Fixed
powershell/privesc/bypassuac_tokenmanipulationalways emitting an empty-encargument, so the elevated process never fetched the stager; it now encodes the cradle as UTF-16LE, assumeshttp://for a bareHost, and rejects at generation time aHostcarrying userinfo, a port, a path, control characters, or a non-http(s) scheme, an invalidPort, and aStagerthat is empty or could break out of the single-quoted cradle (BC-SECURITY/Empire#547). - Fixed
management/osx/shellcodeinject64crashing on any real shellcode file (bytes passed tostr.replace) and on an emptyShellcodepath (directory read); both now generate or raise a validation error. - Fixed
collection/osx/native_screenshot_mssembedding abytesrepr (b'...') in its emitted script, which the agent-side base64 decode turned into garbage. - Fixed the Python and IronPython agents building but never sending the error packet for a failed foreground Python task, which left the task pending forever with no output.
- Fixed
persistence/osx/LaunchAgent,persistence/osx/LaunchAgentUserLandPersistence,persistence/osx/CreateHijackerandprivesc/multi/bashdooremitting Python 2 code (octal literals,except E, e, text-mode binary I/O) that failed to compile or run on the Python 3 agent.LaunchAgentUserLandPersistencenow launches with an absolute Python 3 path resolved on the agent (its own interpreter, falling back topython3onPATH) instead of the removedpython, andCreateHijackerraises on failure so a failed hijack no longer reports as a completed task. - Fixed a
BinaryFilewith an extension (agent.bin) failing thelinux/pyinstallerstager with an opaque 500, and aBinaryFileofempire.pyreturning the plaintext launcher source in place of the compiled binary. - Fixed a failed
pyinstaller, a missing or unrunnablemsfvenom, and an unusableBinaryFile,MSF_FormatorArchvalue surfacing as a 500 instead of a stager-generation error naming the cause. - Fixed the malleable PowerShell stager splitting custom headers on commas, which broke any profile header value containing a comma, such as a Chrome User-Agent. Header entries are now separated with a dedicated marker. (#829)
- Fixed the
http,http_hop, andport_forward_pivotPowerShell stagers and comms dropping the custom headers fromDefaultProfile. They are now rendered into a$Script:Headershashtable that the stager and the agent send on every request. (#831) - Fixed the malleable
/init/default stager URI being added alongside the URIs a profile'shttp-stagerblock declares, so launchers could pick a URI the profile never defined. Launchers generated before this change that call/init/against such a profile must be regenerated. - Fixed the malleable PowerShell launcher dropping the
?before a stager block'sparameterquery string (Crimeware/quantloader,Crimeware/jasperloader). - Fixed listener autorun failures during agent staging rolling back Stage 2 registration: a failing autorun entry is now logged and skipped, remaining autorun entries still execute, and
AFTER_AGENT_CHECKIN_HOOKfires for every agent that completes staging. - Fixed
NameError: name 'job_message_buffer' is not definedwhen a background Python job (e.g.python/collection/linux/xkeylogger) streams output viajob_message_buffer(...), by exposing it in the exec scope used bypython_job_func. - Fixed the PowerBreach
eventlogandresolvermodules reporting a successfulOutFilewrite as "PowerBreach deaduser backdoor written to". - Fixed an unwritable PowerBreach
OutFilesurfacing as an opaque 500 instead of a 400 naming the output directory. - Fixed the Go staging branch intermittently rejecting valid STAGE1 bodies (~0.3%) by sizing the body with
len(message)instead of the length of itsrepr. - Fixed staging desyncing (~1 in 256) when the server's DH public key had a leading zero byte; the server and every agent now use a fixed 768-byte width.
- Sharpire stagers now receive the listener's default response; a template typo left the
REPLACE_DEFAULTRESPONSEplaceholder unsubstituted.