Nothing Special   »   [go: up one dir, main page]

Skip to content
This repository has been archived by the owner on Oct 22, 2024. It is now read-only.
/ poc-runner Public archive

Small & Fast Vulnerability Scanner Engine based on XRAY YAML Rule | 基于 XRAY YAML 规则的超轻量快速漏洞扫描引擎 | 基于 ANTLR 实现语法分析和完整的 XRAY YAML 规则实现 | 简单的启动参数 | 包含多种反连可用 | 可执行文件体积仅 2 MB

License

Notifications You must be signed in to change notification settings

4ra1n/poc-runner

Repository files navigation

poc-runner

CHANGE LOG

gitleaks badge

前往下载

DESC

asciicast

XRAY POC RUNNER (Open Source Version)

这是一个 XRAYYAML 开源执行器(虽然网上已经有很多个开源实现了)

可执行文件体积 非常小(例如 windows-amd642 MB

主要特性:

  • 完全开源(所有代码开源不存在闭源二进制文件)
  • 无需复杂的 yaml 配置文件且命令行参数尽可能简化
  • 完全不使用 google/cel 库(使用底层 antlr 实现更轻量的表达式解析)
  • 完全不使用 net/http 库(使用 net.Dial 从零实现 raw http client

反连内置了 dnslog.cnprojectdiscovery/interactsh 无需配置直接使用

注意:本项目 不提供 任何 POC 规则文件(仅提供执行引擎)

POC 仓库: https://github.com/chaitin/xray/tree/master/pocs

仅供个人学习和研究使用,请勿用于非法用途

Quick Start

基础使用 poc-runner -r [poc].yml -t [target]

加入 -debug 打印所有请求响应

加入 -proxy 参数启动代理

HTML 报告页面

反连

默认使用 dnslog.cn 作为反连

你可以使用 -reverse interact.sh 指定使用 projectdiscovery/interactsh

由于网络原因,建议搭配代理使用

./poc-runner -r [poc].yml -t http://target -reverse interact.sh -proxy socks5://127.0.0.1:10808

API

Get

go get github.com/4ra1n/poc-runner/api@0.1.2

Example

package main

import (
	"context"
	"fmt"

	"github.com/4ra1n/poc-runner/api"
)

var poc = `name: poc-yaml-test
transport: http
set:
  rand: randomInt(200000000, 210000000)
rules:
  r0:
    request:
      cache: true
      method: POST
      path: /test
      headers:
        Content-Type: text/xml
      body: test
      follow_redirects: false
    expression: response.status == 404
expression: r0()`

func main() {
	ctx := context.Background()
	runner, err := api.NewPocRunner(ctx)
	if err != nil {
		return
	}
	report, err := runner.Run([]byte(poc), "https://example.com")
	if err != nil {
		return
	}
	fmt.Println(report)
}

Advance Example

func main() {
	ctx := context.Background()
	// NEW ADVANCE POC RUNNER
	runner, err := NewPocRunnerEx(
		ctx,                        // CONTEXT
		"socks5://127.0.0.1:10808", // SOCKS PROXY
		time.Second*10,             // TIMEOUT
		true,                       // DEBUG MODE
		"dnslog.cn",                // REVERSE CONFIG (dnslog.cn | interact.sh)
		log.DebugLevel,             // LOG LEVEL
	)
	if err != nil {
		return
	}
	// RUN POC
	report, err := runner.Run([]byte(poc), "https://example.com")
	if err != nil {
		return
	}
	fmt.Println(report)
}

BUILD

WINDOWS: 参考 build.bat

LINUX: 参考 .github/build.yml

CONTRIBUTE

Thank you for your interest in contributing to the poc-runner project

欢迎师傅们贡献 poc-runner 项目,所有 PR 都会经过 CODE REVIEW

注意:请尽量不要引入第三方库,尽可能使用标准库实现功能,本项目的宗旨是轻量

SUPPORT

type

yaml type golang type support version
int int 0.0.1
string string 0.0.1
bool bool 0.0.1
bytes []byte 0.0.1
map map[string]string 0.0.1
object interface 0.0.1

response variables

name type support version
response.status int 0.0.1
response.headers map 0.0.1
response.content_type string 0.0.1
response.body bytes 0.0.1
response.body_string string 0.0.1

string function

name args return support version
bsubmatch bytes map 0.0.1
submatch string map 0.0.1
bmatches string map 0.0.1
matches string map 0.0.1
contains string bool 0.0.1
icontains string bool 0.0.1

bytes function

name args return support version
bcontains bytes bool 0.0.1
icontains bytes bool 0.0.1

builtin function

name args return support version
bytes string bytes 0.0.1
string any string 0.0.1
substr string,int,int string 0.0.1
sleep int bool 0.0.1
randomInt int,int int 0.0.1
randomLowercase int string 0.0.1
randomUppercase int string 0.0.1
md5 string string 0.0.1
sha1 string string 0.0.1
sha256 string string 0.0.1
base64 bytes|string string 0.0.1
urldecode bytes|string string 0.0.1
get404Path null string 0.0.1
newReverse null object 0.0.1
print object bool 0.1.0

reverse variables

name return support version
reverse.url string 0.0.1
reverse.rmi string 0.0.1
reverse.ldap string 0.0.1
reverse.domain string 0.0.1

reverse function

name args return support version
wait int bool 0.0.1

TEST

以下 POC 已在真实漏洞环境测试通过

plugin name result remark
tomcat-cve-2017-12615-rce.yml /
spring-cve-2016-4977.yml /
apache-httpd-cve-2021-40438-ssrf.yml /
apache-httpd-cve-2021-41773-path-traversal.yml /
apache-http-cve-2021-41773-rce.yml /
coldfusion-cve-2010-2861-lfi.yml /
confluence-cve-2021-26084.yml /
activemq-cve-2016-3088.yml /
couchdb-cve-2017-12635.yml /
discuz-wooyun-2010-080723.yml /
docker-api-unauthorized-rce.yml /
elasticsearch-cve-2014-3120.yml /
elasticsearch-cve-2015-1427.yml /
elasticsearch-cve-2015-5531.yml /
jenkins-cve-2018-1000861-rce.yml /
joomla-cve-2017-8917-sqli.yml /
kibana-cve-2018-17246.yml /
laravel-cve-2021-3129.yml /
phpmyadmin-cve-2018-12613-file-inclusion.yml /
solr-cve-2017-12629-xxe.yml reverse
solr-cve-2019-0193.yml /
weblogic-cve-2017-10271.yml reverse
weblogic-cve-2019-2725.yml /
weblogic-cve-2019-2729-1.yml /
weblogic-cve-2019-2729-2.yml /
weblogic-cve-2020-14750.yml /
weblogic-ssrf.yml /
zabbix-cve-2016-10134-sqli.yml /

Star

Star History Chart

THANKS

部分代码参考: https://github.com/raylax/rayx

感谢

About

Small & Fast Vulnerability Scanner Engine based on XRAY YAML Rule | 基于 XRAY YAML 规则的超轻量快速漏洞扫描引擎 | 基于 ANTLR 实现语法分析和完整的 XRAY YAML 规则实现 | 简单的启动参数 | 包含多种反连可用 | 可执行文件体积仅 2 MB

Topics

Resources

License

Stars

Watchers

Forks