Need help with polyshell?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

llamasoft
164 Stars 20 Forks 2 Commits 2 Opened issues

Description

A Bash/Batch/PowerShell polyglot!

Services available

!
?

Need anything else?

Contributors list

# 28,787
batch-s...
Node.js
web-app...
hashico...
1 commit

PolyShell: a Bash/Batch/PowerShell polyglot

What It Is

PolyShell is a script that's simultaneously valid in Bash, Windows Batch, and PowerShell (i.e. a polyglot).

This makes PolyShell a useful template for penetration testing as it can be executed on most systems without the need for target-specific payloads. PolyShell is also specifically designed to be deliverable via input injection using a USB Rubby Ducky, MalDuino, or similar device.

Batch demo Powershell demo Unix shell demo

How To Use It

As a stand-alone script

  1. Copy/rename the script so it has the correct file extension (
    .sh
    ,
    .bat
    , or
    .ps1
    ).
  2. Run the script with a Unix shell, as a batch file, or with PowerShell.

Using input injection

  1. Open a terminal on the target machine.
  2. Run the payload.
  3. Press Ctrl-C, then run
    exit
    .

The input injection method will behave slightly differently than the script method. When run as a script, the payload will exit immediately once a language has been processed. When delivered via injection, the payload runs a read loop instead. Without it, the payload would close the terminal window but continue typing into an unknown window instead. The Ctrl-C breaks the script out of the read loop, allowing it run without unintended side-effects.

Additionally, pasting the script into a terminal might fail. Once the script reaches the read loop, some terminals will treat the remaining pasted text as the read loop's input (good), but others may continue executing the script when the read loop exits (bad).

How It Works

The main trick is to get each other language to "look away" when we want to run code specific to only one of them. This is accomplished by exploiting language quirks surrounding quoting, redirection, and comments.
Consider the following line:

echo \" </dev/null ">NUL "\" \`" 

Each language sees the

echo
command, but will interpret the rest of the line differently.
For example, this is what each language will interpret as a string:
      echo \" </dev/null ">NUL "\" \`" 

After executing the line, the bash script will be in a here document, PowerShell script will be in a multiline-comment, and the batch script will continue executing normally. After each language is done executing, we terminate it. This prevents us from needing to work around its quirks later in the script.

Quirks

Obviously, the tricks required to make this polyglot doesn't follow normal coding conventions.
There are quite a few quirks that were leveraged or had to be worked around:

  • All three languages have different escape characters:
    • Bash: backslash (
      \
      )
    • Batch: caret (
      ^
      )
    • PowerShell: backtick (
      `
      )
  • Escape characters work inside Bash and PowerShell strings, but not batch strings.
  • Redirects (i.e.
    <
    and
    >
    ) have special meaning in all three languages unless quoted.
  • Redirects don't have to be at the end of a command.
    • This is valid Bash/Batch/PowerShell:
      echo >output.txt "Hello World"
  • Batch is the only language without multi-line strings or comments.
  • Batch treats
    >
    as a redirect even when it directly touches a string, but PowerShell doesn't.
  • Batch script
    GOTO
    statements only work when run as a script, not when run interactively.
  • PowerShell's multi-line comment (
    ) must be immediately preceded by whitespace.
  • Bash's here documents may begin anywhere so long as it's unquoted and not a comment.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.