===============================================================================
Copyright (c) 2006-2020 Wade Alcorn - [email protected]
Browser Exploitation Framework (BeEF) - http:https://beefproject.com
See the file 'doc/COPYING' for copying permission
===============================================================================
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.
You can get in touch with the BeEF team. Just check out the following:
Please, send us pull requests!
Bugs: https://github.com/beefproject/beef/issues
Security Bugs: [email protected]
Twitter: @beefproject
- Operating System: Mac OSX 10.5.0 or higher / modern Linux. Note: Windows is not supported.
- Ruby: 2.5 or newer
- SQLite: 3.x
- Node.js: 6 or newer
- The gems listed in the Gemfile: https://github.com/beefproject/beef/blob/master/Gemfile
- Selenium is required on OSX: brew install selenium-server-standalone (See https://github.com/shvets/selenium)
ActiveRecord was used to replace DataMapper, and now ruby 2.4 is no longer supported. If you're using ruby 2.4 please update your BeEF version, otherwise master-0.4.7.3 has the beef branch before the ActiveRecord Merge.
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 Configurationpage on the wiki for important details on configuring and securing BeEF.
Go to beefproject.github.io/beef/index.html in order to view the JSdocs for BeEF.
To get started, simply execute beef and follow the instructions:
$ ./beef