Assessments Metadata - Create In Subscription
Tworzenie informacji o metadanych dotyczących typu oceny w określonej subskrypcji
PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/assessmentMetadata/{assessmentMetadataName}?api-version=2021-06-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
assessment
|
path | True |
string |
Klucz oceny — unikatowy klucz dla typu oceny |
subscription
|
path | True |
string pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$ |
Identyfikator subskrypcji platformy Azure |
api-version
|
query | True |
string |
Wersja interfejsu API dla operacji |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
properties.assessmentType | True |
BuiltIn, jeśli ocena oparta na wbudowanej definicji usługi Azure Policy, niestandardowy, jeśli ocena jest oparta na niestandardowej definicji usługi Azure Policy |
|
properties.displayName | True |
string |
Przyjazna dla użytkownika nazwa wyświetlana oceny |
properties.severity | True |
Poziom ważności oceny |
|
properties.categories |
Kategorie zasobów, które są zagrożone, gdy ocena jest w złej kondycji |
||
properties.description |
string |
Czytelny opis oceny przez człowieka |
|
properties.implementationEffort |
Wysiłek wdrożeniowy wymagany do skorygowania tej oceny |
||
properties.partnerData |
Opisuje partnera, który utworzył ocenę |
||
properties.plannedDeprecationDate |
string pattern: ^[0-9]{2}/[0-9]{4}$ |
||
properties.preview |
boolean |
Prawda, jeśli ta ocena ma stan wersji zapoznawczej |
|
properties.publishDates | |||
properties.remediationDescription |
string |
Czytelny opis tego, co należy zrobić, aby rozwiązać ten problem z zabezpieczeniami |
|
properties.tactics |
tactics[] |
Taktyka oceny |
|
properties.techniques |
Techniki oceny |
||
properties.threats |
threats[] |
Wpływ oceny na zagrożenia |
|
properties.userImpact |
Wpływ oceny na użytkownika |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ protokołu OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Create security assessment metadata for subscription
Przykładowe żądanie
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"
}
}
Przykładowa odpowiedź
{
"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"
}
}
Definicje
Nazwa | Opis |
---|---|
assessment |
BuiltIn, jeśli ocena oparta na wbudowanej definicji usługi Azure Policy, niestandardowy, jeśli ocena jest oparta na niestandardowej definicji usługi Azure Policy |
categories | |
Cloud |
Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData). |
Cloud |
Szczegóły błędu. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
implementation |
Wysiłek wdrożeniowy wymagany do skorygowania tej oceny |
Publish |
|
Security |
Opisuje partnera, który utworzył ocenę |
Security |
Odpowiedź na metadane oceny zabezpieczeń |
severity |
Poziom ważności oceny |
tactics | |
techniques | |
threats | |
user |
Wpływ oceny na użytkownika |
assessmentType
BuiltIn, jeśli ocena oparta na wbudowanej definicji usługi Azure Policy, niestandardowy, jeśli ocena jest oparta na niestandardowej definicji usługi Azure Policy
Wartość | Opis |
---|---|
BuiltIn |
Oceny zarządzane przez usługę Microsoft Defender for Cloud |
CustomPolicy |
Zasady zdefiniowane przez użytkownika, które są automatycznie pozyskiwane z usługi Azure Policy do usługi Microsoft Defender for Cloud |
CustomerManaged |
Oceny użytkowników wypychane bezpośrednio przez użytkownika lub inną firmę do usługi Microsoft Defender for Cloud |
VerifiedPartner |
Ocena utworzona przez zweryfikowaną inną firmę, jeśli użytkownik połączył ją z usługą ASC |
categories
Wartość | Opis |
---|---|
Compute | |
Data | |
IdentityAndAccess | |
IoT | |
Networking |
CloudError
Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).
Nazwa | Typ | Opis |
---|---|---|
error.additionalInfo |
Dodatkowe informacje o błędzie. |
|
error.code |
string |
Kod błędu. |
error.details |
Szczegóły błędu. |
|
error.message |
string |
Komunikat o błędzie. |
error.target |
string |
Element docelowy błędu. |
CloudErrorBody
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
implementationEffort
Wysiłek wdrożeniowy wymagany do skorygowania tej oceny
Wartość | Opis |
---|---|
High | |
Low | |
Moderate |
PublishDates
Nazwa | Typ | Opis |
---|---|---|
GA |
string pattern: ^([0-9]{2}/){2}[0-9]{4}$ |
|
public |
string pattern: ^([0-9]{2}/){2}[0-9]{4}$ |
SecurityAssessmentMetadataPartnerData
Opisuje partnera, który utworzył ocenę
Nazwa | Typ | Opis |
---|---|---|
partnerName |
string |
Nazwa firmy partnera |
productName |
string |
Nazwa produktu partnera, który utworzył ocenę |
secret |
string |
Wpis tajny umożliwiający uwierzytelnienie partnera i zweryfikowanie utworzenia oceny — tylko zapis |
SecurityAssessmentMetadataResponse
Odpowiedź na metadane oceny zabezpieczeń
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu |
name |
string |
Nazwa zasobu |
properties.assessmentType |
BuiltIn, jeśli ocena oparta na wbudowanej definicji usługi Azure Policy, niestandardowy, jeśli ocena jest oparta na niestandardowej definicji usługi Azure Policy |
|
properties.categories |
Kategorie zasobów, które są zagrożone, gdy ocena jest w złej kondycji |
|
properties.description |
string |
Czytelny opis oceny przez człowieka |
properties.displayName |
string |
Przyjazna dla użytkownika nazwa wyświetlana oceny |
properties.implementationEffort |
Wysiłek wdrożeniowy wymagany do skorygowania tej oceny |
|
properties.partnerData |
Opisuje partnera, który utworzył ocenę |
|
properties.plannedDeprecationDate |
string pattern: ^[0-9]{2}/[0-9]{4}$ |
|
properties.policyDefinitionId |
string |
Identyfikator zasobu platformy Azure definicji zasad, która włącza to obliczenie oceny |
properties.preview |
boolean |
Prawda, jeśli ta ocena ma stan wersji zapoznawczej |
properties.publishDates | ||
properties.remediationDescription |
string |
Czytelny opis tego, co należy zrobić, aby rozwiązać ten problem z zabezpieczeniami |
properties.severity |
Poziom ważności oceny |
|
properties.tactics |
tactics[] |
Taktyka oceny |
properties.techniques |
Techniki oceny |
|
properties.threats |
threats[] |
Wpływ oceny na zagrożenia |
properties.userImpact |
Wpływ oceny na użytkownika |
|
type |
string |
Typ zasobu |
severity
Poziom ważności oceny
Wartość | Opis |
---|---|
High | |
Low | |
Medium |
tactics
Wartość | Opis |
---|---|
Collection | |
Command and Control | |
Credential Access | |
Defense Evasion | |
Discovery | |
Execution | |
Exfiltration | |
Impact | |
Initial Access | |
Lateral Movement | |
Persistence | |
Privilege Escalation | |
Reconnaissance | |
Resource Development |
techniques
Wartość | Opis |
---|---|
Abuse Elevation Control Mechanism | |
Access Token Manipulation | |
Account Discovery | |
Account Manipulation | |
Active Scanning | |
Application Layer Protocol | |
Audio Capture | |
Boot or Logon Autostart Execution | |
Boot or Logon Initialization Scripts | |
Brute Force | |
Cloud Infrastructure Discovery | |
Cloud Service Dashboard | |
Cloud Service Discovery | |
Command and Scripting Interpreter | |
Compromise Client Software Binary | |
Compromise Infrastructure | |
Container and Resource Discovery | |
Create Account | |
Create or Modify System Process | |
Credentials from Password Stores | |
Data Destruction | |
Data Encrypted for Impact | |
Data Manipulation | |
Data Staged | |
Data from Cloud Storage Object | |
Data from Configuration Repository | |
Data from Information Repositories | |
Data from Local System | |
Defacement | |
Deobfuscate/Decode Files or Information | |
Disk Wipe | |
Domain Trust Discovery | |
Drive-by Compromise | |
Dynamic Resolution | |
Endpoint Denial of Service | |
Event Triggered Execution | |
Exfiltration Over Alternative Protocol | |
Exploit Public-Facing Application | |
Exploitation for Client Execution | |
Exploitation for Credential Access | |
Exploitation for Defense Evasion | |
Exploitation for Privilege Escalation | |
Exploitation of Remote Services | |
External Remote Services | |
Fallback Channels | |
File and Directory Discovery | |
File and Directory Permissions Modification | |
Gather Victim Network Information | |
Hide Artifacts | |
Hijack Execution Flow | |
Impair Defenses | |
Implant Container Image | |
Indicator Removal on Host | |
Indirect Command Execution | |
Ingress Tool Transfer | |
Input Capture | |
Inter-Process Communication | |
Lateral Tool Transfer | |
Man-in-the-Middle | |
Masquerading | |
Modify Authentication Process | |
Modify Registry | |
Network Denial of Service | |
Network Service Scanning | |
Network Sniffing | |
Non-Application Layer Protocol | |
Non-Standard Port | |
OS Credential Dumping | |
Obfuscated Files or Information | |
Obtain Capabilities | |
Office Application Startup | |
Permission Groups Discovery | |
Phishing | |
Pre-OS Boot | |
Process Discovery | |
Process Injection | |
Protocol Tunneling | |
Proxy | |
Query Registry | |
Remote Access Software | |
Remote Service Session Hijacking | |
Remote Services | |
Remote System Discovery | |
Resource Hijacking | |
SQL Stored Procedures | |
Scheduled Task/Job | |
Screen Capture | |
Search Victim-Owned Websites | |
Server Software Component | |
Service Stop | |
Signed Binary Proxy Execution | |
Software Deployment Tools | |
Steal or Forge Kerberos Tickets | |
Subvert Trust Controls | |
Supply Chain Compromise | |
System Information Discovery | |
Taint Shared Content | |
Traffic Signaling | |
Transfer Data to Cloud Account | |
Trusted Relationship | |
Unsecured Credentials | |
User Execution | |
Valid Accounts | |
Windows Management Instrumentation |
threats
Wartość | Opis |
---|---|
accountBreach | |
dataExfiltration | |
dataSpillage | |
denialOfService | |
elevationOfPrivilege | |
maliciousInsider | |
missingCoverage | |
threatResistance |
userImpact
Wpływ oceny na użytkownika
Wartość | Opis |
---|---|
High | |
Low | |
Moderate |