Partilhar via

Sub Assessments - List All

  • Referência
Serviço:
Defender for Cloud
Versão da API:
2019-01-01-preview

Obtenha subavaliações de segurança em todos os seus recursos digitalizados dentro de um escopo de assinatura

GET https://management.azure.com/{scope}/providers/Microsoft.Security/subAssessments?api-version=2019-01-01-preview

Parâmetros do URI

Name Em Necessário Tipo Description
scope
 path True

string

O escopo da consulta pode ser assinatura (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) ou grupo de gerenciamento (/providers/Microsoft.Management/managementGroups/mgName).
api-version
 query True

string

Versão da API para a operação

Respostas

Name Tipo Description
200 OK

SecuritySubAssessmentList

OK
Other Status Codes

CloudError

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

List security sub-assessments

Pedido de amostra

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/subAssessments?api-version=2019-01-01-preview

Resposta da amostra

Código de estado:
200 
{
  "value": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.ContainerRegistry/registries/myRegistry/providers/Microsoft.Security/assessments/dbd0cb49-b563-45e7-9724-889e799fa648/subAssessments/8c98f353-8b41-4e77-979b-6adeecd5d168",
      "name": "8c98f353-8b41-4e77-979b-6adeecd5d168",
      "type": "Microsoft.Security/assessments/subAssessments",
      "properties": {
        "displayName": "'Back Orifice' Backdoor",
        "id": "1001",
        "status": {
          "code": "Unhealthy",
          "cause": "",
          "severity": "High",
          "description": "The resource is unhealthy"
        },
        "resourceDetails": {
          "source": "Azure",
          "id": "repositories/asc/msi-connector/images/sha256:877a6f2a212c44021281f80cb1f4c73a09dce4e99a8cb8efcc03f7ce3c877a6f"
        },
        "remediation": "Use a recent anti-virus program to remove this backdoor and check your system regularly with anti-virus software.",
        "impact": "3",
        "category": "Backdoors and trojan horses",
        "description": "The backdoor 'Back Orifice' was detected on this system.  The presence of this backdoor indicates that your system has already been compromised.  Unauthorized users can access your host at any time. Unauthorized users can take complete control of the host and manipulate data.  They can steal the data or even wipe out the host.",
        "timeGenerated": "2019-06-23T12:20:08.7644808Z",
        "additionalData": {
          "assessedResourceType": "ContainerRegistryVulnerability",
          "imageDigest": "c186fc44-3154-4ce2-ba18-b719d895c3b0",
          "repositoryName": "myRepo",
          "type": "Vulnerability",
          "cvss": {
            "2.0": {
              "base": 10
            },
            "3.0": {
              "base": 10
            }
          },
          "patchable": true,
          "cve": [
            {
              "title": "CVE-2019-12345",
              "link": "http://contoso.com"
            }
          ],
          "publishedTime": "2018-01-01T00:00:00.0000000Z",
          "vendorReferences": [
            {
              "title": "Reference_1",
              "link": "http://contoso.com"
            }
          ]
        }
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/ascdemoRG/providers/Microsoft.Sql/servers/sqlserver1demo/providers/Microsoft.Security/assessments/82e20e14-edc5-4373-bfc4-f13121257c37/subassessments/8fbe5054-e97c-3a7a-fda7-c8308ca8d3cf",
      "name": "8fbe5054-e97c-3a7a-fda7-c8308ca8d3cf",
      "type": "Microsoft.Security/assessments/subAssessments",
      "properties": {
        "id": "VA2064",
        "displayName": "Database-level firewall rules should be tracked and maintained at a strict minimum",
        "status": {
          "code": "Healthy",
          "severity": "High",
          "cause": "Unknown"
        },
        "remediation": "Evaluate each of the database-level firewall rules. Remove any rules that grant unnecessary access and set the rest as a baseline. Deviations from the baseline will be identified and brought to your attention in subsequent scans.",
        "impact": "Firewall rules should be strictly configured to allow access only to client computers that have a valid need to connect to the database. Any superfluous entries in the firewall may pose a threat by allowing an unauthorized source access to your database.",
        "category": "SurfaceAreaReduction",
        "description": "The Azure SQL Database-level firewall helps protect your data by preventing all access to your database until you specify which IP addresses have permission. Database-level firewall rules grant access to the specific database based on the originating IP address of each request.\n\nDatabase-level firewall rules for master",
        "timeGenerated": "2019-06-23T12:20:08.7644808Z",
        "resourceDetails": {
          "source": "Azure",
          "id": "/subscriptions/212f9889-769e-45ae-ab43-6da33674bd26/resourceGroups/ascdemoRG/providers/Microsoft.Sql/servers/sqlserver1demo/databases/database1"
        },
        "additionalData": {
          "assessedResourceType": "SqlServerVulnerability",
          "type": "AzureDatabase",
          "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.database_firewall_rules",
          "benchmarks": []
        }
      }
    }
  ]
}

Definições

Name Description
AzureResourceDetails

Detalhes do recurso do Azure que foi avaliado
CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)
CloudErrorBody

O detalhe do erro.
ContainerRegistryVulnerabilityProperties

Campos de contexto adicionais para registro de contêiner Avaliação de vulnerabilidade
CVE

Detalhes CVE
CVSS

Detalhes do CVSS
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.
OnPremiseResourceDetails

Detalhes do recurso On Premise que foi avaliado
OnPremiseSqlResourceDetails

Detalhes do recurso On Premise Sql que foi avaliado
SecuritySubAssessment

Subavaliação de segurança em um recurso
SecuritySubAssessmentList

Lista de subavaliações de segurança
ServerVulnerabilityProperties

Campos de contexto adicionais para avaliação de vulnerabilidade do servidor
severity

