Sub Assessments - Get

Riferimento

Servizio:: Defender for Cloud

Versione API:: 2019-01-01-preview

Ottenere una valutazione secondaria della sicurezza sulla risorsa analizzata

GET https://management.azure.com/{scope}/providers/Microsoft.Security/assessments/{assessmentName}/subAssessments/{subAssessmentName}?api-version=2019-01-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
assessmentName	path	True	string	Chiave di valutazione - Chiave univoca per il tipo di valutazione
scope	path	True	string	L'ambito della query può essere una sottoscrizione (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) o un gruppo di gestione (/providers/Microsoft.Management/managementGroups/mgName).
subAssessmentName	path	True	string	Chiave Sub-Assessment - Chiave univoca per il tipo di valutazione secondaria
api-version	query	True	string	Versione dell'API per l'operazione

Risposte

Nome	Tipo	Descrizione
200 OK	SecuritySubAssessment	OK
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get security recommendation task from security data location

Esempio di richiesta

GET https://management.azure.com/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2/providers/Microsoft.Security/assessments/1195afff-c881-495e-9bc5-1486211ae03f/subAssessments/95f7da9c-a2a4-1322-0758-fcd24ef09b85?api-version=2019-01-01-preview


/**
 * Samples for SubAssessments Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/SubAssessments/
     * GetSubAssessment_example.json
     */
    /**
     * Sample code: Get security recommendation task from security data location.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void getSecurityRecommendationTaskFromSecurityDataLocation(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.subAssessments().getWithResponse(
            "subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2",
            "1195afff-c881-495e-9bc5-1486211ae03f", "95f7da9c-a2a4-1322-0758-fcd24ef09b85",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armsecurity_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/security/armsecurity"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/9ac34f238dd6b9071f486b57e9f9f1a0c43ec6f6/specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/SubAssessments/GetSubAssessment_example.json
func ExampleSubAssessmentsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsecurity.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewSubAssessmentsClient().Get(ctx, "subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2", "1195afff-c881-495e-9bc5-1486211ae03f", "95f7da9c-a2a4-1322-0758-fcd24ef09b85", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.SubAssessment = armsecurity.SubAssessment{
	// 	Name: to.Ptr("95f7da9c-a2a4-1322-0758-fcd24ef09b85"),
	// 	Type: to.Ptr("Microsoft.Security/assessments/subAssessments"),
	// 	ID: to.Ptr("/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2/providers/Microsoft.Security/assessments/1195afff-c881-495e-9bc5-1486211ae03f/subassessments/95f7da9c-a2a4-1322-0758-fcd24ef09b85"),
	// 	Properties: &armsecurity.SubAssessmentProperties{
	// 		Description: to.Ptr("PuTTY ssh_agent_channel_data Function Integer Overflow Vulnerability"),
	// 		AdditionalData: &armsecurity.AdditionalData{
	// 			AssessedResourceType: to.Ptr(armsecurity.AssessedResourceTypeServerVulnerability),
	// 		},
	// 		Category: to.Ptr("Local"),
	// 		DisplayName: to.Ptr("PuTTY ssh_agent_channel_data Function Integer Overflow Vulnerability"),
	// 		ID: to.Ptr("370361"),
	// 		Impact: to.Ptr("Successful exploitation could allow remote attackers to have unspecified impact via a large length value in an agent protocol message."),
	// 		Remediation: to.Ptr("Customers are advised to upgrade toPuTTY 0.68 or later version in order to remediate this vulnerability."),
	// 		ResourceDetails: &armsecurity.AzureResourceDetails{
	// 			Source: to.Ptr(armsecurity.SourceAzure),
	// 			ID: to.Ptr("/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2"),
	// 		},
	// 		Status: &armsecurity.SubAssessmentStatus{
	// 			Code: to.Ptr(armsecurity.SubAssessmentStatusCodeUnhealthy),
	// 			Severity: to.Ptr(armsecurity.SeverityMedium),
	// 		},
	// 		TimeGenerated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-02-02T12:36:50.779Z"); return t}()),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { SecurityCenter } = require("@azure/arm-security");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Get a security sub-assessment on your scanned resource
 *
 * @summary Get a security sub-assessment on your scanned resource
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/SubAssessments/GetSubAssessment_example.json
 */
