다음을 통해 공유


Assessments Metadata - Create In Subscription

특정 구독의 평가 유형에 대한 메타데이터 정보 만들기

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/assessmentMetadata/{assessmentMetadataName}?api-version=2021-06-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
assessmentMetadataName
path True

string

평가 키 - 평가 유형에 대한 고유 키

subscriptionId
path True

string

Azure 구독 ID

regex 패턴: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

작업에 대한 API 버전

요청 본문

Name 필수 형식 Description
properties.assessmentType True

assessmentType

기본 제공 Azure Policy 정의를 기반으로 하는 평가인 경우 BuiltIn, 사용자 지정 Azure Policy 정의를 기반으로 하는 평가인 경우 사용자 지정

properties.displayName True

string

평가의 사용자에게 친숙한 표시 이름

properties.severity True

severity

평가의 심각도 수준

properties.categories

categories[]

평가가 비정상일 때 위험에 처한 리소스의 범주

properties.description

string

평가에 대한 사람이 읽을 수 있는 설명

properties.implementationEffort

implementationEffort

이 평가를 수정하는 데 필요한 구현 작업

properties.partnerData

SecurityAssessmentMetadataPartnerData

평가를 만든 파트너에 대해 설명합니다.

properties.plannedDeprecationDate

string

properties.preview

boolean

이 평가가 미리 보기 릴리스 상태인 경우 True입니다.

properties.publishDates

PublishDates

properties.remediationDescription

string

이 보안 문제를 완화하기 위해 해야 할 일에 대한 사람이 읽을 수 있는 설명

properties.tactics

tactics[]

평가 전술

properties.techniques

techniques[]

평가 기술

properties.threats

threats[]

평가의 위협 영향

properties.userImpact

userImpact

평가의 사용자 영향

응답

Name 형식 Description
200 OK

SecurityAssessmentMetadataResponse

그래

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 사용자 계정 가장

예제

Create security assessment metadata for subscription

샘플 요청

PUT https://management.azure.com/subscriptions/0980887d-03d6-408c-9566-532f3456804e/providers/Microsoft.Security/assessmentMetadata/ca039e75-a276-4175-aebc-bcd41e4b14b7?api-version=2021-06-01

{
  "properties": {
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "description": "Install an endpoint protection solution on your virtual machines scale sets, to protect them from threats and vulnerabilities.",
    "remediationDescription": "To install an endpoint protection solution: 1.  <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">Follow the instructions in How do I turn on antimalware in my virtual machine scale set</a>",
    "categories": [
      "Compute"
    ],
    "severity": "Medium",
    "userImpact": "Low",
    "implementationEffort": "Low",
    "threats": [
      "dataExfiltration",
      "dataSpillage",
      "maliciousInsider"
    ],
    "assessmentType": "CustomerManaged"
  }
}

샘플 응답

{
  "id": "/providers/Microsoft.Security/assessmentMetadata/ca039e75-a276-4175-aebc-bcd41e4b14b7",
  "name": "ca039e75-a276-4175-aebc-bcd41e4b14b7",
  "type": "Microsoft.Security/assessmentMetadata",
  "properties": {
    "displayName": "My organization security assessment",
    "description": "Assessment that my organization created to view our security assessment in Azure Security Center",
    "remediationDescription": "Fix it with these remediation instructions",
    "categories": [
      "Compute"
    ],
    "severity": "Medium",
    "userImpact": "Low",
    "implementationEffort": "Low",
    "threats": [
      "dataExfiltration",
      "dataSpillage",
      "maliciousInsider"
    ],
    "assessmentType": "CustomerManaged"
  }
}

정의

Name Description
assessmentType

기본 제공 Azure Policy 정의를 기반으로 하는 평가인 경우 BuiltIn, 사용자 지정 Azure Policy 정의를 기반으로 하는 평가인 경우 사용자 지정

categories
CloudError

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

CloudErrorBody

오류 세부 정보입니다.

ErrorAdditionalInfo

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

implementationEffort

이 평가를 수정하는 데 필요한 구현 작업

PublishDates
SecurityAssessmentMetadataPartnerData

평가를 만든 파트너에 대해 설명합니다.

SecurityAssessmentMetadataResponse

보안 평가 메타데이터 응답

severity

평가의 심각도 수준

tactics
techniques
threats
userImpact

평가의 사용자 영향

assessmentType

기본 제공 Azure Policy 정의를 기반으로 하는 평가인 경우 BuiltIn, 사용자 지정 Azure Policy 정의를 기반으로 하는 평가인 경우 사용자 지정

Name 형식 Description
BuiltIn

string

클라우드용 Microsoft Defender 관리 평가

CustomPolicy

string

Azure Policy에서 클라우드용 Microsoft Defender로 자동으로 수집되는 사용자 정의 정책

CustomerManaged

string

사용자 또는 다른 타사에서 클라우드용 Microsoft Defender로 직접 푸시한 사용자 평가

VerifiedPartner

string

사용자가 ASC에 연결한 경우 확인된 타사에서 만든 평가

categories

Name 형식 Description
Compute

string

Data

string

IdentityAndAccess

string

IoT

string

Networking

string

CloudError

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

Name 형식 Description
error.additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

error.code

string

오류 코드입니다.

error.details

CloudErrorBody[]

오류 세부 정보입니다.

error.message

string

오류 메시지입니다.

error.target

string

오류 대상입니다.

CloudErrorBody

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

