b6425e4a90
* fixed offline zombie not deleting * Bump jsdoc-to-markdown from 6.0.1 to 7.0.1 (#2161) Bumps [jsdoc-to-markdown](https://github.com/jsdoc2md/jsdoc-to-markdown) from 6.0.1 to 7.0.1. - [Release notes](https://github.com/jsdoc2md/jsdoc-to-markdown/releases) - [Commits](https://github.com/jsdoc2md/jsdoc-to-markdown/compare/v6.0.1...v7.0.1) --- updated-dependencies: - dependency-name: jsdoc-to-markdown dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Bug: Core - 1785 Fixed public hook url configuration settings (#2163) * added spec file for testing changes * added local host getter to configuration class * added default value 0.0.0.0 for local host if it's not set * added port config getter with default * added port config getter with default * fixed spelling errors for port * added public configuration values and validation * removed logic from public port as it was not required * added beef host to configuration class * added beef port to configuration class and removed default http.port logic from public_port * fixed rubocop errors and refactored spec tests * added beef host configuration values used for external resources * added beef url to configuration * added spec file for testing changes * added local host getter to configuration class * added default value 0.0.0.0 for local host if it's not set * added port config getter with default * added port config getter with default * fixed spelling errors for port * added public configuration values and validation * removed logic from public port as it was not required * added beef host to configuration class * added beef port to configuration class and removed default http.port logic from public_port * fixed rubocop errors and refactored spec tests * added beef host configuration values used for external resources * added beef url to configuration * created command spec file * add before statement to load all enabled modules to test command class * add spec to check if configuration instance exists by setting and accessing a config variable * updated http proto for beef host * reverting changes on this file, dev values set * removed some unessessary checks * fixed grammar test now we're only testing one configuration attribute * added hook url for contextual usage * refactoring admin_ui with new code usage * fixed issue with the location of the beef.http.https.public_enabled * refactored powershell module and extension * adding the new config setting for public https beign enabled * refactor qrcode extension * replace video fake plugin refactor * social engineering refactoring * phonegap module refactoring * exploit refactoing * network module refactoing * ipec module refactoring * host module refactoring * debug refactoring * browser refactoring * social engineering extension refactoring * core main server refactoring * core main console banner refactoring * removing dev test * fixed area with location of http.https.enabled * changed the hook url definition to return the hook file path * updated banners to use new configuration getters * updated extensions and modules with the hook url change * added new public.host configuration settings and validations for depicated usage of public * updated to use public.port configuration * added validation for old configuration public_port * updated to use public https configuration setting * updated config with new settings format * fixed get to point to new locations * fixed pointer to hook_file_path * Update extensions/social_engineering/web_cloner/web_cloner.rb Co-authored-by: bcoles <bcoles@gmail.com> * updated enabled to enable * making sure default configuration file does not have preset values Co-authored-by: bcoles <bcoles@gmail.com> * bumped versions to 0.5.2.0 * Usability: #2145. Added user input request for beef update within 'beef' install script (#2162) * added user input request for beef update * swaped git pull from system to backticks * flags added for auto update and timout to input * updated install.txt to reference the update-beef script (#2160) Co-authored-by: Andrew Wheatley <a@andrews-mini.home> Co-authored-by: Isaac Powell <36595182+DeezyE@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: bcoles <bcoles@gmail.com>
78 lines
1.9 KiB
Plaintext
78 lines
1.9 KiB
Plaintext
===============================================================================
|
|
|
|
Copyright (c) 2006-2021 Wade Alcorn - wade@bindshell.net
|
|
Browser Exploitation Framework (BeEF) - http://beefproject.com
|
|
See the file 'doc/COPYING' for copying permission
|
|
|
|
===============================================================================
|
|
|
|
Source
|
|
------
|
|
|
|
Obtain application source code either by downloading the latest archive:
|
|
|
|
$ wget https://github.com/beefproject/beef/archive/master.zip
|
|
|
|
Or cloning the Git repository from Github:
|
|
|
|
$ git clone https://github.com/beefproject/beef
|
|
|
|
|
|
Prerequisites
|
|
--------------
|
|
|
|
BeEF requires Ruby 2.5+.
|
|
|
|
If your operating system package manager does not support Ruby version 2.5,
|
|
you can add the brightbox ppa repository for the latest version of Ruby:
|
|
|
|
$ sudo apt-add-repository -y ppa:brightbox/ruby-ng
|
|
|
|
Alternatively, consider using a Ruby environment manager such as rbenv or rvm
|
|
to manager your Ruby versions. Refer to the following for more information:
|
|
|
|
* rbenv: https://github.com/rbenv/rbenv
|
|
* rvm: https://rvm.io/rvm/install
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
Once Ruby is installed, run the install script in the BeEF directory:
|
|
|
|
./install
|
|
|
|
This script installs the required operating system packages and all the
|
|
prerequisite Ruby gems.
|
|
|
|
Upon successful installation, be sure to read the Configuration page
|
|
on the wiki for important details on configuring and securing BeEF.
|
|
|
|
https://github.com/beefproject/beef/wiki/Configuration
|
|
|
|
|
|
Start BeEF
|
|
----------
|
|
|
|
To start BeEF, simply run:
|
|
|
|
$ ./beef
|
|
|
|
|
|
Updating
|
|
--------
|
|
|
|
Due to the fast-paced nature of web browser development and webappsec landscape,
|
|
it's best to regularly update BeEF to the latest version.
|
|
|
|
If you're using BeEF from the GitHub repository, updating is as simple as:
|
|
|
|
$ ./update-beef
|
|
|
|
Or pull the latest repo yourself and then update the gems with:
|
|
|
|
$ git pull
|
|
|
|
$ bundle
|
|
|