/tabby

A CAT called tabby ( Code Analysis Tool )

Primary LanguageJavaApache License 2.0Apache-2.0

TABBY

English Version

Platforms Java version License

TABBY is a Java Code Analysis Tool based on Soot .

It can parse JAR/WAR/CLASS files to CPG (Code Property Graph) based on Neo4j .

TABBY 是一款针对 Java 语言的静态代码分析工具,相关工作已被接收发表在 The 53rd Annual IEEE/IFIP International Conference on Dependable Systems and Networks (DSN 2023),会议论文录用名单详见DSN2023

TABBY使用静态分析框架 Soot 作为语义提取工具,将JAR/WAR/CLASS文件转化为代码属性图。 并使用 Neo4j 图数据库来存储生成的代码属性图CPG。

Note: 如果使用中存在什么问题,欢迎在 discussions 提问!

Note: Welcome to new a discussion at discussions about TABBY!

#1 使用方法

使用 Tabby 需要有以下环境:

  • JAVA 环境
  • 可用的 Neo4j 图数据库
  • Neo4j Browser 或者其他 Neo4j 可视化的工具

具体的使用方法参见: Tabby Quick Start

#2 Tabby 的适用人群

开发 Tabby 的初衷是想要提高代码审计的效率,尽可能的减少人工检索的工作量

使用 tabby 生成的代码属性图(当前版本 1.2.0)可以完成以下的工作场景:

  • 挖掘目标项目中的反序列化利用链,支持大多数序列化机制,包括 Java 原生序列化机制、Hessian、XStream 等
  • 挖掘目标项目中的常见 Web 漏洞,支持分析 WAR/JAR/FATJAR/JSP/CLASS 文件
  • 搜索符合特定条件的函数、类,譬如检索调用了危险函数的静态函数

利用 tabby 生成后的代码属性图,在 Neo4j 图数据库中进行动态自定义漏洞挖掘/利用链挖掘。

#3 成果

#4 常见问题

#5 初衷&致谢

当初,在进行利用链分析的过程中,深刻认识到这一过程是能被自动化所代替的(不管是 Java 还是 PHP)。但是,国内很少有这方面工具的开源。GI 工具实际的检测效果其实并不好,为此,依据我对程序分析的理解,开发了 tabby 工具。我对 tabby 工具期望不单单只是在利用链挖掘的应用,也希望后续能从漏洞分析的角度利用 tabby 的代码属性图进行分析。我希望 tabby 能给国内的 Java 安全研究人员带来新的工作模式。

当然,当前版本的 tabby 仍然存在很多问题可以优化,希望有程序分析经验的师傅能一起加入 tabby 的建设当中,有啥问题可以直接联系我哦!

如果 tabby 给你的工作带来了便利,请不要吝啬你的🌟哦!

如果你使用 tabby 并挖到了漏洞,非常欢迎提供相关的成功案例 XD

如果你有能力一起建设,也可以一起交流,或直接 PR,或直接 issue