Поделиться через

Sub Assessments - List All

  • Ссылка
Служба:
Defender for Cloud
Версия API:
2019-01-01-preview

Получение подоценок безопасности на всех сканированных ресурсах в области подписки

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

Параметры URI

Имя В Обязательно Тип Описание
scope
 path True

string

Область запроса может быть подпиской (/subscriptions/0b06d9ea-afe6-4779-bd59-30e5c2d9d13f) или группой управления (/providers/Microsoft.Management/managementGroups/mgName).
api-version
 query True

string

Версия API для операции

Ответы

Имя Тип Описание
200 OK

SecuritySubAssessmentList

ХОРОШО
Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

List security sub-assessments

Образец запроса

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

Пример ответа

Код состояния:
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": []
        }
      }
    }
  ]
}

Определения

Имя Описание
AzureResourceDetails

Сведения о ресурсе Azure, который был оценен
CloudError

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).
CloudErrorBody

Сведения об ошибке.
ContainerRegistryVulnerabilityProperties

Дополнительные поля контекста для оценки уязвимостей реестра контейнеров
CVE

Сведения о CVE
CVSS

Сведения о CVSS
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
OnPremiseResourceDetails

Сведения о локальном ресурсе, который был оценен
OnPremiseSqlResourceDetails

Сведения о ресурсе Локального SQL, который был оценен
SecuritySubAssessment

Подоценка безопасности для ресурса
SecuritySubAssessmentList

Список подоценок безопасности
ServerVulnerabilityProperties

Дополнительные поля контекста для оценки уязвимостей сервера
severity

Уровень серьезности субоценки
SqlServerVulnerabilityProperties

Сведения о ресурсе, который был оценен
SubAssessmentStatus

Состояние подоценки
SubAssessmentStatusCode

Программный код для состояния оценки
VendorReference

Справочник по поставщику

AzureResourceDetails

Сведения о ресурсе Azure, который был оценен

Имя Тип Описание
id

string

Идентификатор ресурса Azure для оцененного ресурса
source string:

Azure

Платформа, на которой находится оцененный ресурс

CloudError

Распространенный ответ об ошибке для всех API Azure Resource Manager для возврата сведений об ошибке для неудачных операций. (Это также следует формату ответа об ошибках OData.).

Имя Тип Описание
error.additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
error.code

string

Код ошибки.
error.details

CloudErrorBody[]

Сведения об ошибке.
error.message

string

Сообщение об ошибке.
error.target

string

Целевой объект ошибки.

CloudErrorBody

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

CloudErrorBody[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ContainerRegistryVulnerabilityProperties

Дополнительные поля контекста для оценки уязвимостей реестра контейнеров

Имя Тип Описание
assessedResourceType string:

ContainerRegistryVulnerability

Тип ресурса подоценки
cve

CVE[]

Список CVEs
cvss

<string,  CVSS>

Словарь из версии cvss в объект сведений cvss
imageDigest

string

Дайджест уязвимого образа
patchable

boolean

Указывает, доступен ли исправление или нет
publishedTime

string

Время публикации
repositoryName

string

Имя репозитория, к которому принадлежит уязвимый образ
type

string

Тип уязвимости. Например, уязвимость, потенциальная уязвимость, собранная информация, уязвимость
vendorReferences

VendorReference[]

Справочник по поставщику

CVE

Сведения о CVE

Имя Тип Описание
link

string

URL-адрес ссылки
title

string

Заголовок CVE

CVSS

Сведения о CVSS

Имя Тип Описание
base

number

База CVSS

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Дополнительный тип сведений.

OnPremiseResourceDetails

Сведения о локальном ресурсе, который был оценен

Имя Тип Описание
machineName

string

Имя компьютера
source string:

OnPremise

Платформа, на которой находится оцененный ресурс
sourceComputerId

string

Идентификатор агента oms, установленный на компьютере
vmuuid

string

Уникальный идентификатор компьютера
workspaceId

string

Идентификатор ресурса Azure рабочей области, к которому подключен компьютер

OnPremiseSqlResourceDetails

Сведения о ресурсе Локального SQL, который был оценен

Имя Тип Описание
databaseName

string

Имя базы данных Sql, установленное на компьютере
machineName

string

Имя компьютера
serverName

string

Имя sql server, установленное на компьютере
source string:

OnPremiseSql

Платформа, на которой находится оцененный ресурс
sourceComputerId

string

Идентификатор агента oms, установленный на компьютере
vmuuid

string

Уникальный идентификатор компьютера
workspaceId

string

Идентификатор ресурса Azure рабочей области, к которому подключен компьютер

SecuritySubAssessment

Подоценка безопасности для ресурса

Имя Тип Описание
id

string

Идентификатор ресурса
name

string

Имя ресурса
properties.additionalData AdditionalData:

Сведения о подоценки
properties.category

string

Категория подоценки
properties.description

string

Удобочитаемое описание состояния оценки
properties.displayName

string

Понятное отображаемое имя подоценки
properties.id

string

Идентификатор уязвимости
properties.impact

string

Описание влияния этой подоценки
properties.remediation

string

Сведения об исправлении этой подоценки
properties.resourceDetails ResourceDetails:

Сведения о ресурсе, который был оценен
properties.status

SubAssessmentStatus

Состояние подоценки
properties.timeGenerated

string

Дата и время создания подоценки
type

string

Тип ресурса

SecuritySubAssessmentList

Список подоценок безопасности

Имя Тип Описание
nextLink

string

URI для получения следующей страницы.
value

SecuritySubAssessment[]

Подоценка безопасности для ресурса

ServerVulnerabilityProperties

Дополнительные поля контекста для оценки уязвимостей сервера

Имя Тип Описание
assessedResourceType string:

ServerVulnerabilityAssessment

Тип ресурса подоценки
cve

CVE[]

Список CVEs
cvss

<string,  CVSS>

Словарь из версии cvss в объект сведений cvss
patchable

boolean

Указывает, доступен ли исправление или нет
publishedTime

string

Время публикации
threat

string

Имя угрозы
type

string

Тип уязвимости. например: уязвимость, потенциальная уязвимость, собранная информация
vendorReferences

VendorReference[]

Справочник по поставщику

severity

Уровень серьезности субоценки

Имя Тип Описание
High

string

Low

string

Medium

string

SqlServerVulnerabilityProperties

Сведения о ресурсе, который был оценен

Имя Тип Описание
assessedResourceType string:

SqlServerVulnerability

Тип ресурса подоценки
query

string

Запрос T-SQL, который выполняется в базе данных SQL для выполнения конкретной проверки
type

string

Тип ресурса, на который ссылается подоценка, ссылается на сведения о ресурсе.

SubAssessmentStatus

Состояние подоценки

Имя Тип Описание
cause

string

Программный код для причины состояния оценки
code

SubAssessmentStatusCode

Программный код для состояния оценки
description

string

Удобочитаемое описание состояния оценки
severity

severity

Уровень серьезности субоценки

SubAssessmentStatusCode

Программный код для состояния оценки

Имя Тип Описание
Healthy

string

Ресурс работоспособный
NotApplicable

string

Оценка этого ресурса не произошла
Unhealthy

string

Ресурс имеет проблему безопасности, которую необходимо устранить

VendorReference

Справочник по поставщику

Имя Тип Описание
link

string

URL-адрес ссылки
title

string

Заголовок ссылки