XCat 技术文档

1. 安装指南

XCat 是一个用于利用和调查盲 XPath 注入漏洞的命令行工具。以下是安装 XCat 的几种方式：

使用 pip 安装

确保你的系统已经安装了 Python 3.7 或更高版本。然后运行以下命令：

pip install xcat

使用 Docker 安装

如果你更喜欢使用 Docker，可以通过以下命令运行 XCat：

docker run -it tomforbes/xcat --help

在 Fedora 上安装

如果你使用的是 Fedora 系统，可以通过以下命令安装 XCat：

dnf install xcat

使用 pyenv 安装 Python 3.7

如果你的系统上没有 Python 3.7，可以使用 pyenv 来安装：

pyenv install 3.7.1

2. 项目的使用说明

XCat 提供了丰富的功能来帮助用户检测和利用 XPath 注入漏洞。以下是 XCat 的主要功能和使用方法：

自动选择注入点

XCat 可以自动选择注入点。你可以通过以下命令查看支持的注入点列表：

xcat injections

检测 XPath 解析器版本和功能

XCat 能够检测目标系统的 XPath 解析器版本和功能，并选择最快的检索方法。

内置的 HTTP 服务器

XCat 内置了一个 HTTP 服务器，支持以下功能：

• 自动化 XXE 攻击
• 使用 OOB HTTP 请求来加速数据检索

自定义请求头和请求体

你可以通过 XCat 自定义请求头和请求体，以适应不同的测试场景。

内置的 REPL Shell

XCat 提供了一个内置的 REPL Shell，支持以下操作：

• 读取任意文件
• 读取环境变量
• 列出目录内容
• 上传和下载文件（即将推出）

优化的数据检索

XCat 在数据检索方面进行了优化，支持以下功能：

• 如果可用，使用 Unicode 码点的二分搜索
• 回退机制包括优先搜索先前检索到的常见字符
• 规范化 Unicode 以减少搜索空间

3. 项目 API 使用文档

XCat 提供了丰富的 API 接口，方便开发者集成和使用。以下是 XCat 的主要 API 接口：

自动选择注入点

from xcat import XCat

xcat = XCat()
injections = xcat.get_injections()
print(injections)

检测 XPath 解析器版本和功能

from xcat import XCat

xcat = XCat()
version = xcat.detect_version()
print(version)

自定义请求头和请求体

from xcat import XCat

xcat = XCat()
xcat.set_headers({"User-Agent": "XCat/1.0"})
xcat.set_body("param1=value1&param2=value2")
response = xcat.send_request()
print(response)

使用 REPL Shell

from xcat import XCat

xcat = XCat()
xcat.start_repl()

4. 项目安装方式

XCat 支持多种安装方式，包括 pip、Docker 和 Fedora 包管理器。以下是详细的安装步骤：

使用 pip 安装

pip install xcat

使用 Docker 安装

docker run -it tomforbes/xcat --help

在 Fedora 上安装

dnf install xcat

使用 pyenv 安装 Python 3.7

pyenv install 3.7.1

通过以上步骤，你可以成功安装并使用 XCat 来进行 XPath 注入漏洞的检测和利用。希望这篇文档能帮助你更好地理解和使用 XCat。