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 |
---|---|---|---|---|
assessment
|
path | True |
string |
평가 키 - 평가 유형에 대한 고유 키 |
subscription
|
path | True |
string |
Azure 구독 ID regex 패턴: |
api-version
|
query | True |
string |
작업에 대한 API 버전 |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
properties.assessmentType | True |
기본 제공 Azure Policy 정의를 기반으로 하는 평가인 경우 BuiltIn, 사용자 지정 Azure Policy 정의를 기반으로 하는 평가인 경우 사용자 지정 |
|
properties.displayName | True |
string |
평가의 사용자에게 친숙한 표시 이름 |
properties.severity | True |
평가의 심각도 수준 |
|
properties.categories |
평가가 비정상일 때 위험에 처한 리소스의 범주 |
||
properties.description |
string |
평가에 대한 사람이 읽을 수 있는 설명 |
|
properties.implementationEffort |
이 평가를 수정하는 데 필요한 구현 작업 |
||
properties.partnerData |
평가를 만든 파트너에 대해 설명합니다. |
||
properties.plannedDeprecationDate |
string |
||
properties.preview |
boolean |
이 평가가 미리 보기 릴리스 상태인 경우 True입니다. |
|
properties.publishDates | |||
properties.remediationDescription |
string |
이 보안 문제를 완화하기 위해 해야 할 일에 대한 사람이 읽을 수 있는 설명 |
|
properties.tactics |
tactics[] |
평가 전술 |
|
properties.techniques |
평가 기술 |
||
properties.threats |
threats[] |
평가의 위협 영향 |
|
properties.userImpact |
평가의 사용자 영향 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
그래 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
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 |
---|---|
assessment |
기본 제공 Azure Policy 정의를 기반으로 하는 평가인 경우 BuiltIn, 사용자 지정 Azure Policy 정의를 기반으로 하는 평가인 경우 사용자 지정 |
categories | |
Cloud |
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. 또한 OData 오류 응답 형식을 따릅니다. |
Cloud |
오류 세부 정보입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
implementation |
이 평가를 수정하는 데 필요한 구현 작업 |
Publish |
|
Security |
평가를 만든 파트너에 대해 설명합니다. |
Security |
보안 평가 메타데이터 응답 |
severity |
평가의 심각도 수준 |
tactics | |
techniques | |
threats | |
user |
평가의 사용자 영향 |
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 |
오류 추가 정보입니다. |
|
error.code |
string |
오류 코드입니다. |
error.details |
오류 세부 정보입니다. |
|
error.message |
string |
오류 메시지입니다. |
error.target |
string |
오류 대상입니다. |
CloudErrorBody
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
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 |
기본 제공 Azure Policy 정의를 기반으로 하는 평가인 경우 BuiltIn, 사용자 지정 Azure Policy 정의를 기반으로 하는 평가인 경우 사용자 지정 |
|
properties.categories |
평가가 비정상일 때 위험에 처한 리소스의 범주 |
|
properties.description |
string |
평가에 대한 사람이 읽을 수 있는 설명 |
properties.displayName |
string |
평가의 사용자에게 친숙한 표시 이름 |
properties.implementationEffort |
이 평가를 수정하는 데 필요한 구현 작업 |
|
properties.partnerData |
평가를 만든 파트너에 대해 설명합니다. |
|
properties.plannedDeprecationDate |
string |
|
properties.policyDefinitionId |
string |
이 평가 계산을 켜는 정책 정의의 Azure 리소스 ID |
properties.preview |
boolean |
이 평가가 미리 보기 릴리스 상태인 경우 True입니다. |
properties.publishDates | ||
properties.remediationDescription |
string |
이 보안 문제를 완화하기 위해 해야 할 일에 대한 사람이 읽을 수 있는 설명 |
properties.severity |
평가의 심각도 수준 |
|
properties.tactics |
tactics[] |
평가 전술 |
properties.techniques |
평가 기술 |
|
properties.threats |
threats[] |
평가의 위협 영향 |
properties.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 |