Советник по безопасности1: различия между версиями

Материал из Документация Ключ-АСТРОМ
 
(не показано 7 промежуточных версий этого же участника)
Строка 1: Строка 1:
 
{{DISPLAYTITLE:Советник по безопасности}}
= API советника по безопасности Davis =
Davis Advisor Security API перечисляет рекомендации Davis, связанные с открытыми и скрытыми проблемами безопасности .
 
Вы можете ограничить вывод, используя разбиение на страницы:
 
# Укажите количество результатов на странице в параметре запроса pageSize .
# Затем используйте курсор из поля nextPageKey предыдущего ответа в параметре запроса nextPageKey для получения последующих страниц.
 
Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
|GET
|
* Удалось https: // {vash-domen} / e / {your-environment-id} / api / v2 / davis / securityAdvices
* SaaS https: // {your-environment-id} .live.dynatrace.com / api / v2 / davis / securityAdvices.
* Environment АктивныйШлюз https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / davis / securityAdvices
|}
 
== Аутентификация ==
Чтобы выполнить этот запрос, вам необходимо разрешение на чтение проблем безопасности ( <code>securityProblems.read</code>), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. [[Токены и аутентификация (API)|Токены и аутентификация]] .
 
== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!необходимость
|-
|managementZoneFilter
|string
|Чтобы указать зоны управления, используйте одну из опций, перечисленных ниже. Для каждой опции вы можете указать несколько значений, разделенных запятыми. Если указано несколько значений, применяется логика ИЛИ . Все значения чувствительны к регистру и должны быть заключены в кавычки.
 
* Идентификатор зоны управления: ids («mzId-1», «mzId-2»).
* Названия зон управления: наименования («МЗ-1», «МЗ-2»).
 
Вы можете указать несколько критериев, разделенных запятыми (например, <code>names("myMz"),ids("9130632296508575249")</code>).
|запрос
|по желанию
|-
|nextPageKey
|string
|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
 
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey .
 
Если nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса.
|запрос
|по желанию
|-
|размер страницы
|integer
|Количество советов по безопасности в одной полезной нагрузке.
 
Максимально допустимый размер страницы - 500.
 
Если не установлен, используется 5.
|запрос
|по желанию
|}
 
== Ответ ==
 
=== Коды ответов ===
{| class="wikitable"
!Код
!Описание
|-
|200
|Успех
|}
 
=== Тело ответа ===
 
* Параметры ответа
 
==== DavisSecurityAdviceList объект ====
Список советов от советника по безопасности Дэвиса.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|totalCount
|integer
|Общее количество записей в результате.
|-
|размер страницы
|integer
|Количество записей на странице.
|-
|nextPageKey
|string
|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице.
 
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата.
 
Может быть <code>null</code>.
|-
|advices
|DavisSecurityAdvice[]
| -
Может быть <code>null</code>.
|}
 
==== DavisSecurityAdvice объект ====
Совет по безопасности от советника по безопасности Дэвиса.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|name
|string
|Название совета.
|-
|vulnerableComponent
|string
|Уязвимый компонент, к которому применяется совет.
|-
|technology
|string
|Технология уязвимого компонента.
 
Элемент может содержать эти значения
|-
|adviceType
|string
|Тип совета.
 
Элемент может содержать эти значения
|-
|critical
|string[]
|Идентификаторы проблем <code>critical</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|high
|string[]
|Идентификаторы проблем <code>high</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|medium
|string[]
|Идентификаторы проблем <code>medium</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|low
|string[]
|Идентификаторы проблем <code>low</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|now
|string[]
|Идентификаторы проблем <code>none</code>уровня безопасности, вызванных уязвимым компонентом.
|}
 
* Модель JSON
 
=== Тело ответа ===
<code>{
  "totalCount": 1,
  "pageSize": 1,
  "nextPageKey": "AQAAABQBAAAABQ==",
  "advices": [
    {
      "name": "string",
      "vulnerableComponent": "string",
      "technology": "DOTNET",
      "adviceType": "UPGRADE",
      "critical": [
        "string"
      ],
      "high": [
        "string"
      ],
      "medium": [
        "string"
      ],
      "low": [
        "string"
      ],
      "none": [
        "string"
      ]
    }
  ]
}</code>
*
*

Текущая версия на 10:49, 7 июля 2023