【保姆级Python教学】万物皆可 API

今天看到一个开源项目,叫做 Command2API,感觉挺有意思的,分享给大家。
起源 关于这个项目为什么诞生,原 Repo 有这么一段:


以近期 Log4j 的 RCE 举例,在内网的安全测试中,由于网络环境限制导致没有 DNSLog 平台可用,这时候做 Log4j 的漏洞验证就考虑直接查看 LDAP 服务是否有连接进来,但是现成的 JNDI 注入工具开启服务并没有 API 可以直接拉取对应服务的结果,这就导致需要人工去查看,很费时间,再加上已经写好 BurpSuite 被动插件进行扫描了,为了节省时间就简单写了这个脚本用于获取 JNDI 工具的执行结果并通过 API 的形式返回,便于插件拉取结果进行漏洞验证。

反正大意就是说,有些命令的执行结果如果能够通过 HTTP的 API 暴露出来,我们就能更方便地获取到命令的执行结果,在某些场景下会非常方便。
所以,这里作者写了这个项目。
原理 这个原理其实非常简单,就是用一个 Python 线程开启 Web 服务,一个线程执行命令,通过全局变量与 Web 服务共享执行命令的结果。
运行 这里我们来运行下看看效果吧。
首先需要下载下项目:
git clone https://github.com/gh0stkey/Command2API.git

然后接着指定想运行的命令和 API 运行的端口就好了,样例如下:
python Command2Api.py "执行的命令" Web运行的端口


注意,这里的 python 使用的 Python2,而不是 Python3,因为原项目引用了一个包叫 BaseHTTPServer,Python3 是没有的。

这里我们执行一个 ping 命令来试试:
python Command2Api.py "ping www.baidu.com" 8888

运行结果如下:
【保姆级Python教学】万物皆可 API
文章图片

可以看到,这里首先输出了一个运行的地址:
URL: http://HOST:8888/c1IvlLF9

这时候我们打开 http://localhost:8888/c1IvlLF9 看下。
【保姆级Python教学】万物皆可 API
文章图片

可以看到控制台结果就呈现在网页里面了。

但是这个页面没法自动刷新,需要点击刷新来获取最新的结果。

介绍完了。
所以,这个项目在某些情况下还是挺有用的。
比如说:
  • 内网安全测试中,可以用于获取 JNDI 工具的执行结果并通过API的形式返回,可以更方便地观测执行结果。
  • 我们想监控或实时获取某个命令行程序的输出结果,比如 Scrapy 爬虫、比如 Web Server 等等,可以将其暴露出来。
  • 我们想快速分享某个程序的执行结果,则可以通过这个命令配合 Ngrok 生成一个网站分享出去。
等等。
源码解析 我们再来看看源码吧,其实非常简单,一共就这些代码:
import subprocess import BaseHTTPServer import SimpleHTTPServer import cgi import threading import sys import string import randoml = []uri = '/' + ''.join(random.sample(string.ascii_letters+string.digits,8))class thread(threading.Thread): def __init__(self, threadname, command): threading.Thread.__init__(self, name='Thread_' + threadname) self.threadname = int(threadname) self.command = commanddef run(self): global l ret = subprocess.Popen( self.command, shell=True, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE ) for i in iter(ret.stdout.readline, b""): res = i.decode().strip() print(res) l.append(res)class ServerHandler(SimpleHTTPServer.SimpleHTTPRequestHandler): def do_GET(self): global l if self.path == uri: self.send_response(200) self.send_header('Content-Type', 'text/plain') self.end_headers() self.wfile.write(l)if __name__ == '__main__': # New Thread: Get Command Result t1 = thread('1', sys.argv[1]) t1.start() # Webserver port = int(sys.argv[2]) print("URL: http://HOST:{0}{1}".format(port, uri)) Handler = ServerHandler httpd = BaseHTTPServer.HTTPServer(('0.0.0.0', port), Handler) httpd.serve_forever()

可以看到这个命令就是 Popen 执行的,然后通过 PIPE 将结果捕获出来赋值为变量,然后同时另外一个线程启动服务器,将这个结果写入到 Response 里面。
就是这么简单的代码,实现了如此便捷的功能。
优化 不过我看这个项目还是有很多优化空间的,简单总结下:
  • 现在支持的是 Python2 而不是 Python3。
  • 网页结果不能自动刷新。
  • 网页结果是一个列表,和控制台的结果格式不太统一。
  • 不能通过 pip 来安全这个工具包。
  • 输出结果的 HOST 可以优化一下,直接复制出来不好访问。
  • 可以配合 Ngrok 将结果进行公开暴露。
  • 如果能通过网页来对命令进行交互控制就更好了。
我看看如果有时间的话,我可以试着将这个项目改写下并实现如上的一些优化功能哈,到时候写完了发出来。
【【保姆级Python教学】万物皆可 API】谢谢阅读~

    推荐阅读