Sub Assessments - List

참조

서비스:: Defender for Cloud

API 버전:: 2019-01-01-preview

범위 내의 모든 검색된 리소스에 대한 보안 하위 평가 가져오기

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
assessmentName	path	True	string	평가 키 - 평가 유형에 대한 고유 키
scope	path	True	string	쿼리 범위는 구독(/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) 또는 관리 그룹(/providers/Microsoft.Management/managementGroups/mgName)일 수 있습니다.
api-version	query	True	string	작업에 대한 API 버전

응답

Name	형식	Description
200 OK	SecuritySubAssessmentList	그래
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

List security sub-assessments

샘플 요청

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/assessments/82e20e14-edc5-4373-bfc4-f13121257c37/subAssessments?api-version=2019-01-01-preview


/**
 * Samples for SubAssessments List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/SubAssessments/
     * ListSubAssessments_example.json
     */
    /**
     * Sample code: List security sub-assessments.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listSecuritySubAssessments(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.subAssessments().list("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23",
            "82e20e14-edc5-4373-bfc4-f13121257c37", 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/ListSubAssessments_example.json
func ExampleSubAssessmentsClient_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.NewSubAssessmentsClient().NewListPager("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23", "82e20e14-edc5-4373-bfc4-f13121257c37", 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.SubAssessmentList = armsecurity.SubAssessmentList{
		// 	Value: []*armsecurity.SubAssessment{
		// 		{
		// 			Name: to.Ptr("8fbe5054-e97c-3a7a-fda7-c8308ca8d3cf"),
		// 			Type: to.Ptr("Microsoft.Security/assessments/subAssessments"),
		// 			ID: to.Ptr("/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/ascdemoRG/providers/Microsoft.Sql/servers/sqlserver1demo/providers/Microsoft.Security/assessments/82e20e14-edc5-4373-bfc4-f13121257c37/subassessments/8fbe5054-e97c-3a7a-fda7-c8308ca8d3cf"),
		// 			Properties: &armsecurity.SubAssessmentProperties{
		// 				Description: to.Ptr("The Azure SQL Database-level firewall helps protect your data by preventing all access to your database until you specify which IP addresses have permission. Database-level firewall rules grant access to the specific database based on the originating IP address of each request.\n\nDatabase-level firewall rules for master"),
		// 				AdditionalData: &armsecurity.SQLServerVulnerabilityProperties{
		// 					AssessedResourceType: to.Ptr(armsecurity.AssessedResourceTypeSQLServerVulnerability),
		// 					Type: to.Ptr("AzureDatabase"),
		// 					Query: to.Ptr("SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.database_firewall_rules"),
		// 				},
		// 				Category: to.Ptr("SurfaceAreaReduction"),
		// 				DisplayName: to.Ptr("Database-level firewall rules should be tracked and maintained at a strict minimum"),
		// 				ID: to.Ptr("VA2064"),
		// 				Impact: to.Ptr("Firewall rules should be strictly configured to allow access only to client computers that have a valid need to connect to the database. Any superfluous entries in the firewall may pose a threat by allowing an unauthorized source access to your database."),
		// 				Remediation: to.Ptr("Evaluate each of the database-level firewall rules. Remove any rules that grant unnecessary access and set the rest as a baseline. Deviations from the baseline will be identified and brought to your attention in subsequent scans."),
		// 				ResourceDetails: &armsecurity.AzureResourceDetails{
		// 					Source: to.Ptr(armsecurity.SourceAzure),
		// 					ID: to.Ptr("/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/ascdemoRG/providers/Microsoft.Sql/servers/sqlserver1demo/databases/database1"),
		// 				},
		// 				Status: &armsecurity.SubAssessmentStatus{
		// 					Cause: to.Ptr("Unknown"),
		// 					Code: to.Ptr(armsecurity.SubAssessmentStatusCodeHealthy),
		// 					Severity: to.Ptr(armsecurity.SeverityHigh),
		// 				},
		// 				TimeGenerated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-06-23T12:20:08.764Z"); 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 sub-assessments on all your scanned resources inside a scope
 *
 * @summary Get security sub-assessments on all your scanned resources inside a scope
 * x-ms-original-file: specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/SubAssessments/ListSubAssessments_example.json
 */
