Assessments - Get

Referencia

Service:: Defender for Cloud

API Version:: 2020-01-01

Obtención de una evaluación de seguridad en el recurso examinado

GET https://management.azure.com/{resourceId}/providers/Microsoft.Security/assessments/{assessmentName}?api-version=2020-01-01

With optional parameters:

GET https://management.azure.com/{resourceId}/providers/Microsoft.Security/assessments/{assessmentName}?api-version=2020-01-01&$expand={$expand}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
assessmentName	path	True	string	Clave de evaluación: clave única para el tipo de evaluación
resourceId	path	True	string	Identificador del recurso.
api-version	query	True	string	Versión de API para la operación
$expand	query		ExpandEnum	OData expanda. Opcional.

Respuestas

Nombre	Tipo	Description
200 OK	SecurityAssessment	Aceptar
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Get security recommendation task from security data location

Get security recommendation task from security data location with expand parameter

Get security recommendation task from security data location

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2020-01-01

Sample Response

Status code:: 200

{
  "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"
    },
    "additionalData": {
      "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
    }
  }
}

Get security recommendation task from security data location with expand parameter

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/21300918-b2e3-0346-785f-c77ff57d243b?api-version=2020-01-01&$expand=links

Sample Response

Status code:: 200

{
  "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"
    },
    "additionalData": {
      "linkedWorkspaceId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myLaWorkspace"
    },
    "links": {
      "azurePortalUri": "https://www.portal.azure.com/?fea#blade/Microsoft_Azure_Security/RecommendationsBlade/assessmentKey/21300918-b2e3-0346-785f-c77ff57d243b"
    }
  }
}

Definiciones

Nombre	Description
AssessmentLinks	Vínculos relevantes para la evaluación
AssessmentStatus	Resultado de la evaluación
AssessmentStatusCode	Código mediante programación para el estado de la evaluación
assessmentType	BuiltIn si la evaluación basada en la definición de Azure Policy integrada, Personalizada si la evaluación se basa en la definición de Azure Policy personalizada
AzureResourceDetails	Detalles del recurso de Azure que se evaluó
categories
CloudError	Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).
CloudErrorBody	Detalle del error.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ExpandEnum	OData expanda. Opcional.
implementationEffort	El esfuerzo de implementación necesario para corregir esta evaluación
OnPremiseResourceDetails	Detalles del recurso local que se evaluó
OnPremiseSqlResourceDetails	Detalles del recurso de Sql local que se evaluó
SecurityAssessment	Evaluación de seguridad en un recurso
SecurityAssessmentMetadataPartnerData	Describe el asociado que creó la evaluación.
SecurityAssessmentMetadataProperties	Describe las propiedades de los metadatos de una evaluación.
SecurityAssessmentPartnerData	Datos relacionados con la integración de asociados de terceros
severity	Nivel de gravedad de la evaluación
threats
userImpact	Impacto del usuario de la evaluación

AssessmentLinks

Vínculos relevantes para la evaluación

Nombre	Tipo	Description
azurePortalUri	string	Vínculo a la evaluación en Azure Portal

AssessmentStatus

Resultado de la evaluación

Nombre	Tipo	Description
cause	string	Código mediante programación para la causa del estado de evaluación
code	AssessmentStatusCode	Código mediante programación para el estado de la evaluación
description	string	Descripción legible del estado de evaluación

AssessmentStatusCode

Código mediante programación para el estado de la evaluación

Nombre	Tipo	Description
Healthy	string	El recurso está en buen estado
NotApplicable	string	No se ha producido la evaluación de este recurso
Unhealthy	string	El recurso tiene un problema de seguridad que debe solucionarse.

assessmentType

BuiltIn si la evaluación basada en la definición de Azure Policy integrada, Personalizada si la evaluación se basa en la definición de Azure Policy personalizada

Nombre	Tipo	Description
BuiltIn	string	Microsoft Defender de evaluaciones administradas en la nube
CustomPolicy	string	Directivas definidas por el usuario que se ingieren automáticamente de Azure Policy a Microsoft Defender for Cloud
CustomerManaged	string	Evaluaciones de usuarios insertadas directamente por el usuario u otro tercero para Microsoft Defender for Cloud
VerifiedPartner	string	Una evaluación creada por un tercero comprobado si el usuario lo conectó a ASC

AzureResourceDetails

Detalles del recurso de Azure que se evaluó

Nombre	Tipo	Description
id	string	Identificador de recurso de Azure del recurso evaluado
source	string: Azure	Plataforma en la que reside el recurso evaluado

Nombre	Tipo	Description
Compute	string
Data	string
IdentityAndAccess	string
IoT	string
Networking	string

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

Nombre	Tipo	Description
error.additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
error.code	string	Código de error.
error.details	CloudErrorBody[]	Los detalles del error.
error.message	string	El mensaje de error.
error.target	string	Destino del error.

