Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/firesunCN/BlueLotus_XSSReceiver
https://github.com/firesunCN/BlueLotus_XSSReceiver
ctf
Last synced: 8 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/firesunCN/BlueLotus_XSSReceiver
- Owner: firesunCN
- License: gpl-2.0
- Created: 2015-10-12T06:37:45.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-02-02T10:10:14.000Z (over 1 year ago)
- Last Synced: 2024-05-29T17:54:20.806Z (29 days ago)
- Topics: ctf
- Language: JavaScript
- Homepage:
- Size: 17.4 MB
- Stars: 1,480
- Watchers: 68
- Forks: 994
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: change_encrypt_pass.php
- License: LICENSE
Lists
- awesome-github-star - BlueLotus_XSSReceiver
README
# XSS数据接收平台（无SQL版）
如从旧版本升级，请务必先阅读Readme。同时，只是一个很久以前打CTF比赛练手的项目，现在回看起来很多地方写的都不优雅，不过难得的发现过了这么多年还能使用。本项目仅供学习交流使用，不得用于任何非法用途。
## 平台说明
* 本平台设计理念: 简单配置即可使用，无需数据库，无需其他组件支持，可直接在php虚拟空间使用
* SAE用户请切换到sae分支，并阅读sae分支下的README.md
##安装说明
###自动安装
* 安装http server与php环境（ubuntu: sudo apt-get install apache2 php5 或 sudo apt-get install apache2 php7.4 libapache2-mod-php7.4）
* 上传所有文件至空间根目录
* 访问http://网站地址/
* 根据提示配置xss平台
* 在配置前，需要赋予xss数据存储路径、js模板存储路径、我的js存储路径写权限，以及平台根目录写权限（sudo chmod 777 -R ./）
* 完成安装，访问http://网站地址/admin.php登录后台
* 当有请求访问/index.php?a=xxx&b=xxxx，所有携带数据包括get，post，cookie，httpheaders，客户端信息都会记录
* 如不做二次开发，可直接删除根目录下diff、guide、src目录
* 如果有权限，请开启Apache中的AllowOverride以使.htaccess生效（可选）
* xss数据存储路径将被设置为禁止web访问
* js模板存储路径、我的js存储路径将被设置为仅允许访问js文件
###手动安装
* 安装http server与php5环境（ubuntu: sudo apt-get install apache2 php5）
* 上传所有文件至空间根目录
* 将config-sample.php重命名为config.php，修改config.php，指定xss数据、我的js、js模板的存放目录，以及数据是否启用加密、加密密码、与加密方法（详细说明见文件注释）
```php
define('PASS', '2a05218c7aa0a6dbd370985d984627b8');
define('DATA_PATH', 'data');
define('JS_TEMPLATE_PATH', 'template');
define('MY_JS_PATH', 'myjs');
define('ENABLE_ENCRYPT', true);
define('ENCRYPT_PASS', 'bluelotus');
define('ENCRYPT_TYPE', 'RC4');
```
* PASS为登录密码，可用`php -r '$salt="!KTMdg#^^I6Z!deIVR#SgpAI6qTN7oVl";$key="你的密码";$key=md5($salt.$key.$salt);$key=md5($salt.$key.$salt);$key=md5($salt.$key.$salt);echo $key;'`生成密码hash
* 赋予`DATA_PATH`，`MY_JS_PATH`，`JS_TEMPLATE_PATH`对应的目录写权限
* 当有请求访问/index.php?a=xxx&b=xxxx，所有携带数据包括get，post，cookie，httpheaders，客户端信息都会记录
* 可访问admin.php登录查看记录的数据，初始登录密码bluelotus
* 如不做二次开发，可直接删除根目录下diff、guide、src目录
* 如果有权限，请开启Apache中的AllowOverride以使.htaccess生效（可选）
* DATA_PATH被设置为禁止web访问
* MY_JS_PATH与JS_TEMPLATE_PATH被设置为仅允许访问js文件
## 目前支持功能
* 自动判断携带数据是否base64编码，可自动解码
* 记录所有可记录的数据，并可根据ip判断位置，根据useragent判断操作系统与浏览器
* 新消息提醒，仿QQ邮箱新消息提醒框，可实时获得数据
* 支持简单的查找功能
* 除了style允许unsafe-inline外启用CSP
* 挑战应答式的登录校验，session绑定ip与useragent
* 密码输错五次封IP，误封请删除`DATA_PATH`/forbiddenIPList.dat文件
* 可以通过平台直接维护用于xss的js文件（详细说明见下）
## js公用模板模块
* 用户可添加一些js通用模板，在我的js里可随时插入js模板
* 采用ace编辑器，支持js语法高亮，语法错误检查
* 使用js_beautify实现js代码格式化，可随时格式化js代码
* 使用jsmin实现js代码压缩，可随时压缩js代码
* 支持复制js代码的url到剪切板（需要浏览器支持flash）
* 提供了一些常用的js模板，包括前几天心血来潮研究的用js截图，许多模板都是来自各大xss平台，但是又记不起来是分别来自哪，只能再次对各位安全研究人员表示感谢
## 我的js模块
* 用户可随时插入js模板
* 部分整合[xssor](https://github.com/evilcos/xssor)功能，方便生成payload，xssor有跟强大的功能，大家可以去follow evilcos的github
## keepsession功能
* 需要在config.php开启
* 如果请求的get或post或cookie中带有keepsession=1，则这条记录会被keepsession
* 请设置脚本或者网站监控定期访问keepsession.php
* 请将cookie存在cookie参数，url存在location参数（传递方法可get可post可cookie），如`index.php?keepsession=1&cookie=aaa&location=bbb`,keepsession.php将会定期使用cookie aaa去访问bbb
* cookie和location参数支持base64编码，keepsession.php会自动判断，自动解码
* 如果不设置location，将会使用HTTP Referer作为url
* keepsession.php使用`flock($pid, LOCK_EX|LOCK_NB)`实现单例运行（由于windows下不支持无阻塞锁定，所以最好删除keepsession.php里的`set_time_limit(0)`），可自行加上sleep防止keepsession.php被恶意频繁访问
* 请自己做好SSRF防护
## 邮件提醒
修改config.php相关配置即可，默认关闭，开启后，每次接收到xss都会发邮件通知，需要短信提醒的直接把接收邮箱设置为手机邮箱即可
```
define('MAIL_ENABLE', false);//开启邮件通知
define('SMTP_SERVER', 'smtp.xxx.com');//smtp服务器
define('SMTP_PORT', 465);//端口
define('SMTP_SECURE', 'ssl');
define('MAIL_USER', '[email protected]');//发件人用户名
define('MAIL_PASS', 'xxxxxx');//发件人密码
define('MAIL_FROM', '[email protected]');//发件人地址（需真实，不可伪造）
define('MAIL_RECV', '[email protected]');//接收通知的邮件地址
```
## 修改数据加密密码，加密方式
* 本平台对xss记录、ip封禁列表、js的说明（仅说明）加密，用户可设置是否加密，密码以及加密方式（AES、RC4）
* 3.0版本起配置里的默认加密方式改为RC4（为了效率）
* 如果需要改密码，改加密方式，需要对xss记录、ip封禁列表、js的说明进行重加密才能正常访问这些数据
* 故根目录下提供了change_encrypt_pass.php用于重新加密xss记录,js的描述,ip封禁列表
* 请在修改加密方式或者加密密码后执行此文件（如果选择不加密,加密密码可写任意值）
* **使用前，请将change_encrypt_pass.php开始的exit()注释掉，并且在使用前务必做好数据备份以防不测**
* 用法：在shell下执行
`php change_encrypt_pass.php (以前是否加密true/false) (旧加密密码) (旧加密方法AES/RC4) (现在是否加密) (新加密密码) (新加密方法)`
* 例:
* `php change_encrypt_pass.php true bluelotus AES true bluelotus RC4`
* `php change_encrypt_pass.php true bluelotus AES false xxxx(任意值) AES`
* 也可执行
* `php change_encrypt_pass.php update (以前是否加密true/false) (旧加密密码)`
* 此命令可将所有“xss记录”转化为加密开启，密码bluelotus，加密方法RC4
## 旧版本升级
### 不保留数据
如无需保留xss数据，直接删除原平台，重新安装即可
### 保留数据
1. 备份数据
2. 删除原平台，重新安装xss平台，配置时，是否加密，加密密码与加密方式需要与以前一样（早期版本，加密方式选AES）
3. 复制原平台`DATA_PATH`，`MY_JS_PATH`，`JS_TEMPLATE_PATH`对应的目录，覆盖新平台的相应目录
4. 升级完成
注：
如果重新安装xss平台时，选择的手动安装，升级步骤如下
1. 备份数据
2. 删除原平台，重新安装xss平台，修改config.php配置，是否加密，加密密码与加密方式需要与以前一样（早期版本，加密方式写AES）
3. 执行change_encrypt_pass.php完成重加密的过程
`php change_encrypt_pass.php true bluelotus RC4 (配置文件中是否加密) (配置文件中加密密码) (配置文件中加密方法)`
4. 修改config.php，修改是否加密，新密码，加密方式
5. 复制原平台`DATA_PATH`，`MY_JS_PATH`，`JS_TEMPLATE_PATH`对应的目录，覆盖新平台的相应目录
6. 升级完成
## TODO
* 支持SAE
* 多用户（SQL版本）
* WebSocket方式通知
## src目录说明
* static/js与static/css下的js与css文件已压缩
* 其中`jqxcore.js、jqxdata.js、jqxgrid.js、jqxgrid.columnsresize.js、jqxgrid.filter.js、jqxgrid.edit.js、jqxgrid.pager.js、jqxgrid.selection.js、jqxgrid.sort.js、jqxbuttons.js、jqxcombobox.js、jqxdropdownlist.js、jqxinput.js、jqxlistbox.js、jqxmenu.js、jqxscrollbar.js、jqxsplitter.js、jqxtabs.js、jqxtextarea.js、jqxtoolbar.js、jqxwindow.js`合并为`jqwidgets.min.js`
* css与js源文件移至src目录下，方便二次开发
## 特别说明
* 前端使用[Bootstrap](http://getbootstrap.com/)与[jQWidgets](http://www.jqwidgets.com/)开发，（原来用kendo UI，受限于商业许可，改用jQWidgets），`you can use jQWidgets for free under the Creative Commons Attribution-NonCommercial 3.0 License`, 但是不可用于商业用途，如需用于商业用途请购买授权
* 为实现jqxgrid不支持的功能，如固定表格高度实现row高度自动调节，修改了jQWidgets部分代码，具体修改部分可查看diff文件夹
* 使用纯真ip库的函数基于Discuz X3.1 function_misc.php上修改而来, 判断客户端操作系统与浏览器的脚本基于原作者@author Jea杨写的php版本修改而来，后台整体布局借鉴Kendo UI 的demo NORTHWIND DASH
* js代码格式化使用[js_beautify](https://github.com/beautify-web/js-beautify)库
* js代码压缩采用jsmin.js
* js代码编辑器采用[ace](https://ace.c9.io)
* 安装脚本完全参考[wordpress](https://cn.wordpress.org/)的安装程序
* **Warning: 本工具仅允许使用在CTF比赛等学习、研究场景，严禁用于非法用途**
## 意见与建议
欢迎大家在使用过程中提出各种宝贵的意见和建议，以及各种bug，不胜感激
反馈邮箱firesun.cn`at`gmail.com