Defender para CLI de Referência à Nuvem

O Defender para a Cloud CLI fornece comandos para analisar imagens de contentores em busca de vulnerabilidades de segurança e exportar resultados em formatos padrão. Este artigo descreve a sintaxe, parâmetros e exemplos de utilização para os comandos de imagem e SBOM scan.

Opções de CLI

Option Required Tipo Description
--defender-debug No Bool Envie os dados de depuração para o console.
--output-formats No String Opção: HTML
--defender-output No String Define o caminho para o ficheiro de saída [predefinido: pwd]
--defender-break No Bool Saia com um código diferente de zero se forem encontrados problemas críticos

Digitalização de Imagem

Use o defender scan image comando para analisar imagens de contentores em busca de vulnerabilidades usando o Gestão de vulnerabilidades do Microsoft Defender (MDVM).

Utilização

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

Opções

Name Required Tipo Description
<nome da imagem> Yes String A referência da imagem do contentor (por exemplo, my-image:latest, registry.azurecr.io/app:v1).

Examples

Digitalizar uma imagem local

defender scan image my-image:latest

Digitalizar e exportar os resultados do SARIF

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

SBOM Scan

Use o defender scan sbom comando para analisar imagens do sistema de ficheiros ou do contentor para gerar uma Lista de Materiais de Software (SBOM). Este comando também identifica pacotes maliciosos.

Utilização

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

Opções

Name Required Tipo Description
<Alvo> Yes String A referência da imagem do contentor ou sistema de ficheiros (por exemplo, my-image:latest, /home/src/).
--sbom-format No String Formato de saída SBOM. Predefinição: cyclonedx1.6-json
--output No String Caminho de saída para ficheiro SBOM gerado (por defeito: sbom-finding-<timestamp>.json)

Opções de formato válidas:

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

Examples

Criar SBOM de uma imagem de contentor

defender scan sbom my-image:latest

Criar SBOM a partir do sistema de ficheiros local

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

Varredura de Modelos de Inteligência Artificial

Use o defender scan model comando para analisar modelos de IA em busca de riscos de segurança, incluindo malware, operadores inseguros e segredos expostos. Este comando suporta modelos armazenados localmente ou em registos cloud como Hugging Face, e formatos comuns como Pickle (.pkl), ONNX (.onnx), TorchScript (.pt), TensorFlow e SafeTensors.

Utilização

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

Opções

Name Required Tipo Description
<Alvo> Yes String O caminho para um ficheiro ou diretório de modelo local, ou um URL de modelo da Hugging Face (por exemplo, ./models/my-model.pkl, https://huggingface.co/org/model).
--modelscanner-Saída No String Caminho de saída para os resultados da análise SARIF.

Formatos de modelo suportados

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

Examples

Escanear um modelo local

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

Digitalizar um modelo do Hugging Face

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

Digitalizar e exportar os resultados do SARIF

defender scan model ./models/my-model.onnx --modelscanner-Output results.sarif
  • Última atualização a