Questa Nuclei Action semplifica l'orchestrazione di Nuclei con GitHub Action. Integra tutti i tuoi Nuclei Templates in potenti flussi di lavoro di sicurezza continui e rendila parte del tuo ciclo di vita di sviluppo software sicuro.

Nuclei Action

Compatibilità

v3.0.0+ esegue su Node.js v24 e adotta un'interfaccia CLI-first, accettando inputs come version, install-only, args, ecc., e outputs solo su stdout e stderr.
v2.0.0+ e v2.x si basano su input specifici dell'action come target, urls, templates, workflows, flags e vari interruttori di esportazione/reporting; v2.x sono deprecate e non supportate dopo il 1 marzo 2026. Consulta MIGRATION.md prima di eseguire l'aggiornamento.
v1+ esegue su Node.js v16 e utilizza input come target, urls, templates, workflows, output, json, include-rr, config, report-config, github-report, github-token, sarif-export, markdown-export e flags.

Inputs

[!IMPORTANT]

config e config-path non devono essere impostati insieme.

args hanno sempre la precedenza su config o config-path.

[!NOTE] Quando il debug logging è abilitato, questa action aggiunge automaticamente i flag -debug e -verbose a Nuclei.

Outputs

name	description
`stdout`	L'output standard dell'esecuzione di Nuclei
`stderr`	L'errore standard dell'esecuzione di Nuclei

Esecuzione

Questa action è un'action node24.

Utilizzo

- uses: projectdiscovery/nuclei-action@v3
  with:
    version:
    # Setup with specific version ("latest" or in format "vX.Y.Z").
    #
    # Required: true
    # Default: latest

    install-only:
    # Install Nuclei without running scans.
    #
    # Required: false
    # Default: false

    args:
    # Arguments to pass to Nuclei.
    #
    # Required: false
    # Default: ""

    config:
    # Nuclei configuration file content.
    #
    # Required: false
    # Default: ""

    config-path:
    # Path to Nuclei configuration file.
    #
    # Required: false
    # Default: ""

    cache:
    # Enable caching of Nuclei caches, configs, templates, and browser.
    #
    # Required: false
    # Default: true

    token:
    # GitHub Token. It is used to fetch Nuclei releases from GitHub.
    #
    # Required: true
    # Default: ${{ github.token }}

Esempio

Configurazione predefinita (ultima versione di Nuclei)

- uses: projectdiscovery/nuclei-action@v3
  with:
    args: -u http://scanme.sh

Configurazione con una versione specifica

- uses: projectdiscovery/nuclei-action@v3
  with:
    version: v3.6.0
    args: -u http://scanme.sh

Configurazione o installazione di Nuclei senza eseguire scansioni

- uses: projectdiscovery/nuclei-action@v3
  with:
    version: v3.6.0
    install-only: true

- run: nuclei -version

oppure solo installazione e senza cache:

- uses: projectdiscovery/nuclei-action@v3
  with:
    version: v3.6.0
    install-only: true
    cache: false

- run: nuclei -version

Configurazione con file di configurazione di Nuclei

- uses: projectdiscovery/nuclei-action@v3
  with:
    version: latest
    config: |
      target:
        - http://scanme.sh
      sarif-export: results.sarif

oppure passala tramite variables:

- uses: projectdiscovery/nuclei-action@v3
  with:
    version: latest
    config: ${{ vars.NUCLEI_CONFIG }}

oppure tramite un file di configurazione gestito dal repository:

- uses: projectdiscovery/nuclei-action@v3
  with:
    version: latest
    config-path: path/to/nuclei.yaml

Configurazione con GitHub code scanning

- uses: projectdiscovery/nuclei-action@v3
  with:
    version: latest
    config: |
      target:
        - http://scanme.sh
      sarif-export: results.sarif

- uses: github/codeql-action/upload-sarif@v3
  if: success()
  with:
    sarif_file: results.sarif
    category: nuclei-results

Configurazione con reporting

- uses: projectdiscovery/nuclei-action@v3
  with:
    args: -u http://scanme.sh
    config: |
      report-config: issue-tracker-config.yaml
  env:
    GITHUB_BASE_URL: https://localhost:8443/github
    GITHUB_USERNAME: test-username
    GITHUB_OWNER: test-owner
    GITHUB_TOKEN: ${{ secrets.GITHUB_PAT }}
    GITHUB_PROJECT_NAME: test-project

Esempio issue-tracker-config.yaml (file del repository):

github:
 # base-url is the optional self-hosted GitHub application url
 base-url: $GITHUB_BASE_URL # read from environment variable
 # username is the username of the GitHub user
 username: $GITHUB_USERNAME # read from environment variable
 # owner is the owner name of the repository for issues
 owner: $GITHUB_OWNER # read from environment variable
 # token is the token for GitHub account
 token: $GITHUB_TOKEN # read from environment variable
 # project-name is the name of the repository
 project-name: $GITHUB_PROJECT_NAME # read from environment variable

 # issue-label is the label of the created issue type
 issue-label: bug
 # allow-list sets a tracker level filter to only create issues for templates with
 # these severity labels or tags (does not affect exporters. set those globally)
 allow-list:
   severity: high, critical
   tags: network
 # deny-list sets a tracker level filter to never create issues for templates with
 # these severity labels or tags (does not affect exporters. set those globally)
 deny-list:
   severity: low
 # duplicate-issue-check flag to enable duplicate tracking issue check.
 duplicate-issue-check: false

Fai riferimento a https://github.com/projectdiscovery/nuclei/blob/dev/cmd/nuclei/issue-tracker-config.yaml.

Contributi

Accogliamo con piacere i contributi! Consulta la nostra Guida ai contributi per i dettagli su come iniziare.

Licenza

MIT. Consulta LICENSE per maggiori dettagli.

`version`	Esegue l'installazione con una versione specifica ("latest" o nel formato "vX.Y.Z").	`true`	`latest`
`install-only`	Installa Nuclei senza eseguire scansioni.	`false`	`false`
`args`	Argomenti da passare a Nuclei.	`false`	`""`
`config`	Contenuto del file di configurazione di Nuclei.	`false`	`""`
`config-path`	Percorso del file di configurazione di Nuclei.	`false`	`""`
`cache`	Abilita il caching di cache, configurazioni, template e browser di Nuclei.	`false`	`true`
`token`	Token GitHub. Viene utilizzato per recuperare le release di Nuclei da GitHub.	`true`	`${{ github.token }}`

nuclei-action

Più Popolari