Assessments - List

Referens

Tjänst:: Defender for Cloud

API-version:: 2021-06-01

Hämta säkerhetsutvärderingar för alla dina genomsökda resurser i ett omfång

GET https://management.azure.com/{scope}/providers/Microsoft.Security/assessments?api-version=2021-06-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
scope	path	True	string	Frågans omfattning kan vara prenumeration (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) eller hanteringsgrupp (/providers/Microsoft.Management/managementGroups/mgName).
api-version	query	True	string	API-version för åtgärden

Svar

Name	Typ	Description
200 OK	SecurityAssessmentList	OKEJ
Other Status Codes	CloudError	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

List security assessments

Exempelbegäran

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/assessments?api-version=2021-06-01


/**
 * Samples for Assessments List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/Assessments/
     * ListAssessments_example.json
     */
    /**
     * Sample code: List security assessments.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listSecurityAssessments(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.assessments().list("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23",
            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/stable/2021-06-01/examples/Assessments/ListAssessments_example.json
func ExampleAssessmentsClient_NewListPager() {
	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)
	}
	pager := clientFactory.NewAssessmentsClient().NewListPager("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.AssessmentList = armsecurity.AssessmentList{
		// 	Value: []*armsecurity.AssessmentResponse{
		// 		{
		// 			Name: to.Ptr("21300918-b2e3-0346-785f-c77ff57d243b"),
		// 			Type: to.Ptr("Microsoft.Security/assessments"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b"),
		// 			Properties: &armsecurity.AssessmentPropertiesResponse{
		// 				DisplayName: to.Ptr("Install endpoint protection solution on virtual machine scale sets"),
		// 				ResourceDetails: &armsecurity.AzureResourceDetails{
		// 					Source: to.Ptr(armsecurity.SourceAzure),
		// 					ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1"),
		// 				},
		// 				Status: &armsecurity.AssessmentStatusResponse{
		// 					Code: to.Ptr(armsecurity.AssessmentStatusCodeHealthy),
		// 					FirstEvaluationDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-04-12T09:07:18.675Z"); return t}()),
		// 					StatusChangeDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-04-12T09:07:18.675Z"); return t}()),
		// 				},
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("21300918-b2e3-0346-785f-c77ff57d243b"),
		// 			Type: to.Ptr("Microsoft.Security/assessments"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b"),
		// 			Properties: &armsecurity.AssessmentPropertiesResponse{
		// 				AdditionalData: map[string]*string{
		// 					"linkedWorkspaceId": to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"),
		// 				},
		// 				DisplayName: to.Ptr("Install endpoint protection solution on virtual machine scale sets"),
		// 				ResourceDetails: &armsecurity.AzureResourceDetails{
		// 					Source: to.Ptr(armsecurity.SourceAzure),
		// 					ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"),
		// 				},
		// 				Status: &armsecurity.AssessmentStatusResponse{
		// 					Description: to.Ptr("The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on"),
		// 					Cause: to.Ptr("OffByPolicy"),
		// 					Code: to.Ptr(armsecurity.AssessmentStatusCodeNotApplicable),
		// 					FirstEvaluationDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-04-12T09:07:18.675Z"); return t}()),
		// 					StatusChangeDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-04-12T09:07:18.675Z"); 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 security assessments on all your scanned resources inside a scope
 *
 * @summary Get security assessments on all your scanned resources inside a scope
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2021-06-01/examples/Assessments/ListAssessments_example.json
 */
async function listSecurityAssessments() {
  const scope = "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23";
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const resArray = new Array();
  for await (let item of client.assessments.list(scope)) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

Exempelsvar

Statuskod:: 200

{
  "value": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
      "name": "21300918-b2e3-0346-785f-c77ff57d243b",
      "type": "Microsoft.Security/assessments",
      "properties": {
        "resourceDetails": {
          "source": "Azure",
          "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1"
        },
        "displayName": "Install endpoint protection solution on virtual machine scale sets",
        "status": {
          "code": "Healthy",
          "statusChangeDate": "2021-04-12T09:07:18.6759138Z",
          "firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
        }
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
      "name": "21300918-b2e3-0346-785f-c77ff57d243b",
      "type": "Microsoft.Security/assessments",
      "properties": {
        "resourceDetails": {
          "source": "Azure",
          "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
        },
        "displayName": "Install endpoint protection solution on virtual machine scale sets",
        "status": {
          "code": "NotApplicable",
          "cause": "OffByPolicy",
          "description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on",
          "statusChangeDate": "2021-04-12T09:07:18.6759138Z",
          "firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
        },
        "additionalData": {
          "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
        }
      }
    }
  ]
}

