Поиск активов

GET /api/v2/assets

Информация о программном обеспечении активов из KSC не хранится в KUMA и не будет показана в ответе.

Доступ: Главный администратор, Администратор тенанта, Аналитик второго уровня, Аналитик первого уровня, Младший аналитик, Доступ к объектам НКЦКИ, Доступ к объектам КИИ.

Роль Доступ к общим ресурсам выдается только для Общего тенанта: в этом тенанте не может быть активов, но категории в тенанте есть. Для этой роли в ответ ничего не вернется.

Параметры запроса

Имя

Тип данных

Обязательный

Описание

Пример значения

page

number

Нет

Номер страницы. Начинается с 1. Размер страницы – 250 записей. Если параметр не указан, то используется значение по умолчанию – 1.

1

id

string

Нет

Идентификатор актива. Если параметр указан несколько раз, то формируется список и применяется логический оператор ИЛИ.

00000000-0000-0000-0000-000000000000

tenantID

string

Нет

Идентификатор тенанта актива. Если параметр указан несколько раз, то формируется список и применяется логический оператор ИЛИ. Если пользователь не имеет необходимой роли в указанном тенанте, то этот тенант игнорируется.

00000000-0000-0000-0000-000000000000

name

string

Нет

Название актива. Регистронезависимое регулярное выражение (PCRE).

asset

^My asset$

fqdn

string

Нет

FQDN актива. Регистронезависимое регулярное выражение (PCRE).

example.com

ip

string

Нет

IP-адрес актива. Регистронезависимое регулярное выражение (PCRE).

10.10

^192.168.1.2$

mac

string

Нет

MAC-адрес актива. Регистронезависимое регулярное выражение (PCRE).

^00:0a:95:9d:68:16$

Ответ

HTTP-код: 200

Формат: JSON

type Response []Asset

 

type Asset struct {

    ID                     string              `json:"id"`

    TenantID               string              `json:"tenantID"`

    TenantName             string              `json:"tenantName"`

    Name                   string              `json:"name"`

    FQDN                   string              `json:"fqdn"`

    IPAddresses            []string            `json:"ipAddresses"`

    MACAddresses           []string            `json:"macAddresses"`

    Owner                  string              `json:"owner"`

    OS                     *OS                 `json:"os"`

    Software               []Software          `json:"software"`

    Vulnerabilities        []Vulnerability     `json:"vulnerabilities"`

    KICSRisks              []*assets.KICSRisk  `json:"kicsVulns"`

    KSC                    *KSCFields          `json:"ksc"`

    Created                string              `json:"created"`

    Updated                string              `json:"updated"`

}

 

type KSCFields struct {

    NAgentID          string `json:"nAgentID"`

    KSCInstanceID     string `json:"kscInstanceID"`

    KSCMasterHostname string `json:"kscMasterHostname"`

    LastVisible       string `json:"lastVisible"`

}

 

type OS struct {

    Name    string `json:"name"`

    Version uint64 `json:"version"`

}

 

type Software struct {

    Name    string `json:"name"`

    Version string `json:"version"`

    Vendor  string `json:"vendor"`

}

 

type Vulnerability struct {

    KasperskyID           string   `json:"kasperskyID"`

    ProductName           string   `json:"productName"`

    DescriptionURL        string   `json:"descriptionURL"`

    RecommendedMajorPatch string   `json:"recommendedMajorPatch"`

    RecommendedMinorPatch string   `json:"recommendedMinorPatch"`

    SeverityStr           string   `json:"severityStr"`

    Severity              uint64   `json:"severity"`

    CVE                   []string `json:"cve"`

    ExploitExists         bool     `json:"exploitExists"`

    MalwareExists         bool     `json:"malwareExists"`

}

 

type assets.KICSRisk struct {

    ID              int64    `json:"id"`

    Name            string   `json:"name"`

    Category        string   `json:"category"`

    Description     string   `json:"description"`

    DescriptionUrl  string   `json:"descriptionUrl"`

    Severity        int      `json:"severity"`

    Cvss            float64  `json:"cvss"`

}

Возможные ошибки

HTTP-код

Описание

Значение поля message

Значение поля details

400

Неверное значение параметра page

invalid query parameter value

page

500

Любые другие внутренние ошибки

вариативное

вариативное

В начало