Assessments Metadata - Create In Subscription
Vytvoření informací o metadatech pro typ posouzení v konkrétním předplatném
PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/assessmentMetadata/{assessmentMetadataName}?api-version=2021-06-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
assessment
|
path | True |
string |
Klíč posouzení – jedinečný klíč pro typ posouzení |
subscription
|
path | True |
string |
ID předplatného Azure Vzor regulárního výrazu: |
api-version
|
query | True |
string |
Verze rozhraní API pro operaci |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
properties.assessmentType | True |
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition |
|
properties.displayName | True |
string |
Uživatelsky přívětivý zobrazovaný název posouzení |
properties.severity | True |
Úroveň závažnosti posouzení |
|
properties.categories |
Kategorie prostředků, které jsou ohroženy, když posouzení není v pořádku |
||
properties.description |
string |
Human readable description of the assessment |
|
properties.implementationEffort |
Úsilí o implementaci potřebné k nápravě tohoto posouzení |
||
properties.partnerData |
Popisuje partnera, který vytvořil posouzení. |
||
properties.plannedDeprecationDate |
string |
||
properties.preview |
boolean |
Hodnota True, pokud je toto posouzení ve stavu verze Preview |
|
properties.publishDates | |||
properties.remediationDescription |
string |
Popis toho, co byste měli udělat pro zmírnění tohoto problému se zabezpečením, je čitelný pro člověka |
|
properties.tactics |
tactics[] |
Taktika posouzení |
|
properties.techniques |
Techniky posouzení |
||
properties.threats |
threats[] |
Dopad posouzení na hrozby |
|
properties.userImpact |
Dopad posouzení na uživatele |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Azure Active Directory OAuth2 Flow
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Create security assessment metadata for subscription
Ukázkový požadavek
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"
}
}
Ukázková odpověď
{
"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"
}
}
Definice
Name | Description |
---|---|
assessment |
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition |
categories | |
Cloud |
Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.) |
Cloud |
Podrobnosti o chybě. |
Error |
Další informace o chybě správy prostředků |
implementation |
Úsilí o implementaci potřebné k nápravě tohoto posouzení |
Publish |
|
Security |
Popisuje partnera, který vytvořil posouzení. |
Security |
Odpověď na metadata posouzení zabezpečení |
severity |
Úroveň závažnosti posouzení |
tactics | |
techniques | |
threats | |
user |
Dopad posouzení na uživatele |
assessmentType
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition
Name | Typ | Description |
---|---|---|
BuiltIn |
string |
Posouzení spravovaná v programu Microsoft Defender pro cloud |
CustomPolicy |
string |
Uživatelem definované zásady, které se automaticky ingestují ze služby Azure Policy do Microsoft Defenderu pro cloud |
CustomerManaged |
string |
Hodnocení uživatelů nabízená přímo uživatelem nebo jinou třetí stranou do programu Microsoft Defender for Cloud |
VerifiedPartner |
string |
Posouzení vytvořené ověřenou třetí stranou, pokud ho uživatel připojil k ASC |
categories
Name | Typ | Description |
---|---|---|
Compute |
string |
|
Data |
string |
|
IdentityAndAccess |
string |
|
IoT |
string |
|
Networking |
string |
CloudError
Běžná chybová odpověď pro všechna rozhraní API Azure Resource Manageru pro vrácení podrobností o chybě pro neúspěšné operace (To se také řídí formátem odpovědi na chybu OData.)
Name | Typ | Description |
---|---|---|
error.additionalInfo |
Další informace o chybě. |
|
error.code |
string |
Kód chyby. |
error.details |
Podrobnosti o chybě. |
|
error.message |
string |
Chybová zpráva. |
error.target |
string |
Cíl chyby. |
CloudErrorBody
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby. |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva. |
target |
string |
Cíl chyby. |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
implementationEffort
Úsilí o implementaci potřebné k nápravě tohoto posouzení
Name | Typ | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Moderate |
string |
PublishDates
Name | Typ | Description |
---|---|---|
GA |
string |
|
public |
string |
SecurityAssessmentMetadataPartnerData
Popisuje partnera, který vytvořil posouzení.
Name | Typ | Description |
---|---|---|
partnerName |
string |
Název společnosti partnera |
productName |
string |
Název produktu partnera, který posouzení vytvořil |
secret |
string |
Tajný kód pro ověření partnera a ověření vytvoření posouzení – pouze zápis |
SecurityAssessmentMetadataResponse
Odpověď na metadata posouzení zabezpečení
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku |
name |
string |
Název prostředku |
properties.assessmentType |
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition |
|
properties.categories |
Kategorie prostředků, které jsou ohroženy, když posouzení není v pořádku |
|
properties.description |
string |
Human readable description of the assessment |
properties.displayName |
string |
Uživatelsky přívětivý zobrazovaný název posouzení |
properties.implementationEffort |
Úsilí o implementaci potřebné k nápravě tohoto posouzení |
|
properties.partnerData |
Popisuje partnera, který vytvořil posouzení. |
|
properties.plannedDeprecationDate |
string |
|
properties.policyDefinitionId |
string |
ID prostředku Azure definice zásady, která tento výpočet posouzení zapne |
properties.preview |
boolean |
Hodnota True, pokud je toto posouzení ve stavu verze Preview |
properties.publishDates | ||
properties.remediationDescription |
string |
Popis toho, co byste měli udělat pro zmírnění tohoto problému se zabezpečením, je čitelný pro člověka |
properties.severity |
Úroveň závažnosti posouzení |
|
properties.tactics |
tactics[] |
Taktika posouzení |
properties.techniques |
Techniky posouzení |
|
properties.threats |
threats[] |
Dopad posouzení na hrozby |
properties.userImpact |
Dopad posouzení na uživatele |
|
type |
string |
Typ prostředku |
severity
Úroveň závažnosti posouzení
Name | Typ | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Medium |
string |
tactics
Name | Typ | 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 | Typ | 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 | Typ | Description |
---|---|---|
accountBreach |
string |
|
dataExfiltration |
string |
|
dataSpillage |
string |
|
denialOfService |
string |
|
elevationOfPrivilege |
string |
|
maliciousInsider |
string |
|
missingCoverage |
string |
|
threatResistance |
string |
userImpact
Dopad posouzení na uživatele
Name | Typ | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Moderate |
string |