Definitioner

Name	Description
AssessmentLinks	Länkar som är relevanta för utvärderingen
AssessmentStatusCode	Programmatisk kod för utvärderingens status
AssessmentStatusResponse	Resultatet av utvärderingen
assessmentType	BuiltIn om utvärderingen baseras på inbyggd Azure Policy-definition, Anpassad om utvärderingen baseras på anpassad Azure Policy-definition
AzureResourceDetails	Information om Den Azure-resurs som utvärderades
categories
CloudError	Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).
CloudErrorBody	Felinformationen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
implementationEffort	Den implementeringsinsats som krävs för att åtgärda den här utvärderingen
OnPremiseResourceDetails	Information om den lokala resurs som utvärderades
OnPremiseSqlResourceDetails	Information om den lokala Sql-resursen som utvärderades
SecurityAssessmentList	Sida i en lista över säkerhetsutvärderingar
SecurityAssessmentMetadataPartnerData	Beskriver partnern som skapade utvärderingen
SecurityAssessmentMetadataProperties	Beskriver egenskaperna för en utvärderingsmetadata.
SecurityAssessmentPartnerData	Data om partnerintegrering från tredje part
SecurityAssessmentResponse	Säkerhetsbedömning för en resurs – svarsformat
severity	Utvärderingens allvarlighetsgrad
threats
userImpact	Utvärderingens användarpåverkan

AssessmentLinks

Länkar som är relevanta för utvärderingen

Name	Typ	Description
azurePortalUri	string	Länk till utvärdering i Azure-portalen

AssessmentStatusCode

Programmatisk kod för utvärderingens status

Name	Typ	Description
Healthy	string	Resursen är felfri
NotApplicable	string	Utvärdering för den här resursen har inte skett
Unhealthy	string	Resursen har ett säkerhetsproblem som måste åtgärdas

AssessmentStatusResponse

Resultatet av utvärderingen

Name	Typ	Description
cause	string	Programmatisk kod för orsaken till utvärderingsstatusen
code	AssessmentStatusCode	Programmatisk kod för utvärderingens status
description	string	Mänsklig läsbar beskrivning av utvärderingsstatusen
firstEvaluationDate	string	Den tid då utvärderingen skapades och först utvärderades. Returneras som UTC-tid i ISO 8601-format
statusChangeDate	string	Den tid då utvärderingens status senast ändrades. Returneras som UTC-tid i ISO 8601-format

assessmentType

BuiltIn om utvärderingen baseras på inbyggd Azure Policy-definition, Anpassad om utvärderingen baseras på anpassad Azure Policy-definition

Name	Typ	Description
BuiltIn	string	Hanterade utvärderingar i Microsoft Defender för molnet
CustomPolicy	string	Användardefinierade principer som matas in automatiskt från Azure Policy till Microsoft Defender för molnet
CustomerManaged	string	Användarutvärderingar som skickas direkt av användaren eller någon annan tredje part till Microsoft Defender för molnet
VerifiedPartner	string	En utvärdering som skapades av en verifierad tredje part om användaren anslöt den till ASC

AzureResourceDetails

Information om Den Azure-resurs som utvärderades

Name	Typ	Description
id	string	Azure-resurs-ID för den utvärderade resursen
source	string: Azure	Plattformen där den utvärderade resursen finns

Name	Typ	Description
Compute	string
Data	string
IdentityAndAccess	string
IoT	string
Networking	string

CloudError

Vanligt felsvar för alla Azure Resource Manager-API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även formatet för OData-felsvar.).

Name	Typ	Description
error.additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
error.code	string	Felkoden.
error.details	CloudErrorBody[]	Felinformationen.
error.message	string	Felmeddelandet.
error.target	string	Felmålet.

