Поиск типов инцидентов для уязвимостей
Запрос
Тип | Метод |
---|---|
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
}