async function listSecuritySubAssessments() {
  const scope = "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23";
  const assessmentName = "82e20e14-edc5-4373-bfc4-f13121257c37";
  const credential = new DefaultAzureCredential();
  const client = new SecurityCenter(credential);
  const resArray = new Array();
  for await (let item of client.subAssessments.list(scope, assessmentName)) {
    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

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

// Generated from example definition: specification/security/resource-manager/Microsoft.Security/preview/2019-01-01-preview/examples/SubAssessments/ListSubAssessments_example.json
// this example is just showing the usage of "SubAssessments_List" 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 SecurityAssessmentResource created on azure
// for more information of creating SecurityAssessmentResource, please refer to the document of SecurityAssessmentResource
string scope = "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23";
string assessmentName = "82e20e14-edc5-4373-bfc4-f13121257c37";
ResourceIdentifier securityAssessmentResourceId = SecurityAssessmentResource.CreateResourceIdentifier(scope, assessmentName);
SecurityAssessmentResource securityAssessment = client.GetSecurityAssessmentResource(securityAssessmentResourceId);

// get the collection of this SecuritySubAssessmentResource
SecuritySubAssessmentCollection collection = securityAssessment.GetSecuritySubAssessments();

// invoke the operation and iterate over the result
await foreach (SecuritySubAssessmentResource item in collection.GetAllAsync())
{
    // the variable item 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 = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/ascdemoRG/providers/Microsoft.Sql/servers/sqlserver1demo/providers/Microsoft.Security/assessments/82e20e14-edc5-4373-bfc4-f13121257c37/subassessments/8fbe5054-e97c-3a7a-fda7-c8308ca8d3cf",
      "name": "8fbe5054-e97c-3a7a-fda7-c8308ca8d3cf",
      "type": "Microsoft.Security/assessments/subAssessments",
      "properties": {
        "id": "VA2064",
        "displayName": "Database-level firewall rules should be tracked and maintained at a strict minimum",
        "status": {
          "code": "Healthy",
          "severity": "High",
          "cause": "Unknown"
        },
        "remediation": "Evaluate each of the database-level firewall rules. Remove any rules that grant unnecessary access and set the rest as a baseline. Deviations from the baseline will be identified and brought to your attention in subsequent scans.",
        "impact": "Firewall rules should be strictly configured to allow access only to client computers that have a valid need to connect to the database. Any superfluous entries in the firewall may pose a threat by allowing an unauthorized source access to your database.",
        "category": "SurfaceAreaReduction",
        "description": "The Azure SQL Database-level firewall helps protect your data by preventing all access to your database until you specify which IP addresses have permission. Database-level firewall rules grant access to the specific database based on the originating IP address of each request.\n\nDatabase-level firewall rules for master",
        "timeGenerated": "2019-06-23T12:20:08.7644808Z",
        "resourceDetails": {
          "source": "Azure",
          "id": "/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/ascdemoRG/providers/Microsoft.Sql/servers/sqlserver1demo/databases/database1"
        },
        "additionalData": {
          "assessedResourceType": "SqlServerVulnerability",
          "type": "AzureDatabase",
          "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.database_firewall_rules",
          "benchmarks": []
        }
      }
    }
  ]
}

정의

Name	Description
AzureResourceDetails	평가된 Azure 리소스의 세부 정보
CloudError	실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.
CloudErrorBody	오류 세부 정보입니다.
ContainerRegistryVulnerabilityProperties	컨테이너 레지스트리 취약성 평가를 위한 추가 컨텍스트 필드
CVE	CVE 세부 정보
CVSS	CVSS 세부 정보
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
OnPremiseResourceDetails	평가된 온-프레미스 리소스의 세부 정보
OnPremiseSqlResourceDetails	평가된 온-프레미스 Sql 리소스의 세부 정보
SecuritySubAssessment	리소스에 대한 보안 하위 평가
SecuritySubAssessmentList	보안 하위 평가 목록
ServerVulnerabilityProperties	서버 취약성 평가를 위한 추가 컨텍스트 필드
severity	하위 평가 심각도 수준
SqlServerVulnerabilityProperties	평가된 리소스의 세부 정보
SubAssessmentStatus	하위 평가의 상태
SubAssessmentStatusCode	평가 상태에 대한 프로그래밍 코드
VendorReference	공급업체 참조

AzureResourceDetails

Object

평가된 Azure 리소스의 세부 정보

Name	형식	Description
id	string	평가된 리소스의 Azure 리소스 ID
source	string: Azure	평가된 리소스가 있는 플랫폼

CloudError

Object

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다.

Name	형식	Description
error.additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
error.code	string	오류 코드입니다.
error.details	CloudErrorBody[]	오류 세부 정보입니다.
error.message	string	오류 메시지입니다.
error.target	string	오류 대상입니다.