CloudErrorBody

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	CloudErrorBody[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

implementationEffort

Den implementeringsinsats som krävs för att åtgärda den här utvärderingen

Name	Typ	Description
High	string
Low	string
Moderate	string

OnPremiseResourceDetails

Information om den lokala resurs som utvärderades

Name	Typ	Description
machineName	string	Namnet på datorn
source	string: OnPremise	Plattformen där den utvärderade resursen finns
sourceComputerId	string	Oms-agent-ID:t som är installerat på datorn
vmuuid	string	Datorns unika ID
workspaceId	string	Azure-resurs-ID för arbetsytan som datorn är ansluten till

OnPremiseSqlResourceDetails

Information om den lokala Sql-resursen som utvärderades

Name	Typ	Description
databaseName	string	Sql-databasnamnet som är installerat på datorn
machineName	string	Namnet på datorn
serverName	string	Sql Server-namnet installerat på datorn
source	string: OnPremiseSql	Plattformen där den utvärderade resursen finns
sourceComputerId	string	Oms-agent-ID:t som är installerat på datorn
vmuuid	string	Datorns unika ID
workspaceId	string	Azure-resurs-ID för arbetsytan som datorn är ansluten till

SecurityAssessmentList

Sida i en lista över säkerhetsutvärderingar

Name	Typ	Description
nextLink	string	URI:n för att hämta nästa sida.
value	SecurityAssessmentResponse[]	Samling säkerhetsutvärderingar på den här sidan

SecurityAssessmentMetadataPartnerData

Beskriver partnern som skapade utvärderingen

Name	Typ	Description
partnerName	string	Namnet på partnerns företag
productName	string	Namnet på produkten för partnern som skapade utvärderingen
secret	string	Hemlighet för att autentisera partnern och verifiera att den skapade utvärderingen – skriv endast

SecurityAssessmentMetadataProperties

Beskriver egenskaperna för en utvärderingsmetadata.

Name	Typ	Description
assessmentType	assessmentType	BuiltIn om utvärderingen baseras på inbyggd Azure Policy-definition, Anpassad om utvärderingen baseras på anpassad Azure Policy-definition
categories	categories[]	De resurskategorier som är i riskzonen när utvärderingen inte är felfri
description	string	Mänsklig läsbar beskrivning av utvärderingen
displayName	string	Användarvänligt visningsnamn för utvärderingen
implementationEffort	implementationEffort	Den implementeringsinsats som krävs för att åtgärda den här utvärderingen
partnerData	SecurityAssessmentMetadataPartnerData	Beskriver partnern som skapade utvärderingen
policyDefinitionId	string	Azure-resurs-ID för principdefinitionen som aktiverar den här utvärderingsberäkningen
preview	boolean	Sant om den här utvärderingen är i förhandsversionsstatus
remediationDescription	string	Mänsklig läsbar beskrivning av vad du bör göra för att åtgärda det här säkerhetsproblemet
severity	severity	Utvärderingens allvarlighetsgrad
threats	threats[]	Hotpåverkan av utvärderingen
userImpact	userImpact	Utvärderingens användarpåverkan

SecurityAssessmentPartnerData

Data om partnerintegrering från tredje part

Name	Typ	Description
partnerName	string	Namnet på partnerns företag
secret	string	hemlighet för att autentisera partnern – skriv endast

SecurityAssessmentResponse

Säkerhetsbedömning för en resurs – svarsformat

Name	Typ	Description
id	string	Resurs-ID
name	string	Resursnamn
properties.additionalData	object	Ytterligare data om utvärderingen
properties.displayName	string	Användarvänligt visningsnamn för utvärderingen
properties.links	AssessmentLinks	Länkar som är relevanta för utvärderingen
properties.metadata	SecurityAssessmentMetadataProperties	Beskriver egenskaperna för en utvärderingsmetadata.
properties.partnersData	SecurityAssessmentPartnerData	Data om partnerintegrering från tredje part
properties.resourceDetails	ResourceDetails: AzureResourceDetails OnPremiseResourceDetails OnPremiseSqlResourceDetails	Information om resursen som utvärderades
properties.status	AssessmentStatusResponse	Resultatet av utvärderingen
type	string	Resurstyp

severity

Utvärderingens allvarlighetsgrad

Name	Typ	Description
High	string
Low	string
Medium	string

threats

Name	Typ	Description
accountBreach	string
dataExfiltration	string
dataSpillage	string
denialOfService	string
elevationOfPrivilege	string
maliciousInsider	string
missingCoverage	string
threatResistance	string

userImpact

Utvärderingens användarpåverkan

Name	Typ	Description
High	string
Low	string
Moderate	string

Dela via

Assessments - List

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

List security assessments

Exempelbegäran

Exempelsvar

Definitioner

AssessmentLinks

AssessmentStatusCode

AssessmentStatusResponse

assessmentType

AzureResourceDetails

categories

CloudError

CloudErrorBody

ErrorAdditionalInfo

implementationEffort

OnPremiseResourceDetails

OnPremiseSqlResourceDetails

SecurityAssessmentList

SecurityAssessmentMetadataPartnerData

SecurityAssessmentMetadataProperties

SecurityAssessmentPartnerData

SecurityAssessmentResponse

severity

threats

userImpact

Ytterligare resurser