DongTai-agent-java 项目使用教程

DongTai-agent-java 项目使用教程

DongTai-agent-javaJava Agent is a Java application probe of DongTai IAST, which collects method invocation data during runtime of Java application by dynamic hooks.项目地址:https://gitcode.com/gh_mirrors/do/DongTai-agent-java

1. 项目的目录结构及介绍

DongTai-agent-java 项目的目录结构如下：

DongTai-agent-java/
├── README_CN.md
├── SECURITY.md
├── intellij-java-google-style.xml
├── maven-publish.yml
├── pom.xml
├── release/
│   ├── dongtai-agent.jar
│   └── lib/
│       ├── dongtai-servlet.jar
│       ├── dongtai-core.jar
│       └── dongtai-spy.jar
└── src/
    └── ...

主要文件及目录介绍：

• README_CN.md: 项目的中文介绍文档。
• SECURITY.md: 项目的安全相关说明。
• intellij-java-google-style.xml: IntelliJ IDEA 的代码风格配置文件。
• maven-publish.yml: Maven 发布配置文件。
• pom.xml: Maven 项目对象模型文件。
• release/: 包含编译后的 jar 文件。
  • dongtai-agent.jar: 用于管理 agent 生命周期的 jar 文件。
  • lib/: 包含项目依赖的 jar 文件。
    • dongtai-servlet.jar: 用于处理 servlet 请求和响应的 jar 文件。
    • dongtai-core.jar: 核心功能模块，用于收集和上传数据。
    • dongtai-spy.jar: 用于动态钩子的 jar 文件。

2. 项目的启动文件介绍

项目的启动文件主要是 dongtai-agent.jar，它用于管理 agent 的生命周期。启动时，可以通过以下命令行参数来配置：

java -javaagent:/path/to/dongtai-agent.jar -Ddongtai.debug=true -jar app.jar

启动参数说明：

• -javaagent:/path/to/dongtai-agent.jar: 指定 agent 的路径。
• -Ddongtai.debug=true: 开启调试模式。
• -jar app.jar: 指定要启动的应用程序 jar 文件。

3. 项目的配置文件介绍

项目的配置文件主要是 pom.xml，它包含了项目的依赖、构建配置等信息。以下是 pom.xml 的部分内容：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.hxsecurity</groupId>
    <artifactId>DongTai-agent-java</artifactId>
    <version>1.15.0</version>
    <packaging>jar</packaging>
    <dependencies>
        <!-- 项目依赖 -->
    </dependencies>
    <build>
        <plugins>
            <!-- 构建插件 -->
        </plugins>
    </build>
</project>

主要配置项：

• modelVersion: Maven 模型版本。
• groupId: 项目组 ID。
• artifactId: 项目 ID。
• version: 项目版本。
• packaging: 打包方式。
• dependencies: 项目依赖。
• build: 构建配置。

以上是 DongTai-agent-java 项目的基本使用教程，包括项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。

DongTai-agent-javaJava Agent is a Java application probe of DongTai IAST, which collects method invocation data during runtime of Java application by dynamic hooks.项目地址:https://gitcode.com/gh_mirrors/do/DongTai-agent-java