CloudErrorBody

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	CloudErrorBody[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ContainerRegistryVulnerabilityProperties

Object

컨테이너 레지스트리 취약성 평가를 위한 추가 컨텍스트 필드

Name	형식	Description
assessedResourceType	string: ContainerRegistryVulnerability	하위 평가 리소스 종류
cve	CVE[]	CVE 목록
cvss	<string, CVSS>	Dictionary(cvss 버전에서 cvss 세부 정보에서 개체까지)
imageDigest	string	취약한 이미지의 다이제스트
patchable	boolean	패치를 사용할 수 있는지 여부를 나타냅니다.
publishedTime	string (date-time)	게시된 시간
repositoryName	string	취약한 이미지가 속한 리포지토리의 이름
type	string	취약성 유형입니다. 예: 취약성, 잠재적 취약성, 수집된 정보, 취약성
vendorReferences	VendorReference[]	공급업체 참조

CVE

Object

CVE 세부 정보

Name	형식	Description
link	string	링크 URL
title	string	CVE 제목

CVSS

Object

CVSS 세부 정보

Name	형식	Description
base	number	CVSS 베이스

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

OnPremiseResourceDetails

Object

평가된 온-프레미스 리소스의 세부 정보

Name	형식	Description
machineName	string	컴퓨터의 이름
source	string: OnPremise	평가된 리소스가 있는 플랫폼
sourceComputerId	string	컴퓨터에 설치된 oms 에이전트 ID
vmuuid	string	컴퓨터의 고유 ID
workspaceId	string	컴퓨터가 연결된 작업 영역의 Azure 리소스 ID

OnPremiseSqlResourceDetails

Object

평가된 온-프레미스 Sql 리소스의 세부 정보

Name	형식	Description
databaseName	string	컴퓨터에 설치된 Sql 데이터베이스 이름
machineName	string	컴퓨터의 이름
serverName	string	컴퓨터에 설치된 Sql Server 이름
source	string: OnPremiseSql	평가된 리소스가 있는 플랫폼
sourceComputerId	string	컴퓨터에 설치된 oms 에이전트 ID
vmuuid	string	컴퓨터의 고유 ID
workspaceId	string	컴퓨터가 연결된 작업 영역의 Azure 리소스 ID

SecuritySubAssessment

Object

리소스에 대한 보안 하위 평가

Name	형식	Description
id	string	리소스 ID
name	string	리소스 이름
properties.additionalData	AdditionalData: ContainerRegistryVulnerabilityProperties ServerVulnerabilityProperties SqlServerVulnerabilityProperties	하위 평가의 세부 정보
properties.category	string	하위 평가의 범주
properties.description	string	평가 상태에 대한 사람이 읽을 수 있는 설명
properties.displayName	string	하위 평가의 사용자에게 친숙한 표시 이름
properties.id	string	취약성 ID
properties.impact	string	이 하위 평가의 영향에 대한 설명
properties.remediation	string	이 하위 평가를 수정하는 방법에 대한 정보
properties.resourceDetails	ResourceDetails: AzureResourceDetails OnPremiseResourceDetails OnPremiseSqlResourceDetails	평가된 리소스의 세부 정보
properties.status	SubAssessmentStatus	하위 평가의 상태
properties.timeGenerated	string (date-time)	하위 평가가 생성된 날짜 및 시간
type	string	리소스 종류

SecuritySubAssessmentList

Object

보안 하위 평가 목록

Name	형식	Description
nextLink	string	다음 페이지를 가져올 URI입니다.
value	SecuritySubAssessment[]	리소스에 대한 보안 하위 평가

ServerVulnerabilityProperties

Object

서버 취약성 평가를 위한 추가 컨텍스트 필드

Name	형식	Description
assessedResourceType	string: ServerVulnerabilityAssessment	하위 평가 리소스 종류
cve	CVE[]	CVE 목록
cvss	<string, CVSS>	Dictionary(cvss 버전에서 cvss 세부 정보에서 개체까지)
patchable	boolean	패치를 사용할 수 있는지 여부를 나타냅니다.
publishedTime	string (date-time)	게시된 시간
threat	string	위협 이름
type	string	취약성 유형입니다. 예: 취약성, 잠재적 취약성, 수집된 정보
vendorReferences	VendorReference[]	공급업체 참조

severity

열거형

하위 평가 심각도 수준

값	Description
High
Low
Medium

SqlServerVulnerabilityProperties

Object

평가된 리소스의 세부 정보

Name	형식	Description
assessedResourceType	string: SqlServerVulnerability	하위 평가 리소스 종류
query	string	특정 검사를 수행하기 위해 SQL 데이터베이스에서 실행되는 T-SQL 쿼리
type	string	하위 평가가 해당 리소스 세부 정보에서 참조하는 리소스 종류

SubAssessmentStatus

Object

하위 평가의 상태

Name	형식	Description
cause	string	평가 상태의 원인에 대한 프로그래밍 코드
code	SubAssessmentStatusCode	평가 상태에 대한 프로그래밍 코드
description	string	평가 상태에 대한 사람이 읽을 수 있는 설명
severity	severity	하위 평가 심각도 수준

SubAssessmentStatusCode

열거형

평가 상태에 대한 프로그래밍 코드

값	Description
Healthy	리소스가 정상입니다.
NotApplicable	이 리소스에 대한 평가가 수행되지 않았습니다.
Unhealthy	리소스에 해결해야 하는 보안 문제가 있습니다.

VendorReference

Object

공급업체 참조

Name	형식	Description
link	string	링크 URL
title	string	링크 제목

다음을 통해 공유

Sub Assessments - List

URI 매개 변수

응답

보안

azure_auth

범위

예제

List security sub-assessments

샘플 요청

샘플 응답

정의

AzureResourceDetails

CloudError

CloudErrorBody

ContainerRegistryVulnerabilityProperties

CVE

CVSS

ErrorAdditionalInfo

OnPremiseResourceDetails

OnPremiseSqlResourceDetails

SecuritySubAssessment

SecuritySubAssessmentList

ServerVulnerabilityProperties

severity

SqlServerVulnerabilityProperties

SubAssessmentStatus

SubAssessmentStatusCode

VendorReference

추가 리소스