欢迎使用 ds-cve-plugin

一个用于 DataSurgeon 的插件，可从文本中提取 CVE 编号（例如：CVE-2021-56789）

快速入门：管理插件

添加新插件
移除插件
列出所有插件

快速入门：创建插件

找到你的插件文件
创建你自己的插件
如何使用你的新插件

创建插件

找到你的插件文件

如果你是 Windows 用户，你会在 C:\ds\ 目录下找到插件文件。如果你使用 Linux，请在以下位置查找：~/.DataSurgeon/plugins.json。如果插件文件在上述目录中都没有找到，我们会自动检查当前工作目录。

创建你自己的插件

JSON 对象中的每个字段都很重要。为了确保你的插件能够与 DataSurgeon 的 --add 和 --remove 选项无缝配合，请记得将你的 plugins.json 文件上传到 GitHub 仓库。请确保文件名保持为 plugins.json，并且只包含你想要上传的插件选项。以下是字段的快速指南：

这里有一个示例：

[
    {
        "content_type": "windows_registry",
        "arg_long_name": "winregistry",
        "version": "1.0.0",
        "help_message": "Extracts windows registry paths",
        "regex": "^(HKEY_(?:LOCAL_MACHINE|CURRENT_USER|CLASSES_ROOT|CURRENT_CONFIG|USERS)\\\\[\\w\\-\\.\\\\]*)",
        "source_url": "https://github.com/DataSurgeon-ds/ds-cve-plugin/"
    }
]

如何使用你的新插件

一旦你的插件文件被加载，该选项将作为额外的参数添加。正如你所看到的，参数名称就是 arg_long_name。

drew@DESKTOP-A5AO3TO$ ds -h

Options:
   ......
  -a, --aws                    Extract AWS keys
      --cve                    Extracts CVE Identifiers
  -V, --version                Print version

以下是运行它的方法：

┌──(drew㉿IT-DREW)-[~]
└─$ ds --cve -f cves.txt
cve: The first one is CVE-2023-1234. This is a hypothetical vulnerability that was supposedly discovered in 2023.
cve: Here's another one: CVE-2021-56789. This one was supposedly discovered in 2021.
cve: And here's a third one: CVE-2020-1234567. This one was supposedly discovered in 2020.
cve: But not all strings that look like CVE identifiers are actual CVE identifiers. For example, CVE-23-1234 is not a valid identifier because the year part only has two digits. Similarly, CVE-2023-123 is not valid because the identifier part only has three digits. And CVE-2023-12345678 is not valid because the identifier part has eight digits, which is too many.
cve: Finally, note that not all CVE identifiers are associated with actual vulnerabilities. For example, CVE-2023-9999 might not be associated with any known vulnerability. To check if a CVE identifier is real, you would need to look it up in a CVE database.

┌──(drew㉿IT-DREW)-[~]
└─$ ds --cve -f cves.txt --clean
cve: CVE-2023-1234
cve: CVE-2021-56789
cve: CVE-2020-1234567
cve: CVE-2023-1234567
cve: CVE-2023-9999

管理插件

添加新插件

要添加一个新插件，你需要使用 --add <URL> 选项。URL 需要是一个托管了 plugins.json 文件的远程 GitHub 仓库。如何使用你的新插件。

drew@DESKTOP-A5AO3TO:~$ ds --add https://github.com/DataSurgeon-ds/ds-cve-plugin/
[*] Download and added plugin: https://github.com/DataSurgeon-ds/ds-cve-plugin/

列出所有插件

要列出所有插件，你可以使用 --list 选项。

drew@DESKTOP-A5AO3TO$ ds --list

Plugin File: /home/drew/.DataSurgeon/plugins.json

Source URL                                                     | Argument Long Name
https://raw.githubusercontent.com/DataSurgeon-ds/ds-cve-plugin | cve

移除插件

要移除一个你不再需要的插件，你可以使用 --remove 选项。

drew@DESKTOP-A5AO3TO:~$ ds --remove https://github.com/DataSurgeon-ds/ds-cve-plugin//
[*] Removed plugin: https://github.com/DataSurgeon-ds/ds-cve-plugin//

content_type	这是你所搜索内容的一个单词描述（无空格）。这个单词会与匹配到的内容一起打印出来。
arg_long_name	这是命令行界面的唯一参数名称。在所有插件中必须是唯一的。
help_message	这是对你插件功能的简短描述。它会出现在工具的帮助信息中。
version	这是你插件的版本号（例如：1.0.0）
regex	这是用于匹配内容的正则表达式。为了与 `--clean` 选项兼容，你的正则表达式应设计为整个匹配 `($0)` 包含你感兴趣的确切内容。这样 `--clean` 选项就能只提取相关的匹配内容。要测试你的正则表达式模式，我们推荐使用 https://regexr.com/
source_url	托管你插件的 GitHub 仓库的 URL

ds-cve-plugin

最受欢迎