Guida alla CLI di Defender per il Cloud

L'interfaccia della riga di comando di Defender per il cloud fornisce comandi per analizzare le immagini del contenitore per individuare le vulnerabilità di sicurezza ed esportare i risultati in formati standard. Questo articolo descrive la sintassi, i parametri e gli esempi di utilizzo per i comandi image e SBOM scan.

Opzioni CLI

Option Obbligatorio Type Descrizione
--defender-debug No Bool Visualizzare le informazioni di debug nella console.
--output-formats No Stringa Opzione: HTML
--defender-output No Stringa Imposta il percorso del file di output [impostazione predefinita: pwd]
--defender-break No Bool Uscire con un codice diverso da zero se vengono rilevati problemi critici

Analisi immagini

Usare il defender scan image comando per analizzare le immagini del contenitore per individuare le vulnerabilità usando Gestione delle vulnerabilità di Microsoft Defender (MDVM).

Utilizzo

defender scan image <image-name> [--defender-output <path>]

Opzioni

Name Obbligatorio Type Descrizione
<nome-immagine> Yes Stringa Riferimento all'immagine del contenitore , ad esempio my-image:latest, registry.azurecr.io/app:v1.

Esempio

Analizzare un'immagine locale

defender scan image my-image:latest

Analizzare ed esportare i risultati SARIF

defender scan image my-image:latest --defender-output results.sarif

Analisi SBOM

Usare il comando defender scan sbom per analizzare le immagini del file system o del contenitore per generare una distinta base software (SBOM). Questo comando identifica anche pacchetti dannosi.

Utilizzo

defender scan sbom <target> [--sbom-format <format>]

Opzioni

Name Obbligatorio Type Descrizione
<obiettivo> Yes Stringa Riferimento all'immagine del container o al filesystem (ad esempio, my-image:latest, /home/src/).
--sbom-format No Stringa Formato di output SBOM. Impostazione predefinita: cyclonedx1.6-json
--output No Stringa Percorso di output per il file SBOM generato (impostazione predefinita: sbom-finding-<timestamp>.json)

Opzioni di formato valide:

  • cyclonedx1.4-json, cyclonedx1.4-xml
  • cyclonedx1.5-json, cyclonedx1.5-xml
  • cyclonedx1.6-json, cyclonedx1.6-xml
  • spdx2.3-json

Esempio

Creare SBOM di un'immagine del contenitore

defender scan sbom my-image:latest

Creare SBOM dal file system locale

defender scan sbom /home/src --sbom-format cyclonedx1.6-xml

Analisi del modello di intelligenza artificiale

Usare il defender scan model comando per analizzare i modelli di intelligenza artificiale per individuare rischi per la sicurezza, tra cui malware, operatori non sicuri e segreti esposti. Questo comando supporta i modelli archiviati in locale o in registri cloud, ad esempio Hugging Face e formati comuni, tra cui Pickle (.pkl), ONNX (.onnx), TorchScript (.pt), TensorFlow e SafeTensors.

Utilizzo

defender scan model <target> [--modelscanner-Output <path>]

Opzioni

Name Obbligatorio Type Descrizione
<obiettivo> Yes Stringa Percorso di un file o di una directory del modello locale o di un URL del modello Hugging Face (ad esempio, ./models/my-model.pkl, https://huggingface.co/org/model).
--modelscanner-Output No Stringa Percorso di output per i risultati dell'analisi SARIF.

Formati di modello supportati

  • Selezione (.pkl)
  • ONNX (.onnx)
  • TorchScript (.pt)
  • TensorFlow (.tf, .pb)
  • SafeTensors (.safetensors)

Esempio

Analizzare un modello locale

defender scan model ./models/my-model.pkl

Analizzare un modello Hugging Face

defender scan model "https://huggingface.co/org/model-name"

Analizzare ed esportare i risultati SARIF

defender scan model ./models/my-model.onnx --modelscanner-Output results.sarif
  • Last updated on