Udostępnij za pośrednictwem


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
assessmentMetadataName
path True

string

Klucz oceny — unikatowy klucz dla typu oceny

subscriptionId
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

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.displayName True

string

Przyjazna dla użytkownika nazwa wyświetlana oceny

properties.severity True

severity

Poziom ważności oceny

properties.categories

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

implementationEffort

Wysiłek wdrożeniowy wymagany do skorygowania tej oceny

properties.partnerData

SecurityAssessmentMetadataPartnerData

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

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

techniques[]

Techniki oceny

properties.threats

threats[]

Wpływ oceny na zagrożenia

properties.userImpact

userImpact

Wpływ oceny na użytkownika

Odpowiedzi

Nazwa Typ Opis
200 OK

SecurityAssessmentMetadataResponse

OK

Other Status Codes

CloudError

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
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

categories
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).

CloudErrorBody

Szczegóły błędu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

implementationEffort

Wysiłek wdrożeniowy wymagany do skorygowania tej oceny

PublishDates
SecurityAssessmentMetadataPartnerData

Opisuje partnera, który utworzył ocenę

SecurityAssessmentMetadataResponse

Odpowiedź na metadane oceny zabezpieczeń

severity

Poziom ważności oceny

tactics
techniques
threats
userImpact

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

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

error.code

string

Kod błędu.

error.details

CloudErrorBody[]

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

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

CloudErrorBody[]

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

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

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

implementationEffort

Wysiłek wdrożeniowy wymagany do skorygowania tej oceny

properties.partnerData

SecurityAssessmentMetadataPartnerData

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

PublishDates

properties.remediationDescription

string

Czytelny opis tego, co należy zrobić, aby rozwiązać ten problem z zabezpieczeniami

properties.severity

severity

Poziom ważności oceny

properties.tactics

tactics[]

Taktyka oceny

properties.techniques

techniques[]

Techniki oceny

properties.threats

threats[]

Wpływ oceny na zagrożenia

properties.userImpact

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