The Browser Exploitation Framework Project
JavaScript Ruby CSS HTML Assembly ActionScript Other
Clone or download
Latest commit 1dea975 Jun 11, 2018
Permalink
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE.md May 13, 2016
arerules Add Coinhive Miner ARE rule Oct 14, 2017
core Code cleanup Jun 11, 2018
doc Updated Copyright dates Jan 3, 2018
extensions Warn on Event Logger load if WebSockets are enabled Jun 11, 2018
liveCD Updated Copyright dates Jan 3, 2018
modules Fix Webcam(Flash) incorrect base64 data image May 1, 2018
test Fix dependencies Mar 9, 2018
tools Add REST example to remove all offline browsers Jan 20, 2018
.gitignore Correct namespace errors in metasploit Feb 21, 2018
.ruby-gemset Added .ruby-gemset and .ruby-version for rvm Jul 5, 2015
.ruby-version Update Ruby version to 2.3.0 Apr 21, 2016
.travis.yml Update minimum required version of Ruby to 2.1 Oct 9, 2016
Gemfile Hard code gem 'therubyracer', '0.12.3' for Linux systems May 1, 2018
INSTALL.txt Update installation instructions Mar 7, 2018
README.md Merge branch 'master' into master Mar 9, 2018
Rakefile Remove bundle audit tests Mar 9, 2018
VERSION Updated Copyright dates Jan 3, 2018
beef Update minimum required Ruby version to 2.3.x Mar 7, 2018
beef_cert.pem Added default key/cert files for HTTPS support, added a few notes abo… Aug 6, 2012
beef_key.pem Added default key/cert files for HTTPS support, added a few notes abo… Aug 6, 2012
config.yaml Pruned unnecessary lines from config Jan 9, 2018
install Added ruby and ruby-rdoc to Arch installer May 5, 2018
update-beef Allow `update-beef` script to update dependencies Apr 1, 2018

README.md

===============================================================================

Copyright (c) 2006-2018 Wade Alcorn - wade@bindshell.net
Browser Exploitation Framework (BeEF) - http://beefproject.com
See the file 'doc/COPYING' for copying permission

===============================================================================

What is BeEF?

BeEF is short for The Browser Exploitation Framework. It is a penetration testing tool that focuses on the web browser.

Amid growing concerns about web-borne attacks against clients, including mobile clients, BeEF allows the professional penetration tester to assess the actual security posture of a target environment by using client-side attack vectors. Unlike other security frameworks, BeEF looks past the hardened network perimeter and client system, and examines exploitability within the context of the one open door: the web browser. BeEF will hook one or more web browsers and use them as beachheads for launching directed command modules and further attacks against the system from within the browser context.

Get Involved

You can get in touch with the BeEF team. Just check out the following:

Please, send us pull requests!

Web: https://beefproject.com/

Bugs: https://github.com/beefproject/beef/issues

Security Bugs: security@beefproject.com

IRC: ircs://irc.freenode.net/beefproject

Twitter: @beefproject

Requirements

Quick Start

The following is for the impatient.

The install script installs the required operating system packages and all the prerequisite Ruby gems:

$ ./install

For full installation details, please refer to INSTALL.txt.

We also have an Installation page on the wiki.

Upon successful installation, be sure to read the Configuration page on the wiki for important details on configuring and securing BeEF.

Usage

To get started, simply execute beef and follow the instructions:

   $ ./beef