async function getSecurityRecommendationTaskFromSecurityDataLocation() {
  const scope =
    "subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2";
  const assessmentName = "1195afff-c881-495e-9bc5-1486211ae03f";
  const subAssessmentName = "95f7da9c-a2a4-1322-0758-fcd24ef09b85";
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const result = await client.subAssessments.get(scope, assessmentName, subAssessmentName);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.SecurityCenter;

// Generated from example definition: specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/SubAssessments/GetSubAssessment_example.json
// this example is just showing the usage of "SubAssessments_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SecuritySubAssessmentResource created on azure
// for more information of creating SecuritySubAssessmentResource, please refer to the document of SecuritySubAssessmentResource
string scope = "subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2";
string assessmentName = "1195afff-c881-495e-9bc5-1486211ae03f";
string subAssessmentName = "95f7da9c-a2a4-1322-0758-fcd24ef09b85";
ResourceIdentifier securitySubAssessmentResourceId = SecuritySubAssessmentResource.CreateResourceIdentifier(scope, assessmentName, subAssessmentName);
SecuritySubAssessmentResource securitySubAssessment = client.GetSecuritySubAssessmentResource(securitySubAssessmentResourceId);

// invoke the operation
SecuritySubAssessmentResource result = await securitySubAssessment.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SecuritySubAssessmentData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

{
  "type": "Microsoft.Security/assessments/subAssessments",
  "id": "/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2/providers/Microsoft.Security/assessments/1195afff-c881-495e-9bc5-1486211ae03f/subassessments/95f7da9c-a2a4-1322-0758-fcd24ef09b85",
  "name": "95f7da9c-a2a4-1322-0758-fcd24ef09b85",
  "properties": {
    "id": "370361",
    "displayName": "PuTTY ssh_agent_channel_data Function Integer Overflow Vulnerability",
    "status": {
      "code": "Unhealthy",
      "severity": "Medium"
    },
    "remediation": "Customers are advised to upgrade toPuTTY 0.68 or later version in order to remediate this vulnerability.",
    "impact": "Successful exploitation could allow remote attackers to have unspecified impact via a large length value in an agent protocol message.",
    "category": "Local",
    "description": "PuTTY ssh_agent_channel_data Function Integer Overflow Vulnerability",
    "timeGenerated": "2021-02-02T12:36:50.779Z",
    "resourceDetails": {
      "source": "Azure",
      "id": "/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/DEMORG/providers/Microsoft.Compute/virtualMachines/vm2"
    },
    "additionalData": {
      "assessedResourceType": "ServerVulnerability",
      "type": "VirtualMachine",
      "cvss": {
        "2.0": {
          "base": 7.5
        },
        "3.0": {
          "base": 9.8
        }
      },
      "patchable": true,
      "cve": [
        {
          "title": "CVE-2017-6542",
          "link": "http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6542"
        }
      ],
      "publishedTime": "2017-04-06T10:58:25",
      "threat": "PuTTY is a client program for the SSH, Telnet and Rlogin network protocols",
      "vendorReferences": [
        {
          "title": "CVE-2017-6542",
          "link": "http://www.chiark.greenend.org.uk/~sgtatham/putty/wishlist/vuln-agent-fwd-overflow.html"
        }
      ]
    }
  }
}

Definizioni

Nome	Descrizione
AzureResourceDetails	Dettagli della risorsa di Azure valutata
CloudError	Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.
CloudErrorBody	Dettagli dell'errore.
ContainerRegistryVulnerabilityProperties	Campi di contesto aggiuntivi per la valutazione della vulnerabilità del registro contenitori
CVE	Dettagli CVE
CVSS	Dettagli CVSS
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
OnPremiseResourceDetails	Dettagli della risorsa locale valutata
OnPremiseSqlResourceDetails	Dettagli della risorsa SQL locale valutata
SecuritySubAssessment	Valutazione secondaria della sicurezza in una risorsa
ServerVulnerabilityProperties	Campi di contesto aggiuntivi per la valutazione della vulnerabilità del server
severity	Livello di gravità della valutazione secondaria
SqlServerVulnerabilityProperties	Dettagli della risorsa valutata
SubAssessmentStatus	Stato della valutazione secondaria
SubAssessmentStatusCode	Codice programmatico per lo stato della valutazione
VendorReference	Informazioni di riferimento sul fornitore

AzureResourceDetails

Dettagli della risorsa di Azure valutata

Nome	Tipo	Descrizione
id	string	ID risorsa di Azure della risorsa valutata
source	string: Azure	Piattaforma in cui risiede la risorsa valutata

CloudError

Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.

Nome	Tipo	Descrizione
error.additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
error.code	string	Codice di errore.
error.details	CloudErrorBody[]	Dettagli dell'errore.
error.message	string	Messaggio di errore.
error.target	string	Destinazione dell'errore.

CloudErrorBody

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	CloudErrorBody[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ContainerRegistryVulnerabilityProperties

Campi di contesto aggiuntivi per la valutazione della vulnerabilità del registro contenitori

Nome	Tipo	Descrizione
assessedResourceType	string: ContainerRegistryVulnerability	Tipo di risorsa di valutazione secondaria
cve	CVE[]	Elenco di CVE
cvss	<string, CVSS>	Dizionario dalla versione cvss all'oggetto dettagli cvss
imageDigest	string	Digest dell'immagine vulnerabile
patchable	boolean	Indica se una patch è disponibile o meno
publishedTime	string	Ora di pubblicazione
repositoryName	string	Nome del repository a cui appartiene l'immagine vulnerabile
type	string	Tipo di vulnerabilità. Ad esempio: vulnerabilità, potenziale vulnerabilità, informazioni raccolte, vulnerabilità
vendorReferences	VendorReference[]	Informazioni di riferimento sul fornitore

CVE

Dettagli CVE

Nome	Tipo	Descrizione
link	string	URL collegamento
title	string	Titolo CVE

CVSS

Dettagli CVSS

Nome	Tipo	Descrizione
base	number	Base CVSS

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

OnPremiseResourceDetails

Dettagli della risorsa locale valutata

Nome	Tipo	Descrizione
machineName	string	Nome del computer
source	string: OnPremise	Piattaforma in cui risiede la risorsa valutata
sourceComputerId	string	ID agente oms installato nel computer
vmuuid	string	ID univoco del computer
workspaceId	string	ID risorsa di Azure dell'area di lavoro a cui è collegato il computer

OnPremiseSqlResourceDetails

Dettagli della risorsa SQL locale valutata

Nome	Tipo	Descrizione
databaseName	string	Nome del database Sql installato nel computer
machineName	string	Nome del computer
serverName	string	Nome sql server installato nel computer
source	string: OnPremiseSql	Piattaforma in cui risiede la risorsa valutata
sourceComputerId	string	ID agente oms installato nel computer
vmuuid	string	ID univoco del computer
workspaceId	string	ID risorsa di Azure dell'area di lavoro a cui è collegato il computer

SecuritySubAssessment

Valutazione secondaria della sicurezza in una risorsa

Nome	Tipo	Descrizione
id	string	ID risorsa
name	string	Nome risorsa
properties.additionalData	AdditionalData: ContainerRegistryVulnerabilityProperties ServerVulnerabilityProperties SqlServerVulnerabilityProperties	Dettagli della valutazione secondaria
properties.category	string	Categoria della valutazione secondaria
properties.description	string	Descrizione leggibile dello stato di valutazione
properties.displayName	string	Nome visualizzato descrittivo della valutazione secondaria
properties.id	string	ID vulnerabilità
properties.impact	string	Descrizione dell'impatto di questa valutazione secondaria
properties.remediation	string	Informazioni su come correggere questa valutazione secondaria
properties.resourceDetails	ResourceDetails: AzureResourceDetails OnPremiseResourceDetails OnPremiseSqlResourceDetails	Dettagli della risorsa valutata
properties.status	SubAssessmentStatus	Stato della valutazione secondaria
properties.timeGenerated	string	Data e ora in cui è stata generata la sottovalutazione
type	string	Tipo di risorsa

ServerVulnerabilityProperties

Campi di contesto aggiuntivi per la valutazione della vulnerabilità del server

Nome	Tipo	Descrizione
assessedResourceType	string: ServerVulnerabilityAssessment	Tipo di risorsa di valutazione secondaria
cve	CVE[]	Elenco di CVE
cvss	<string, CVSS>	Dizionario dalla versione cvss all'oggetto dettagli cvss
patchable	boolean	Indica se una patch è disponibile o meno
publishedTime	string	Ora di pubblicazione
threat	string	Nome minaccia
type	string	Tipo di vulnerabilità. Ad esempio: vulnerabilità, potenziale vulnerabilità, informazioni raccolte
vendorReferences	VendorReference[]	Informazioni di riferimento sul fornitore

severity

Livello di gravità della valutazione secondaria

Nome	Tipo	Descrizione
High	string
Low	string
Medium	string

SqlServerVulnerabilityProperties

Dettagli della risorsa valutata

Nome	Tipo	Descrizione
assessedResourceType	string: SqlServerVulnerability	Tipo di risorsa di valutazione secondaria
query	string	Query T-SQL eseguita nel database SQL per eseguire il controllo specifico
type	string	Il tipo di risorsa a cui fa riferimento la valutazione secondaria si riferisce nei dettagli della risorsa

SubAssessmentStatus

Stato della valutazione secondaria

Nome	Tipo	Descrizione
cause	string	Codice programmatico per la causa dello stato di valutazione
code	SubAssessmentStatusCode	Codice programmatico per lo stato della valutazione
description	string	Descrizione leggibile dello stato di valutazione
severity	severity	Livello di gravità della valutazione secondaria

SubAssessmentStatusCode

Codice programmatico per lo stato della valutazione

Nome	Tipo	Descrizione
Healthy	string	La risorsa è integra
NotApplicable	string	La valutazione per questa risorsa non è stata eseguita
Unhealthy	string	La risorsa presenta un problema di sicurezza che deve essere risolto

VendorReference

Informazioni di riferimento sul fornitore

Nome	Tipo	Descrizione
link	string	URL collegamento
title	string	Titolo collegamento

Condividi tramite

Sub Assessments - Get

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Get security recommendation task from security data location

Esempio di richiesta

Risposta di esempio

Definizioni

AzureResourceDetails

CloudError

CloudErrorBody

ContainerRegistryVulnerabilityProperties

CVE

CVSS

ErrorAdditionalInfo

OnPremiseResourceDetails

OnPremiseSqlResourceDetails

SecuritySubAssessment

ServerVulnerabilityProperties

severity

SqlServerVulnerabilityProperties

SubAssessmentStatus

SubAssessmentStatusCode

VendorReference

Risorse aggiuntive