CloudErrorBody[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

implementationEffort

이 평가를 수정하는 데 필요한 구현 작업

Name 형식 Description
High

string

Low

string

Moderate

string

PublishDates

Name 형식 Description
GA

string

public

string

SecurityAssessmentMetadataPartnerData

평가를 만든 파트너에 대해 설명합니다.

Name 형식 Description
partnerName

string

파트너의 회사 이름

productName

string

평가를 만든 파트너의 제품 이름

secret

string

파트너를 인증하고 평가를 생성했는지 확인하는 비밀 - 쓰기 전용

SecurityAssessmentMetadataResponse

보안 평가 메타데이터 응답

Name 형식 Description
id

string

리소스 ID

name

string

리소스 이름

properties.assessmentType

assessmentType

기본 제공 Azure Policy 정의를 기반으로 하는 평가인 경우 BuiltIn, 사용자 지정 Azure Policy 정의를 기반으로 하는 평가인 경우 사용자 지정

properties.categories

categories[]

평가가 비정상일 때 위험에 처한 리소스의 범주

properties.description

string

평가에 대한 사람이 읽을 수 있는 설명

properties.displayName

string

평가의 사용자에게 친숙한 표시 이름

properties.implementationEffort

implementationEffort

이 평가를 수정하는 데 필요한 구현 작업

properties.partnerData

SecurityAssessmentMetadataPartnerData

평가를 만든 파트너에 대해 설명합니다.

properties.plannedDeprecationDate

string

properties.policyDefinitionId

string

이 평가 계산을 켜는 정책 정의의 Azure 리소스 ID

properties.preview

boolean

이 평가가 미리 보기 릴리스 상태인 경우 True입니다.

properties.publishDates

PublishDates

properties.remediationDescription

string

이 보안 문제를 완화하기 위해 해야 할 일에 대한 사람이 읽을 수 있는 설명

properties.severity

severity

평가의 심각도 수준

properties.tactics

tactics[]

평가 전술

properties.techniques

techniques[]

평가 기술

properties.threats

threats[]

평가의 위협 영향

properties.userImpact

userImpact

평가의 사용자 영향

type

string

리소스 종류

severity

평가의 심각도 수준

Name 형식 Description
High

string

Low

string

Medium

string

tactics

Name 형식 Description
Collection

string

Command and Control

string

Credential Access

string

Defense Evasion

string

Discovery

string

Execution

string

Exfiltration

string

Impact

string

Initial Access

string

Lateral Movement

string

Persistence

string

Privilege Escalation

string

Reconnaissance

string

Resource Development

string

techniques

Name 형식 Description
Abuse Elevation Control Mechanism

string

Access Token Manipulation

string

Account Discovery

string

Account Manipulation

string

Active Scanning

string

Application Layer Protocol

string

Audio Capture

string

Boot or Logon Autostart Execution

string

Boot or Logon Initialization Scripts

string

Brute Force

string

Cloud Infrastructure Discovery

string

Cloud Service Dashboard

string

Cloud Service Discovery

string

Command and Scripting Interpreter

string

Compromise Client Software Binary

string

Compromise Infrastructure

string

Container and Resource Discovery

string

Create Account

string

Create or Modify System Process

string

Credentials from Password Stores

string

Data Destruction

string

Data Encrypted for Impact

string

Data Manipulation

string

Data Staged

string

Data from Cloud Storage Object

string

Data from Configuration Repository

string

Data from Information Repositories

string

Data from Local System

string

Defacement

string

Deobfuscate/Decode Files or Information

string

Disk Wipe

string

Domain Trust Discovery

string

Drive-by Compromise

string

Dynamic Resolution

string

Endpoint Denial of Service

string

Event Triggered Execution

string

Exfiltration Over Alternative Protocol

string

Exploit Public-Facing Application

string

Exploitation for Client Execution

string

Exploitation for Credential Access

string

Exploitation for Defense Evasion

string

Exploitation for Privilege Escalation

string

Exploitation of Remote Services

string

External Remote Services

string

Fallback Channels

string

File and Directory Discovery

string

File and Directory Permissions Modification

string

Gather Victim Network Information

string

Hide Artifacts

string

Hijack Execution Flow

string

Impair Defenses

string

Implant Container Image

string

Indicator Removal on Host

string

Indirect Command Execution

string

Ingress Tool Transfer

string

Input Capture

string

Inter-Process Communication

string

Lateral Tool Transfer

string

Man-in-the-Middle

string

Masquerading

string

Modify Authentication Process

string

Modify Registry

string

Network Denial of Service

string

Network Service Scanning

string

Network Sniffing

string

Non-Application Layer Protocol

string

Non-Standard Port

string

OS Credential Dumping

string

Obfuscated Files or Information

string

Obtain Capabilities

string

Office Application Startup

string

Permission Groups Discovery

string

Phishing

string

Pre-OS Boot

string

Process Discovery

string

Process Injection

string

Protocol Tunneling

string

Proxy

string

Query Registry

string

Remote Access Software

string

Remote Service Session Hijacking

string

Remote Services

string

Remote System Discovery

string

Resource Hijacking

string

SQL Stored Procedures

string

Scheduled Task/Job

string

Screen Capture

string

Search Victim-Owned Websites

string

Server Software Component

string

Service Stop

string

Signed Binary Proxy Execution

string

Software Deployment Tools

string

Steal or Forge Kerberos Tickets

string

Subvert Trust Controls

string

Supply Chain Compromise

string

System Information Discovery

string

Taint Shared Content

string

Traffic Signaling

string

Transfer Data to Cloud Account

string

Trusted Relationship

string

Unsecured Credentials

string

User Execution

string

Valid Accounts

string

Windows Management Instrumentation

string

threats

Name 형식 Description
accountBreach

string

dataExfiltration

string

dataSpillage

string

denialOfService

string

elevationOfPrivilege

string

maliciousInsider

string

missingCoverage

string

threatResistance

string

userImpact

평가의 사용자 영향

Name 형식 Description
High

string

Low

string

Moderate

string