Assessments Metadata - List By Subscription
Hämta metadatainformation om alla utvärderingstyper i en specifik prenumeration
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/assessmentMetadata?api-version=2020-01-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Azure-prenumerations-ID Regex pattern: |
api-version
|
query | True |
string |
API-version för åtgärden |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
List security assessment metadata for subscription
Sample Request
GET https://management.azure.com/subscriptions/0980887d-03d6-408c-9566-532f3456804e/providers/Microsoft.Security/assessmentMetadata?api-version=2020-01-01
Sample Response
{
"value": [
{
"id": "/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b",
"name": "21300918-b2e3-0346-785f-c77ff57d243b",
"type": "Microsoft.Security/assessmentMetadata",
"properties": {
"displayName": "Install endpoint protection solution on virtual machine scale sets",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/26a828e1-e88f-464e-bbb3-c134a282b9de",
"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": "BuiltIn"
}
},
{
"id": "/providers/Microsoft.Security/assessmentMetadata/bc303248-3d14-44c2-96a0-55f5c326b5fe",
"name": "bc303248-3d14-44c2-96a0-55f5c326b5fe",
"type": "Microsoft.Security/assessmentMetadata",
"properties": {
"displayName": "Close management ports on your virtual machines",
"policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/22730e10-96f6-4aac-ad84-9383d35b5917",
"description": "Open remote management ports expose your VM to a high level of risk from internet-based attacks that attempt to brute force credentials to gain admin access to the machine.",
"remediationDescription": "We recommend that you edit the inbound rules of the below virtual machines to restrict access to specific source ranges.<br>To restrict the access to your virtual machines: 1. Click on a VM from the list below 2. At the 'Networking' blade, click on each of the rules that allow management ports (e.g. RDP-3389, WINRM-5985, SSH-22) 3. Change the 'Action' property to 'Deny' 4. Click 'Save'",
"categories": [
"Networking"
],
"severity": "Medium",
"userImpact": "High",
"implementationEffort": "Low",
"threats": [
"dataExfiltration",
"dataSpillage",
"maliciousInsider"
],
"preview": true,
"assessmentType": "CustomPolicy"
}
}
]
}
Definitioner
Name | Description |
---|---|
assessment |
BuiltIn om utvärderingen baseras på inbyggd Azure Policy definition, Anpassad om utvärderingen baseras på anpassad Azure Policy definition |
categories | |
Cloud |
Vanliga felsvar för alla Azure Resource Manager API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även OData-felsvarsformatet.). |
Cloud |
Felinformationen. |
Error |
Ytterligare information om resurshanteringsfelet. |
implementation |
Den implementeringsinsats som krävs för att åtgärda den här utvärderingen |
Security |
Metadata för säkerhetsutvärdering |
Security |
Lista över metadata för säkerhetsutvärdering |
Security |
Beskriver partnern som skapade utvärderingen |
severity |
Utvärderingens allvarlighetsgrad |
threats | |
user |
Användarpåverkan av utvärderingen |
assessmentType
BuiltIn om utvärderingen baseras på inbyggd Azure Policy definition, Anpassad om utvärderingen baseras på anpassad Azure Policy definition
Name | Typ | Description |
---|---|---|
BuiltIn |
string |
Microsoft Defender för molnhanterade utvärderingar |
CustomPolicy |
string |
Användardefinierade principer som matas in automatiskt från Azure Policy till Microsoft Defender för molnet |
CustomerManaged |
string |
Användarutvärderingar som skickas direkt av användaren eller någon annan tredje part för att Microsoft Defender för molnet |
VerifiedPartner |
string |
En utvärdering som skapades av en verifierad tredje part om användaren anslöt den till ASC |
categories
Name | Typ | Description |
---|---|---|
Compute |
string |
|
Data |
string |
|
IdentityAndAccess |
string |
|
IoT |
string |
|
Networking |
string |
CloudError
Vanliga felsvar för alla Azure Resource Manager API:er för att returnera felinformation för misslyckade åtgärder. (Detta följer även OData-felsvarsformatet.).
Name | Typ | Description |
---|---|---|
error.additionalInfo |
Ytterligare information om felet. |
|
error.code |
string |
Felkoden. |
error.details |
Felinformationen. |
|
error.message |
string |
Felmeddelandet. |
error.target |
string |
Felmålet. |
CloudErrorBody
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Ytterligare information. |
type |
string |
Den ytterligare informationstypen. |
implementationEffort
Den implementeringsinsats som krävs för att åtgärda den här utvärderingen
Name | Typ | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Moderate |
string |
SecurityAssessmentMetadata
Metadata för säkerhetsutvärdering
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID |
name |
string |
Resursnamn |
properties.assessmentType |
BuiltIn om utvärderingen baseras på inbyggd Azure Policy definition, Anpassad om utvärderingen baseras på anpassad Azure Policy definition |
|
properties.categories |
De resurskategorier som är i riskzonen när utvärderingen inte är felfri |
|
properties.description |
string |
Mänsklig läsbar beskrivning av utvärderingen |
properties.displayName |
string |
Användarvänligt visningsnamn för utvärderingen |
properties.implementationEffort |
Den implementeringsinsats som krävs för att åtgärda den här utvärderingen |
|
properties.partnerData |
Beskriver partnern som skapade utvärderingen |
|
properties.policyDefinitionId |
string |
Azure-resurs-ID för principdefinitionen som aktiverar den här utvärderingsberäkningen |
properties.preview |
boolean |
Sant om den här utvärderingen är i förhandsversionsstatus |
properties.remediationDescription |
string |
Mänsklig läsbar beskrivning av vad du bör göra för att åtgärda det här säkerhetsproblemet |
properties.severity |
Utvärderingens allvarlighetsgrad |
|
properties.threats |
threats[] |
Hotpåverkan av utvärderingen |
properties.userImpact |
Användarpåverkan av utvärderingen |
|
type |
string |
Resurstyp |
SecurityAssessmentMetadataList
Lista över metadata för säkerhetsutvärdering
Name | Typ | Description |
---|---|---|
nextLink |
string |
URI:n för att hämta nästa sida. |
value |
Metadata för säkerhetsutvärdering |
SecurityAssessmentMetadataPartnerData
Beskriver partnern som skapade utvärderingen
Name | Typ | Description |
---|---|---|
partnerName |
string |
Namnet på partnerns företag |
productName |
string |
Namnet på produkten för partnern som skapade utvärderingen |
secret |
string |
Hemlighet för att autentisera partnern och verifiera att den skapade utvärderingen – skriv endast |
severity
Utvärderingens allvarlighetsgrad
Name | Typ | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Medium |
string |
threats
Name | Typ | Description |
---|---|---|
accountBreach |
string |
|
dataExfiltration |
string |
|
dataSpillage |
string |
|
denialOfService |
string |
|
elevationOfPrivilege |
string |
|
maliciousInsider |
string |
|
missingCoverage |
string |
|
threatResistance |
string |
userImpact
Användarpåverkan av utvärderingen
Name | Typ | Description |
---|---|---|
High |
string |
|
Low |
string |
|
Moderate |
string |