Assessments - List
Ottenere valutazioni della sicurezza su tutte le risorse analizzate all'interno di un ambito
GET https://management.azure.com/{scope}/providers/Microsoft.Security/assessments?api-version=2021-06-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
scope
|
path | True |
string |
L'ambito della query può essere una sottoscrizione (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) o un gruppo di gestione (/providers/Microsoft.Management/managementGroups/mgName). |
api-version
|
query | True |
string |
Versione dell'API per l'operazione |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
List security assessments
Esempio di richiesta
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/assessments?api-version=2021-06-01
Risposta di esempio
{
"value": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
"name": "21300918-b2e3-0346-785f-c77ff57d243b",
"type": "Microsoft.Security/assessments",
"properties": {
"resourceDetails": {
"source": "Azure",
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1"
},
"displayName": "Install endpoint protection solution on virtual machine scale sets",
"status": {
"code": "Healthy",
"statusChangeDate": "2021-04-12T09:07:18.6759138Z",
"firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
}
}
},
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b",
"name": "21300918-b2e3-0346-785f-c77ff57d243b",
"type": "Microsoft.Security/assessments",
"properties": {
"resourceDetails": {
"source": "Azure",
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2"
},
"displayName": "Install endpoint protection solution on virtual machine scale sets",
"status": {
"code": "NotApplicable",
"cause": "OffByPolicy",
"description": "The effective policy for the assessment was evaluated to off - use Microsoft.Authorization/policyAssignments to turn this assessment on",
"statusChangeDate": "2021-04-12T09:07:18.6759138Z",
"firstEvaluationDate": "2021-04-12T09:07:18.6759138Z"
},
"additionalData": {
"linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
}
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Assessment |
Collegamenti pertinenti alla valutazione |
Assessment |
Codice programmatico per lo stato della valutazione |
Assessment |
Risultato della valutazione |
assessment |
BuiltIn se la valutazione basata sulla definizione predefinita di Criteri di Azure, personalizzata se la valutazione basata sulla definizione personalizzata di Criteri di Azure |
Azure |
Dettagli della risorsa di Azure valutata |
categories | |
Cloud |
Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData. |
Cloud |
Dettagli dell'errore. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
implementation |
Il lavoro di implementazione necessario per correggere questa valutazione |
On |
Dettagli della risorsa locale valutata |
On |
Dettagli della risorsa SQL locale valutata |
Security |
Pagina di un elenco di valutazioni della sicurezza |
Security |
Descrive il partner che ha creato la valutazione |
Security |
Descrive le proprietà di un metadati di valutazione. |
Security |
Dati relativi all'integrazione di partner di terze parti |
Security |
Valutazione della sicurezza in una risorsa - Formato di risposta |
severity |
Livello di gravità della valutazione |
threats | |
user |
Impatto dell'utente della valutazione |
AssessmentLinks
Collegamenti pertinenti alla valutazione
Nome | Tipo | Descrizione |
---|---|---|
azurePortalUri |
string |
Collegamento alla valutazione nel portale di Azure |
AssessmentStatusCode
Codice programmatico per lo stato della valutazione
Nome | Tipo | Descrizione |
---|---|---|
Healthy |
string |
La risorsa è integra |
NotApplicable |
string |
La valutazione per questa risorsa non è stata eseguita |
Unhealthy |
string |
La risorsa presenta un problema di sicurezza che deve essere risolto |
AssessmentStatusResponse
Risultato della valutazione
Nome | Tipo | Descrizione |
---|---|---|
cause |
string |
Codice programmatico per la causa dello stato di valutazione |
code |
Codice programmatico per lo stato della valutazione |
|
description |
string |
Descrizione leggibile dello stato di valutazione |
firstEvaluationDate |
string |
Ora in cui la valutazione è stata creata e valutata per la prima volta. Restituito come ora UTC nel formato ISO 8601 |
statusChangeDate |
string |
Ora dell'ultima modifica dello stato della valutazione. Restituito come ora UTC nel formato ISO 8601 |
assessmentType
BuiltIn se la valutazione basata sulla definizione predefinita di Criteri di Azure, personalizzata se la valutazione basata sulla definizione personalizzata di Criteri di Azure
Nome | Tipo | Descrizione |
---|---|---|
BuiltIn |
string |
Valutazioni gestite da Microsoft Defender for Cloud |
CustomPolicy |
string |
Criteri definiti dall'utente inseriti automaticamente da Criteri di Azure a Microsoft Defender for Cloud |
CustomerManaged |
string |
Valutazioni utente inoltrate direttamente dall'utente o da altre terze parti a Microsoft Defender for Cloud |
VerifiedPartner |
string |
Valutazione creata da una terza parte verificata se l'utente lo ha connesso al Centro sicurezza di Azure |
AzureResourceDetails
Dettagli della risorsa di Azure valutata
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa di Azure della risorsa valutata |
source |
string:
Azure |
Piattaforma in cui risiede la risorsa valutata |
categories
Nome | Tipo | Descrizione |
---|---|---|
Compute |
string |
|
Data |
string |
|
IdentityAndAccess |
string |
|
IoT |
string |
|
Networking |
string |
CloudError
Risposta di errore comune per tutte le API di Azure Resource Manager per restituire i dettagli dell'errore per le operazioni non riuscite. Questo segue anche il formato di risposta di errore OData.
Nome | Tipo | Descrizione |
---|---|---|
error.additionalInfo |
Informazioni aggiuntive sull'errore. |
|
error.code |
string |
Codice di errore. |
error.details |
Dettagli dell'errore. |
|
error.message |
string |
Messaggio di errore. |
error.target |
string |
Destinazione dell'errore. |
CloudErrorBody
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
implementationEffort
Il lavoro di implementazione necessario per correggere questa valutazione
Nome | Tipo | Descrizione |
---|---|---|
High |
string |
|
Low |
string |
|
Moderate |
string |
OnPremiseResourceDetails
Dettagli della risorsa locale valutata
Nome | Tipo | Descrizione |
---|---|---|
machineName |
string |
Nome del computer |
source |
string:
On |
Piattaforma in cui risiede la risorsa valutata |
sourceComputerId |
string |
ID agente oms installato nel computer |
vmuuid |
string |
ID univoco del computer |
workspaceId |
string |
ID risorsa di Azure dell'area di lavoro a cui è collegato il computer |
OnPremiseSqlResourceDetails
Dettagli della risorsa SQL locale valutata
Nome | Tipo | Descrizione |
---|---|---|
databaseName |
string |
Nome del database Sql installato nel computer |
machineName |
string |
Nome del computer |
serverName |
string |
Nome sql server installato nel computer |
source |
string:
On |
Piattaforma in cui risiede la risorsa valutata |
sourceComputerId |
string |
ID agente oms installato nel computer |
vmuuid |
string |
ID univoco del computer |
workspaceId |
string |
ID risorsa di Azure dell'area di lavoro a cui è collegato il computer |
SecurityAssessmentList
Pagina di un elenco di valutazioni della sicurezza
Nome | Tipo | Descrizione |
---|---|---|
nextLink |
string |
URI da recuperare la pagina successiva. |
value |
Raccolta di valutazioni della sicurezza in questa pagina |
SecurityAssessmentMetadataPartnerData
Descrive il partner che ha creato la valutazione
Nome | Tipo | Descrizione |
---|---|---|
partnerName |
string |
Nome della società del partner |
productName |
string |
Nome del prodotto del partner che ha creato la valutazione |
secret |
string |
Segreto per autenticare il partner e verificarne la creazione: solo scrittura |
SecurityAssessmentMetadataProperties
Descrive le proprietà di un metadati di valutazione.
Nome | Tipo | Descrizione |
---|---|---|
assessmentType |
BuiltIn se la valutazione basata sulla definizione predefinita di Criteri di Azure, personalizzata se la valutazione basata sulla definizione personalizzata di Criteri di Azure |
|
categories |
Categorie di risorse a rischio quando la valutazione non è integra |
|
description |
string |
Descrizione leggibile della valutazione |
displayName |
string |
Nome visualizzato descrittivo della valutazione |
implementationEffort |
Il lavoro di implementazione necessario per correggere questa valutazione |
|
partnerData |
Descrive il partner che ha creato la valutazione |
|
policyDefinitionId |
string |
ID risorsa di Azure della definizione dei criteri che attiva il calcolo della valutazione |
preview |
boolean |
True se la valutazione è in stato di versione di anteprima |
remediationDescription |
string |
Descrizione leggibile delle operazioni da eseguire per attenuare questo problema di sicurezza |
severity |
Livello di gravità della valutazione |
|
threats |
threats[] |
Impatto sulle minacce della valutazione |
userImpact |
Impatto dell'utente della valutazione |
SecurityAssessmentPartnerData
Dati relativi all'integrazione di partner di terze parti
Nome | Tipo | Descrizione |
---|---|---|
partnerName |
string |
Nome della società del partner |
secret |
string |
segreto per autenticare il partner : solo scrittura |
SecurityAssessmentResponse
Valutazione della sicurezza in una risorsa - Formato di risposta
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa |
name |
string |
Nome risorsa |
properties.additionalData |
object |
Dati aggiuntivi relativi alla valutazione |
properties.displayName |
string |
Nome visualizzato descrittivo della valutazione |
properties.links |
Collegamenti pertinenti alla valutazione |
|
properties.metadata |
Descrive le proprietà di un metadati di valutazione. |
|
properties.partnersData |
Dati relativi all'integrazione di partner di terze parti |
|
properties.resourceDetails | ResourceDetails: |
Dettagli della risorsa valutata |
properties.status |
Risultato della valutazione |
|
type |
string |
Tipo di risorsa |
severity
Livello di gravità della valutazione
Nome | Tipo | Descrizione |
---|---|---|
High |
string |
|
Low |
string |
|
Medium |
string |
threats
Nome | Tipo | Descrizione |
---|---|---|
accountBreach |
string |
|
dataExfiltration |
string |
|
dataSpillage |
string |
|
denialOfService |
string |
|
elevationOfPrivilege |
string |
|
maliciousInsider |
string |
|
missingCoverage |
string |
|
threatResistance |
string |
userImpact
Impatto dell'utente della valutazione
Nome | Tipo | Descrizione |
---|---|---|
High |
string |
|
Low |
string |
|
Moderate |
string |