Skip to content
KitploitKITPLOIT
工具博客
提交
工具博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

··订阅源·联系·隐私·© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
gaia — 全局API完整性评估器 | Kitploit
工具/GitLabGitLab/functori/dev/gaia
漏洞扫描器API安全测试Web安全模糊测试
GitLabfunctori/dev/gaia

gaia

全局API完整性评估器

查看仓库
1年前尚未审核

最受欢迎

查看全部 →

发现我们社区最常用的工具。

探索所有工具

浏览我们的工具集合

查看所有工具 →
分享

Gaia:全局 API 完整性评估器

依赖项

  • 安装 opam 以构建测试 API。

  • 安装 git、python3、pip 和 .NET 以构建 RESTler 和 Schemathesis。

  • 安装 cargo 以构建 Gaia。

  • 安装 docker v26.0.1 和 docker compose v2.26.1 以使用 ELK Stack 构建 Gaia(如果不使用则为可选)。

  • 安装 node >= v18.0.0 和 npm >= v8.6.0

  • 要创建一个 opam 本地切换:

root@kitploit:~
make opam-switch
  • 要安装所有依赖项:
root@kitploit:~
make deps

构建

  • 要构建 Gaia:
root@kitploit:~
make build
  • 要构建测试 API:
root@kitploit:~
make build-test

OpenAPI 规范

  • 要为测试生成 OpenAPI 规范:
root@kitploit:~
make generate-swagger
  • 要删除测试的 OpenAPI 规范:
root@kitploit:~
make clean-swagger

格式化

  • 要格式化项目(测试 + 源代码):
root@kitploit:~
make format

清理

  • 要清理构建文件(测试 + 源代码):
root@kitploit:~
make clean-build-files
  • 要清理所有内容:
root@kitploit:~
make clean

执行

  • 构建后,可以通过以下命令显示 GAIA 选项:
root@kitploit:~
./_bin/gaia --help
  • GAIA 用法:
root@kitploit:~
gaia --configuration <configuration> --openapi-path <openapi-path> --workdir-path <workdir-path> --verbose <verbose>

  • workdir-path:工作目录,您可以在其中找到模糊测试工具的各种日志。

  • openapi-path:实际 API 的 OpenAPI 文件的路径。使用模糊测试或监控时为必需,统计时不需要

  • verbose:详细程度级别 {NOTHING, LOW, MID, HIGH, ALL}(默认值:NOTHING)

  • configuration:包含以下内容的 JSON 文件路径:

root@kitploit:~
{
  "configuration": {
    // One of : fuzzing or monitoring
    "fuzzing": {
      //Required
      "config_fuzzer": {
        //Required
        // In hours
        "timeout": 1,
        //Optional
        // Disable fuzzers
        "disable_fuzzers": [{
           "Restler":{
             // Bfs, BfsFast, BfsCheap or RandomWalk
             "strategy" : "Bfs" 
            }
          },
          "Schemathesis",
          {"Custom": {"id": "1"}}
        ],
        //Optional
        "custom_fuzzers": [
          "<command line that can accept `--output_dir <PATH>`, `--openapi_path <PATH>` and `--timeout <FLOAT>` as arguments>"
        ],
        //Optional
        "generation_config": {
          //optional (Required if you set a function to generate a value)
          "lib_path": "Absolute path to the dynamic library (.so, .dll, or .rs).",
          //Optional
          "generate_string": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns a string array>",
            //Or
            "value": ["fuzzstring"],
            //Or
            "function": "<function() that returns a string array>",
            //Or
            "file": "The file path to the dictionary of values"
          },
          //Optional
          "generate_datetime": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns a datetime array in a string format>",
            //Or
            "value": ["2019-06-26T20:20:39+00:00"],
            //Or
            "function": "<function() that returns a datetime array in a string format>",
            //Or
            "file": "The file path to the dictionary of values"
          },
          //Optional
          "generate_date": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns a date array in a string format>",
            //Or
            "value": ["2019-06-26"],
            //Or
            "function": "<function() that returns a date array in a string format>",
            //Or
            "file": "The file path to the dictionary of values"
          },
          //Optional
          "generate_int": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns an int array in a string format>",
            //Or
            "value": ["0"],
            //Or
            "function": "<function() that returns an int array in a string format>",
            //Or
            "file": "The file path to the dictionary of values"
          },
          //Optional
          "generate_number": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns a float array in a string format>",
            //Or
            "value": ["1.5"],
            //Or
            "function": "<function() that returns a float array in a string format>",
            //Or
            "file": "The file path to the dictionary of values"
          },
          //Optional
          "generate_object": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns a json object array in a string format>",
            //Or
            "value": ["{\"k\" : {\"v\" : \"value\" }}"],
            //Or
            "function": "<function() that returns a json object array in a string format>",
            //Or
            "file": "The file path to the dictionary of values"
          },
          //Optional
          "generate_path_parameter": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns a key-value map with a string key referring to a path parameter and a string array of values>",
            //Or
            "value": {
              "k": {
                "v": ["value"]
              }
            },
            //Or
            "function": "<function() that returns a key-value map with a string key referring to a path parameter and a string array of values>",
            //Or
            "file": "The file path to the dictionary of values"
          },
          //Optional
          "generate_query_parameter": {
            //One of : Command, Value, File path or Function
            "command": "<command line that returns a key-value map with a string key referring to a query parameter and a string array of values>",
            //Or
            "value": {
              "k": {
                "v": ["value"]
              }
            },
            //Or
            "function": "<function() that returns a key-value map with a string key referring to a query parameter and a string array of values>",
            //Or
            "file": "The file path to the dictionary of values"
          }
        }
      },
      //Required
      "config_process_manager": {
        //Optional
        "config_reset": {
          //Required
          "reset_lib": "Absolute path to the dynamic library (.so, .dll, or .rs).",
          //Required
          "function": "Function name that takes two strings as arguments and returns a unit. The first string represents the log in JSON format, and the second represents the path to the real-time log file."
        },
        //Required
        "config_proxy": {
          //Optional
          "headers_config": {
            //Optional
            "custom_headers": [
              {
                //Required
                "title": "title",
                //Required
                "header_type": {
                  //One of : Command or Value
                  "Command": {
                    //Required
                    "cmd": "<Command that returns the value of the header>",
                    //Required
                    //Refresh value in milliseconds
                    "duration": 0
                  },
                  // or
                  "Value": { "value": "Header value" }
                }
              }
            ]
          },
          //Optional
          "openapi_config": {
            //Optional
            "responses_to_string": true, // Change the type of the responses to string
            //Optional
            "requests_config": {
              //One of : Exclude or Only
              "only": {
                //Required
                "requests": [
                  {
                    //Required
                    "path": "Regex that represents a path",
                    //Required
                    "methods": [
                      "Get",
                      "Put",
                      "Post",
                      "Delete",
                      "Options",
                      "Head",
                      "Patch",
                      "Trace"
                    ]
                  }
                ]
              },
              //Or
              "Exclude": {
                //Required
                "requests": [
                  {
                    //Required
                    "path": "Regex that represents a path",
                    //Optional: Defaults to all methods if not specified.
                    "methods": [
                      "Get",
                      "Put",
                      "Post",
                      "Delete",
                      "Options",
                      "Head",
                      "Patch",
                      "Trace"
                    ]
                  }
                ]
              }
            }
          },
          //Optional
          "stream_response_services": [
            {
              //Required
              "path": "Regex that represents a path",
              //Optional: Defaults to all methods if not specified.
              "methods": [
                "Get",
                "Put",
                "Post",
                "Delete",
                "Options",
                "Head",
                "Patch",
                "Trace"
              ]
            }
          ]
        },
        //Optional
        "use_sync_requests" : true
      }
    },
    "monitoring": {
      "config_monitoring": {
        //One of : log_file_path or service
        "log_file_path": {
          //Required
          "path": "/home/log.log"
        },
        "service": {
          //Required
          "url": "http://localhost:3000/log"
        }
      }
    }
  },
  //Optional
  "config_checker": {
    //Optional
    "checkers_cmd": [
      "<command line that take a string as an argument and return unit. This string represents the log in JSON format>"
    ],
    //Optional
    "checkers_lib": [
      {
        //Required
        "checkers_lib": "Absolute path to the dynamic library (.so, .dll, or .rs).",
        //Required
        "function_names": [
          "Function names that take a string as an argument and return unit. This string represents the log in JSON format"
        ]
      }
    ]
  },
  //Optional
  "config_checker_elk_stack": {
    //Required
    "kibana_port": 5602 //Kibana url : http://localhost:{kibana_port}
  },
  //Optional
  "config_statistics": {
    //Required
    "process": {
      //One of : docker, process or service
      "docker": {
        //Required
        "container_id": "89u32eew2r"
      },
      "process": {
        //Required
        "pid": 1100293
      },
      "service": {
        //Required
        "url": "http://localhost:3000/statistics"
      }
    }
  },
  //Optional
  "scanner": true
}
  • 日志 JSON 格式示例:
root@kitploit:~
{
  "id" : 9009,
  "request": {
    "method": "GET",
    "url": "http://localhost:8080/api/data",
    "headers": [
      ["connection", "keep-alive"],
      ["accept", "*/*"],
      ["user-agent", "schemathesis/3.24.3"],
      ["host", "localhost:8081"],
      ["accept-encoding", "gzip, deflate"],
      ["authorization", "Bearer"],
      ["x-schemathesis-testcaseid", "97pK1I"],
      ["authorization", "Bearer Test"]
    ],
    "params": [],
    "body": "",
    "timestamp": "2024-06-17T12:43:21.717+00:00"
  },
  "response": {
    "status_code": 403,
    "headers": [
      ["access-control-allow-headers", "accept, content-type"],
      ["access-control-allow-origin", "*"],
      ["content-type", "application/json"],
      ["content-length", "70"]
    ],
    "body": "{\"error\":\"get_data\",\"exception\":\"sender Test should be connected\"}",
    "timestamp": "2024-06-17T12:43:21.717+00:00"
  },
  "reset": false
}
root@kitploit:~
{
  "request": {
    "method": "POST",
    "url": "http://localhost:20000/injection/block",
    "headers": [
      ["user-agent", "restler/9.2.3"],
      ["content-type", "application/json"],
      ["accept", "application/json"],
      ["x-restler-sequence-id", "20f34e2b-13e8-4861-a7aa-77df3dff5ad6"],
      ["host", "localhost:22333"],
      ["content-length", "225"]
    ],
    "params": [
      ["async", "fuzzstring"],
      ["force", "fuzzstring"],
      ["chain", "fuzzstring"]
    ],
    "body": {
      "data": "fuzzstring",
      "operations": [[{ "branch": { "fuzz": false }, "data": "fuzzstring" }]]
    },
    "timestamp": "2024-06-17T12:43:21.717+00:00"
  },
  "response": {
    "status_code": 400,
    "headers": [
      ["content-type", "text/plain"],
      ["transfer-encoding", "chunked"]
    ],
    "body": null,
    "timestamp": "2024-06-17T12:43:21.722+00:00"
  },
  "reset": false
}

许可证

版权所有 © 2024, Functori [email protected].

下载工具