{"id":22504869,"url":"https://github.com/saoshao/DetSql","last_synced_at":"2025-08-03T11:32:15.645Z","repository":{"id":255886401,"uuid":"851695372","full_name":"saoshao/DetSql","owner":"saoshao","description":"Burp插件，快速探测可能存在SQL注入的请求并标记，提高测试效率","archived":false,"fork":false,"pushed_at":"2024-11-23T12:08:19.000Z","size":167,"stargazers_count":190,"open_issues_count":9,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-23T13:18:40.580Z","etag":null,"topics":["burp-extensions","burp-plugin","burpsuite-extender"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saoshao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-03T14:58:23.000Z","updated_at":"2024-11-23T12:06:43.000Z","dependencies_parsed_at":"2024-11-16T12:22:30.472Z","dependency_job_id":"9787f8a9-6bcd-416c-b983-38dc974b4c73","html_url":"https://github.com/saoshao/DetSql","commit_stats":null,"previous_names":["saoshao/detsql"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saoshao%2FDetSql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saoshao%2FDetSql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saoshao%2FDetSql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saoshao%2FDetSql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saoshao","download_url":"https://codeload.github.com/saoshao/DetSql/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228540831,"owners_count":17934030,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["burp-extensions","burp-plugin","burpsuite-extender"],"created_at":"2024-12-07T00:02:49.364Z","updated_at":"2025-08-03T11:32:15.626Z","avatar_url":"https://github.com/saoshao.png","language":"Java","funding_links":[],"categories":["Java","burpsuite插件"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ch1\u003eDetSql\u003c/h1\u003e\n\u003cdiv align=\"center\"\u003e\n\n[![Repo stars](https://img.shields.io/github/stars/saoshao/DetSql)](https://github.com/saoshao/DetSql/stargazers)\n[![Downloads total](https://img.shields.io/github/downloads/saoshao/DetSql/total?label=Downloads)](https://github.com/saoshao/DetSql/releases)\n[![Repo tags](https://img.shields.io/github/v/tag/saoshao/DetSql?label=Latest)](https://github.com/saoshao/DetSql/tags)\n[![Downloads latest total](https://img.shields.io/github/downloads/saoshao/DetSql/latest/total?label=Downloads@latest)](https://github.com/saoshao/DetSql/releases)\n\n\u003c/div\u003e\n\u003c/div\u003e\n\n# 介绍\n\n**DetSql**是基于 BurpSuite Java 插件 API 开发的 SQL 注入探测插件，主要作用为快速从 http 流量中筛选出可能存在 SQL 注入的请求，在尽可能减少拦截的情况下提高 SQL 注入测试效率。\n\u003cbr/\u003e\n\n## 注意\n\n**DetSql**采用 Montoya API 进行开发，BurpSuite 版本需满足（\u003e=2023.12.1）。\n\n# 判断方式\n\n\u003e 为方便叙述使用 value 表示请求的一个参数值，respbody 表示该请求的响应体，value-\u003erespbody，表示参数值为 value 时发送请求得到响应体 respbody，以下判断依赖 MySQL，sqlserver，oracle，postgresql 四种数据库某版本测试结果。\n\n\u003cbr/\u003e\n\n**_1.报错类型判断_**\n\u003cbr/\u003e\n\n- 请求中任一参数值+报错 poc 作为新参数值，即 value+poc，其中 poc 包括：',%DF',\",%DF\",\\`,其中%DF考虑到宽字节，同时增加了 URL 编码的单双引号，在遇到 json 数据时增加了 Unicode 编码的单双引号。\n- 生成新请求后发送，响应匹配报错规则，添加了近 100 条正则匹配规则，匹配成功任一规则，即认为存在报错类型注入，标记该参数为 errsql，同时在括号中添加对应的报错正则规则作为备注一起显示，否则认为不存在报错类型注入。\n  \u003cbr/\u003e\n\n**_2.数字类型判断_**\n\u003cbr/\u003e\n\n- 当 value 为数字时，且该 value 不为 json 的键值，将发起以下请求判断，否则该 value 将不再判断，\n  \u003cbr/\u003e\n- 原始请求表示为：value-\u003erespbody，\n  \u003cbr/\u003e\n- poc1 请求：value-0-0-0-\u003erespbody1，请求完成后使用 Levenshtein 方法判断 respbody 和 respbody1 相似度是否超过 90%，如果不满足认为不存在数字类型的注入，否则将发送下一个请求判断，\n  \u003cbr/\u003e\n- poc2 请求：value-abc-\u003erespbody2，请求完成后使用 Levenshtein 方法判断 respbody2 和 respbody 相似度是否低于 90%并且 respbody2 和 respbody1 相似度也低于 90%，如果都满足即认为存在数字类型注入，标记该参数为 numsql。\n  \u003cbr/\u003e\n\n**_3.order 类型注入_**\n\u003cbr/\u003e\n\n- 当 value 不为空时，发起以下请求判断，否则该 value 将不再判断，\n  \u003cbr/\u003e\n- 原始请求表示为：value-\u003erespbody，\n  \u003cbr/\u003e\n- poc1 请求：value,0-\u003erespbody1，\n  \u003cbr/\u003e\n- poc2 请求：value,xxxxxx-\u003erespbody2，\n  \u003cbr/\u003e\n- 首先使用 Jaccard 方法判断 respbody 和 respbody1 的相似度低于 90%，若满足继续发送 poc2 请求，判断 respbody 和 respbody2 的相似度低于 90%，若满足继续后续判断，若不满足则直接停止判断，\n  \u003cbr/\u003e\n- poc3 请求：value,1-\u003erespbody3，\n  \u003cbr/\u003e\n- poc4 请求：value,2-\u003erespbody4，\n  \u003cbr/\u003e\n- 先发送 poc3 请求，使用 Jaccard 方法判断 respbody 和 respbody3 的相似度高于 90%，若满足则认为存在 order 类型的注入，若不满足继续发送 poc4 请求判断 respbody 和 respbody4 的相似度是否高于 90%，若满足则认为存在 order 类型的注入，标记该参数为 ordersql，否则认为不存在 order 类型的注入。\n  \u003cbr/\u003e\n\n**_4.字符类型注入_**\n\u003cbr/\u003e\n\n- 如果为 json 格式的数据，该键值 value 需被双引号包裹才会发起后续请求判断，否则该 value 将不再判断，\n  \u003cbr/\u003e\n- 原始请求表示为：value-\u003erespbody，\n  \u003cbr/\u003e\n- poc1 请求：value'-\u003erespbody1，此处为一个单引号，\n  \u003cbr/\u003e\n- poc2 请求：value''-\u003erespbody2，此处为两个单引号，\n  \u003cbr/\u003e\n- 首先使用 Levenshtein 方法判断 respbody 和 respbody1 的相似度低于 90%，若满足继续发送 poc2 请求，判断 respbody1 和 respbody2 的相似度低于 90%，注意如果原始请求不存在数据 respbody 和 respbody2 的相似度往往较高，如果原始请求存在数据 respbody 和 respbody2 的相似度往往较低，所有此处判断 respbody1 和 respbody2 的相似度。若满足低于 90%继续后续判断，若不满足则直接停止判断，\n  \u003cbr/\u003e\n- poc3 请求：value'+'-\u003erespbody3，此处为两个单引号，\n  \u003cbr/\u003e\n- poc4 请求：value'||'-\u003erespbody4，此处为两个单引号，\n  \u003cbr/\u003e\n- 先发送 poc3 请求，使用 Levenshtein 方法判断 respbody 和 respbody3 的相似度高于 90%，若满足则认为存在字符类型的注入，若不满足继续发送 poc4 请求判断 respbody 和 respbody4 的相似度是否高于 90%，若满足则认为存在字符类型的注入，标记该参数为 stringsql，否则认为不存在字符类型的注入。\n\n**_5.布尔类型注入_**\n\u003cbr/\u003e\n\n- 如果为 json 格式的数据，该键值 value 需被双引号包裹才会发起后续请求判断，否则该 value 将不再判断，\n  \u003cbr/\u003e\n- 原始请求表示为：value-\u003erespbody，\n  \u003cbr/\u003e\n- poc1 请求：value'||EXP(710)||'-\u003erespbody1\n  \u003cbr/\u003e\n- poc2 请求：value'||EXP(290)||'-\u003erespbody2\n  \u003cbr/\u003e\n- poc3 请求：value'||1/0||'-\u003erespbody3\n  \u003cbr/\u003e\n- poc4 请求：value'||1/1||'-\u003erespbody4\n  \u003cbr/\u003e\n- 发送poc1请求，使用 Levenshtein 方法判断respbody和respbody1的相似度低于90%，若满足则继续发送poc2请求，使用 Levenshtein 方法判断respbody1和respbody2的相似度低于90%，若满足则直接发送poc4请求，使用 Levenshtein 方法判断respbody2和respbody4的相似度高于90%，若满足则判断存在布尔类型注入，标记为boolsql。若respbody1和respbody2的相似度高于90%，则发送poc3请求，再使用 Levenshtein 方法判断respbody和respbody3的相似度高于90%，若满足则直接发送poc4请求，使用 Levenshtein 方法判断respbody2和respbody4的相似度高于90%，若满足则判断存在布尔类型注入。\n\n**_6.附加判断_**\n\u003cbr/\u003e\n\n- 除了前述通过计算相似度作为判断规则外还添加了响应长度的变化阈值作为判断辅助,从而丰富判断依据，例如两个响应长度相同时可直接判断相似度为百分之百，两个响应长度差超过某个值此处设为100，就将辅助判断的相似度定位百分之九十，在判断时如果希望此时的相似度较大（小）时为好，则会选择用算法计算出的相似度和辅助判断的相似度两者中较大（小）者去比较；如果两个响应的长度差很小，这种情况会先将两个字符串前后缀相同部分删除，若删除后的字符串中出现明显为poc的内容，则也会删除，删除后如果两个字符串变为空则判断相似度为100%，一个为空一个不为空则相似度为0，不满足前述情况则再使用算法计算出的相似度去比较。\n\n# 使用方法\n\n插件装载: Extensions - Installed - Add - Select File - Next\n\n\u003cbr/\u003e\n\n## 主面板（dashboard）\n\n\u003cbr/\u003e\n\n![](https://files.mdnice.com/user/72769/4a808ce4-338a-4267-a46b-baca61e6f7bf.jpg)\n\n\u003cbr/\u003e\n\n\u003e 左上显示原始流量，一共 7 列，从左至右依次为序号，从 0 开始；请求来源，proxy 或 repeater，为减少请求，其他模块来源点的请求将忽略；域名，如[https://www.baidu.com](https://www.baidu.com)；请求方式，get或post；URL路径，该路径不包含参数；响应体长度；漏洞提示，如果漏洞提示栏显示空白表示没有漏洞，否则将显示漏洞类型，如errsql，stringsql，多个存在多个类型使用-拼接显示。右上显示为测试请求流量，一共7列，从左至右依次为参数名、poc、响应体长度、状态码、相似度，使用百分比表示、请求时间、漏洞提示，此处如果测试后不存在漏洞将不显示该请求，只显示测试后存在问题的请求。左下和右下分别显示请求与响应，点击上述的原始请求或测试请求将在此处显示对应的请求和响应。\n\n\u003cbr/\u003e\n在Logger模块中查看扫描流量，选择Extensions类型如下\n\n![](https://files.mdnice.com/user/72769/d52d77cb-34e9-4e6b-9144-c9d8a2628ee2.png)\n\n\u003cbr/\u003e\n\n**_例子_**\n\u003cbr/\u003e\n\n\u003e 报错类型页面\n\n![](https://files.mdnice.com/user/72769/c0357afa-13b9-43de-8b7b-72c5e2dec1ac.png)\n\n\u003e order类型页面\n\n![](https://files.mdnice.com/user/72769/7edd618c-85ca-4fc3-93aa-518b51dc191f.png)\n\n\u003e 数字类型页面\n\n![](https://files.mdnice.com/user/72769/4c74ec12-8b5c-4869-9052-7ec75c12ce89.png)\n\n\u003e 字符类型页面（包含多种类型）\n\n![](https://files.mdnice.com/user/72769/2f5ad4dd-243a-4cc7-ac47-acd302484855.png)\n\u003cbr/\u003e\n\n**_双引号问题_**\n\u003cbr/\u003e\n\n由于双引号闭合的情况出现极少，此处仍在报错类型中保留了双引号的原因，经本人测试出现过双引号报错的情况，因此仍在报错类型保留了双引号，如想自行设置报错payload可在配置面板自行设置。\n\n\n## 配置面板（config）\n\n![](https://files.mdnice.com/user/72769/4d65d891-2b81-4c00-8327-726d20d1f6ef.jpg)\n\u003cbr/\u003e\n\n\u003e 白名单为测试的请求域名，如 baidu.com，192.168.1.2，多个域名使用竖线分隔，不能填 C 段，不填表示测试全部；黑名单为禁止测试的域名；禁止后缀为一些静态文件的后缀，默认设置了常见的静态后缀；报错 poc 可自行设置报错类型的测试 poc，当设置了报错 poc 后内置的报错 poc 将不再使用，上述四个配置内容设置后需点击确认后生效。四个复选框，开关点击勾选后启动测试，测试 cookie 勾选后可测试 cookie 参数，只测报错勾选后不再测试除报错类型外其他类型的注入，设置接受 repeater 复选框主要是为了保持代码尽可能简洁，也不再右键中发送功能，接受 repeater 勾选后可监听测试来自 repeater 模块的请求，并且合并了请求去重功能的考虑，只对 proxy 来源请求的去重，请求去重算法为SM3，来自 repeater 模块的请求将不考虑该请求的重复性，是否测试过都将测试。这里可对来自proxy模块的请求进行手动停止，右键中设置了一个结束该请求测试的功能，如果请求已进入测试列表想要停止测试该请求，可右键点击end this data选项停止该请求，第一种情况为该请求正在等待其他线程的释放此时，点击end this data后run状态变为手动停止，第二种情况为该请求已在测试，点击end this data后也会停止测试同时run状态栏将不显示任何字符；同时对响应体body的长度做了长度限制，长度超过50000的请求不再测试，长度在10000到50000之间测试速度较慢，此处设置一个较低的线程但基本可满足手动测试的需求。最后添加了可将上述配置保存在文件的功能，可保存或从文件中载入配置。\n\n\u003cbr/\u003e\n\n\n\u003e 手动停止页面\n\n![](https://files.mdnice.com/user/72769/681076cb-157a-4b9b-a429-6ba1692e198f.png)\n\n![](https://files.mdnice.com/user/72769/7d7e68ae-69a9-4a98-8966-793593771004.png)\n\n\u003cbr/\u003e\n\n\u003e删除日志页面\n\n为方便分析，dashboard处添加了右键删除日志的功能，可删除选择的日志；或者删除不存在漏洞的所有日志，包括vulnstate值为空和手动停止的日志\n\n![f99e1a2b56245c44581f1f0d0a63610](https://github.com/user-attachments/assets/d6e61b73-a9ee-4bd3-b577-c3711a7f9db7)\n\n\u003cbr/\u003e\n\n## 辅助面板（codetool）\n\n![](https://files.mdnice.com/user/72769/35961586-7f38-425e-8d6c-538a4f398fe7.jpg)\n\n\u003cbr/\u003e\n\n\u003e 由于 burpsuite 自带的 base64 编码，URL 编码解码遇到中文会出现乱码，因此添加了基于 UTF-8 的可编解码中文的 base64，URL 编码，如果 base64 解码后为 json 字符串可点击 JSON 格式化按钮对其格式化，同时为便于查看中文还增加了 Unicode 解码。\n\n## 建议\n\n**DetSql**目的用于辅助手动测试，由于设置线程较小不利于大量请求时的被动扫描，建议使用时在白名单处设置测试域名或IP，如www.baidu.com，以此减少不必要的无效扫描，填baidu.com即代表baidu.com及其所有子域，多个可表示为baidu.com|qq.com，若出现卡顿建议按此配置，如下\n![](https://files.mdnice.com/user/72769/61e3e046-856a-4795-aa7f-7b10f014629e.png)\n正常很少会出现卡顿情况，同时建议使用最新版进行测试，经本人测试，未设置白名单将请求扫描数量快速加到170个左右未发现卡顿、闪退等异常，可正常运行，如下\n\n![](https://files.mdnice.com/user/72769/5add1ecb-e685-4992-b39c-5fed5a5917bd.png)\n最近发生的更新，新增的功能或变化可在Release中查看。\n\n\n\n\n\n# 问题沟通\n\n由于编写、测试时间仓促，难免存在问题，加之作者的水平有限。有任何问题、意见建议可随时提问，或者与我联系，email:1224165231@qq.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaoshao%2FDetSql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaoshao%2FDetSql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaoshao%2FDetSql/lists"}