O nível de gravidade da subavaliação
SqlServerVulnerabilityProperties

Detalhes do recurso que foi avaliado
SubAssessmentStatus

Situação da subavaliação
SubAssessmentStatusCode

Código programático para o estado da avaliação
VendorReference

Referência do fornecedor

AzureResourceDetails

Detalhes do recurso do Azure que foi avaliado

Name Tipo Description
id

string

ID do recurso do Azure do recurso avaliado
source string:

Azure

A plataforma onde reside o recurso avaliado

CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

Name Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
error.code

string

O código de erro.
error.details

CloudErrorBody[]

Os detalhes do erro.
error.message

string

A mensagem de erro.
error.target

string

O destino do erro.

CloudErrorBody

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

O código de erro.
details

CloudErrorBody[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ContainerRegistryVulnerabilityProperties

Campos de contexto adicionais para registro de contêiner Avaliação de vulnerabilidade

Name Tipo Description
assessedResourceType string:

ContainerRegistryVulnerability

Tipo de recurso de subavaliação
cve

CVE[]

Lista de CVEs
cvss

<string,  CVSS>

Dicionário da versão cvss para o objeto cvss details
imageDigest

string

Resumo da imagem vulnerável
patchable

boolean

Indica se um patch está disponível ou não
publishedTime

string

Hora de publicação
repositoryName

string

Nome do repositório ao qual a imagem vulnerável pertence
type

string

Tipo de vulnerabilidade. Por exemplo: Vulnerabilidade, Vulnerabilidade potencial, Informações recolhidas, Vulnerabilidade
vendorReferences

VendorReference[]

Referência do fornecedor

CVE

Detalhes CVE

Name Tipo Description
link

string

URL do link
title

string

Título CVE

CVSS

Detalhes do CVSS

Name Tipo Description
base

number

Base CVSS

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

OnPremiseResourceDetails

Detalhes do recurso On Premise que foi avaliado

Name Tipo Description
machineName

string

O nome da máquina
source string:

OnPremise

A plataforma onde reside o recurso avaliado
sourceComputerId

string

O ID do agente oms instalado na máquina
vmuuid

string

O ID único da máquina
workspaceId

string

ID do recurso do Azure do espaço de trabalho ao qual a máquina está anexada

OnPremiseSqlResourceDetails

Detalhes do recurso On Premise Sql que foi avaliado

Name Tipo Description
databaseName

string

O nome do banco de dados Sql instalado na máquina
machineName

string

O nome da máquina
serverName

string

O nome do servidor Sql instalado na máquina
source string:

OnPremiseSql

A plataforma onde reside o recurso avaliado
sourceComputerId

string

O ID do agente oms instalado na máquina
vmuuid

string

O ID único da máquina
workspaceId

string

ID do recurso do Azure do espaço de trabalho ao qual a máquina está anexada

SecuritySubAssessment

Subavaliação de segurança em um recurso

Name Tipo Description
id

string

ID do recurso
name

string

Nome do recurso
properties.additionalData AdditionalData:

Pormenores da subavaliação
properties.category

string

Categoria da subavaliação
properties.description

string

Descrição legível por humanos do estado da avaliação
properties.displayName

string

Nome de visualização convivial da subavaliação
properties.id

string

ID da vulnerabilidade
properties.impact

string

Descrição do impacto desta subavaliação
properties.remediation

string

Informações sobre como corrigir esta subavaliação
properties.resourceDetails ResourceDetails:

Detalhes do recurso que foi avaliado
properties.status

SubAssessmentStatus

Situação da subavaliação
properties.timeGenerated

string

Data e hora em que a subavaliação foi gerada
type

string

Tipo de recurso

SecuritySubAssessmentList

Lista de subavaliações de segurança

Name Tipo Description
nextLink

string

O URI para buscar a próxima página.
value

SecuritySubAssessment[]

Subavaliação de segurança em um recurso

ServerVulnerabilityProperties

Campos de contexto adicionais para avaliação de vulnerabilidade do servidor

Name Tipo Description
assessedResourceType string:

ServerVulnerabilityAssessment

Tipo de recurso de subavaliação
cve

CVE[]

Lista de CVEs
cvss

<string,  CVSS>

Dicionário da versão cvss para o objeto cvss details
patchable

boolean

Indica se um patch está disponível ou não
publishedTime

string

Hora de publicação
threat

string

Nome da ameaça
type

string

Tipo de vulnerabilidade. Por exemplo: vulnerabilidade, vulnerabilidade potencial, informações recolhidas
vendorReferences

VendorReference[]

Referência do fornecedor

severity

O nível de gravidade da subavaliação

Name Tipo Description
High

string

Low

string

Medium

string

SqlServerVulnerabilityProperties

Detalhes do recurso que foi avaliado

Name Tipo Description
assessedResourceType string:

SqlServerVulnerability

Tipo de recurso de subavaliação
query

string

A consulta T-SQL que é executada em seu banco de dados SQL para executar a verificação específica
type

string

O tipo de recurso ao qual a subavaliação se refere em seus detalhes de recurso

SubAssessmentStatus

Situação da subavaliação

Name Tipo Description
cause

string

Código programático para a causa do estado de avaliação
code

SubAssessmentStatusCode

Código programático para o estado da avaliação
description

string

Descrição legível por humanos do estado da avaliação
severity

severity

O nível de gravidade da subavaliação

SubAssessmentStatusCode

Código programático para o estado da avaliação

Name Tipo Description
Healthy

string

O recurso é saudável
NotApplicable

string

A avaliação para este recurso não aconteceu
Unhealthy

string

O recurso tem um problema de segurança que precisa ser resolvido

VendorReference

Referência do fornecedor

Name Tipo Description
link

string

URL do link
title

string

Título do link