Перейти к содержанию

Поиск типов инцидентов для уязвимостей

Запрос

Тип Метод
POST /vulnerabilities/check_finding_ids

Описание: При выполнении запроса будут возвращены найденные идентификаторы и заголовки типов инцидентов для уязвимости.

Пример запроса

POST
http://127.0.0.1/cruddy/v2/vulnerabilities/check_finding_ids

Тело запроса:

Параметр Тип данных Обязательность Описание
vulnerability_ids Array<string> Required Массив ID уязвимостей
Пример тела запроса

{
  "vulnerability_ids": [
    "2aef5665-d918-4e66-ad93-7a1dc9c3779e",
    "2aef5665-d918-4e66-ad93-7a1dc9c3779e"
  ]
}

Успешный ответ

Статус код: 200 – успешный ответ.

Формат: JSON.

Параметры ответа:

Параметр Тип данных Описание
finding_ids_for_vulns object Объект в формате map<string, object>
Ключи: идентификаторы уязвимостей.
Значения: объекты с идентификаторами и заголовками типов инцидентов.
Если тип инцидента не найден, в полях значения будет will_be_created
vulnerability_id_1 object Найденный тип инцидента для данной уязвимости
vulnerability_id_1{id} string Идентификатор типа инцидента
vulnerability_id_1{title} string Заголовок типа инцидента
vulnerability_id_N object Найденный тип инцидента для данной уязвимости
vulnerability_id_1{id} string Идентификатор типа инцидента
vulnerability_id_1{title} string Заголовок типа инцидента
Пример ответа

{
  "finding_ids_for_vulns": {
    "vulnerability_id_1": {
      "id": "5e91b032-28a9-b368-6df3-69b157964559",
      "title": "FIN1456 - Уязвимость несанкционированного получения прав Win32k (06/11/2019)"
    },
    "vulnerability_id_N": {
      "id": "2a2b837f-6275-2a0b-fb72-aa1b3df8bf5d",
      "title": "FIN1457 - Уязвимость удаленного выполнения кода ActiveX Data Objects (06/11/2019)"
    }
  }
}

Другие возможные ответы

Код Ответ Описание
400 Bad Request
empty vulnerability_ids
id is empty
id should be uuid format
Неверный тип параметра запроса, либо отсутствует обязательный параметр
ID уязвимостей не переданы
Передано пустое значение ID
Недопустимый формат ID
404 Not Found Уязвимость не найдена
500 Internal Server Error Другие ошибки сервера

Примечание: Текст ошибки не фиксированный, может изменяться в зависимости от фактического ответа получателя запроса.

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

Код 400

{
  "error": "Bad Request",
  "error_code": 400
}

Код 404

{
  "error": "Not Found",
  "error_code": 404
}

Код 500

{
  "error": "Internal Server Error",
  "error_code": 500
}