CloudErrorBody

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	CloudErrorBody[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ExpandEnum

OData expanda. Opcional.

Nombre	Tipo	Description
links	string	Todos los vínculos asociados a una evaluación
metadata	string	Metadatos de evaluación

implementationEffort

El esfuerzo de implementación necesario para corregir esta evaluación

Nombre	Tipo	Description
High	string
Low	string
Moderate	string

OnPremiseResourceDetails

Detalles del recurso local que se evaluó

Nombre	Tipo	Description
machineName	string	Nombre de la máquina
source	string: OnPremise	Plataforma en la que reside el recurso evaluado
sourceComputerId	string	El identificador del agente oms instalado en la máquina
vmuuid	string	Identificador único de la máquina
workspaceId	string	Identificador de recurso de Azure del área de trabajo a la que está asociada la máquina

OnPremiseSqlResourceDetails

Detalles del recurso de Sql local que se evaluó

Nombre	Tipo	Description
databaseName	string	El nombre de la base de datos SQL instalado en el equipo
machineName	string	Nombre de la máquina
serverName	string	Nombre del servidor SQL instalado en el equipo
source	string: OnPremiseSql	Plataforma en la que reside el recurso evaluado
sourceComputerId	string	El identificador del agente oms instalado en la máquina
vmuuid	string	Identificador único de la máquina
workspaceId	string	Identificador de recurso de Azure del área de trabajo a la que está asociada la máquina

SecurityAssessment

Evaluación de seguridad en un recurso

Nombre	Tipo	Description
id	string	Id. de recurso
name	string	Nombre del recurso
properties.additionalData	object	Datos adicionales relacionados con la evaluación
properties.displayName	string	Nombre para mostrar descriptivo de la evaluación
properties.links	AssessmentLinks	Vínculos relevantes para la evaluación
properties.metadata	SecurityAssessmentMetadataProperties	Describe las propiedades de los metadatos de una evaluación.
properties.partnersData	SecurityAssessmentPartnerData	Datos relacionados con la integración de asociados de terceros
properties.resourceDetails	ResourceDetails: AzureResourceDetails OnPremiseResourceDetails OnPremiseSqlResourceDetails	Detalles del recurso que se evaluó
properties.status	AssessmentStatus	Resultado de la evaluación
type	string	Tipo de recurso

SecurityAssessmentMetadataPartnerData

Describe el asociado que creó la evaluación.

Nombre	Tipo	Description
partnerName	string	Nombre de la empresa del asociado
productName	string	Nombre del producto del asociado que creó la evaluación
secret	string	Secreto para autenticar al asociado y comprobar que creó la evaluación: solo escritura

SecurityAssessmentMetadataProperties

Describe las propiedades de los metadatos de una evaluación.

Nombre	Tipo	Description
assessmentType	assessmentType	BuiltIn si la evaluación basada en la definición de Azure Policy integrada, Personalizada si la evaluación se basa en la definición de Azure Policy personalizada
categories	categories[]	Categorías de recursos que están en riesgo cuando la evaluación es incorrecta.
description	string	Descripción legible del usuario de la evaluación
displayName	string	Nombre para mostrar descriptivo de la evaluación
implementationEffort	implementationEffort	El esfuerzo de implementación necesario para corregir esta evaluación
partnerData	SecurityAssessmentMetadataPartnerData	Describe el asociado que creó la evaluación.
policyDefinitionId	string	Identificador de recurso de Azure de la definición de directiva que activa este cálculo de evaluación
preview	boolean	True si esta evaluación está en estado de versión preliminar
remediationDescription	string	Descripción legible del usuario de lo que debe hacer para mitigar este problema de seguridad
severity	severity	Nivel de gravedad de la evaluación
threats	threats[]	Impacto en las amenazas de la evaluación
userImpact	userImpact	Impacto del usuario de la evaluación

SecurityAssessmentPartnerData

Datos relacionados con la integración de asociados de terceros

Nombre	Tipo	Description
partnerName	string	Nombre de la empresa del asociado
secret	string	secreto para autenticar al asociado: solo escritura

severity

Nivel de gravedad de la evaluación

Nombre	Tipo	Description
High	string
Low	string
Medium	string

threats

Nombre	Tipo	Description
accountBreach	string
dataExfiltration	string
dataSpillage	string
denialOfService	string
elevationOfPrivilege	string
maliciousInsider	string
missingCoverage	string
threatResistance	string

userImpact

Impacto del usuario de la evaluación

Nombre	Tipo	Description
High	string
Low	string
Moderate	string

Assessments - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Scopes

Ejemplos

Get security recommendation task from security data location

Sample Request

Sample Response

Get security recommendation task from security data location with expand parameter

Sample Request

Sample Response

Definiciones

AssessmentLinks

AssessmentStatus

AssessmentStatusCode

assessmentType

AzureResourceDetails

categories

CloudError

CloudErrorBody

ErrorAdditionalInfo

ExpandEnum

implementationEffort

OnPremiseResourceDetails

OnPremiseSqlResourceDetails

SecurityAssessment

SecurityAssessmentMetadataPartnerData

SecurityAssessmentMetadataProperties

SecurityAssessmentPartnerData

severity

threats

userImpact

Recursos adicionales