Compartilhar via

Sub Assessments - List All

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

Obter subavalidades de segurança em todos os recursos verificados dentro de um escopo de assinatura

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

Parâmetros de URI

Nome Em Obrigató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

Nome Tipo Description
200 OK

SecuritySubAssessmentList

OKEY
Other Status Codes

CloudError

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

List security sub-assessments

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Nome Description
AzureResourceDetails

Detalhes do recurso do Azure que foi avaliado
CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem 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 avaliação de vulnerabilidade do registro de contêiner
CVE

Detalhes da CVE
CVSS

Detalhes do CVSS
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
OnPremiseResourceDetails

Detalhes do recurso Local que foi avaliado
OnPremiseSqlResourceDetails

Detalhes do recurso sql local que foi avaliado
SecuritySubAssessment

Subavalidade de segurança em um recurso
SecuritySubAssessmentList

Lista de subavalizações de segurança
ServerVulnerabilityProperties

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

O nível de gravidade da subavalidade
SqlServerVulnerabilityProperties

Detalhes do recurso que foi avaliado
SubAssessmentStatus

Status da subavalização
SubAssessmentStatusCode

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

Referência do fornecedor

AzureResourceDetails

Detalhes do recurso do Azure que foi avaliado

Nome Tipo Description
id

string

ID de recurso do Azure do recurso avaliado
source string:

Azure

A plataforma em que o recurso avaliado reside

CloudError

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

Nome Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
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.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
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 avaliação de vulnerabilidade do registro de contêiner

Nome Tipo Description
assessedResourceType string:

ContainerRegistryVulnerability

Tipo de recurso de subavalização
cve

CVE[]

Lista de CVEs
cvss

<string,  CVSS>

Dicionário da versão cvss para o objeto de detalhes cvss
imageDigest

string

Resumo da imagem vulnerável
patchable

boolean

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

string

Hora da 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 coletadas, vulnerabilidade
vendorReferences

VendorReference[]

Referência do fornecedor

CVE

Detalhes da CVE

Nome Tipo Description
link

string

URL do link
title

string

Título CVE

CVSS

Detalhes do CVSS

Nome Tipo Description
base

number

Base cvss

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

OnPremiseResourceDetails

Detalhes do recurso Local que foi avaliado

Nome Tipo Description
machineName

string

O nome do computador
source string:

OnPremise

A plataforma em que o recurso avaliado reside
sourceComputerId

string

A ID do agente oms instalada no computador
vmuuid

string

A ID exclusiva do computador
workspaceId

string

ID de recurso do Azure do workspace ao qual o computador está anexado

OnPremiseSqlResourceDetails

Detalhes do recurso sql local que foi avaliado

Nome Tipo Description
databaseName

string

O nome do banco de dados Sql instalado no computador
machineName

string

O nome do computador
serverName

string

O nome do Sql Server instalado no computador
source string:

OnPremiseSql

A plataforma em que o recurso avaliado reside
sourceComputerId

string

A ID do agente oms instalada no computador
vmuuid

string

A ID exclusiva do computador
workspaceId

string

ID de recurso do Azure do workspace ao qual o computador está anexado

SecuritySubAssessment

Subavalidade de segurança em um recurso

Nome Tipo Description
id

string

ID do recurso
name

string

Nome do recurso
properties.additionalData AdditionalData:

Detalhes da subavalidade
properties.category

string

Categoria da subavaria
properties.description

string

Descrição legível humana do status da avaliação
properties.displayName

string

Nome de exibição amigável da subavalidade
properties.id

string

ID de vulnerabilidade
properties.impact

string

Descrição do impacto dessa subavalidade
properties.remediation

string

Informações sobre como corrigir essa subavalidade
properties.resourceDetails ResourceDetails:

Detalhes do recurso que foi avaliado
properties.status

SubAssessmentStatus

Status da subavalização
properties.timeGenerated

string

A data e a hora em que a subavalização foi gerada
type

string

Tipo de recurso

SecuritySubAssessmentList

Lista de subavalizações de segurança

Nome Tipo Description
nextLink

string

O URI a ser buscado na próxima página.
value

SecuritySubAssessment[]

Subavalidade de segurança em um recurso

ServerVulnerabilityProperties

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

Nome Tipo Description
assessedResourceType string:

ServerVulnerabilityAssessment

Tipo de recurso de subavalização
cve

CVE[]

Lista de CVEs
cvss

<string,  CVSS>

Dicionário da versão cvss para o objeto de detalhes cvss
patchable

boolean

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

string

Hora da publicação
threat

string

Nome da ameaça
type

string

Tipo de vulnerabilidade. por exemplo: vulnerabilidade, vulnerabilidade potencial, informações coletadas
vendorReferences

VendorReference[]

Referência do fornecedor

severity

O nível de gravidade da subavalidade

Nome Tipo Description
High

string

Low

string

Medium

string

SqlServerVulnerabilityProperties

Detalhes do recurso que foi avaliado

Nome Tipo Description
assessedResourceType string:

SqlServerVulnerability

Tipo de recurso de subavalização
query

string

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

string

O tipo de recurso ao qual a subavalização se refere nos detalhes do recurso

SubAssessmentStatus

Status da subavalização

Nome Tipo Description
cause

string

Código programático para a causa do status da avaliação
code

SubAssessmentStatusCode

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

string

Descrição legível humana do status da avaliação
severity

severity

O nível de gravidade da subavalidade

SubAssessmentStatusCode

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

Nome Tipo Description
Healthy

string

O recurso está íntegro
NotApplicable

string

A avaliação desse recurso não aconteceu
Unhealthy

string

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

VendorReference

Referência do fornecedor

Nome Tipo Description
link

string

URL do link
title

string

Título do link