Советник по безопасности Davis - История изменений

ENetrebin в 16:22, 6 июля 2023

2023-07-06T16:22:27Z

← Предыдущая		Версия 16:22, 6 июля 2023
Строка 1:		Строка 1:

	= API советника по безопасности ~~Davis~~ =		= API советника по безопасности ИИ =
	~~Davis~~ Advisor Security API перечисляет рекомендации ~~Davis~~, связанные с открытыми и скрытыми проблемами безопасности .		ИИ Advisor Security API перечисляет рекомендации ИИ, связанные с открытыми и скрытыми проблемами безопасности .

	Вы можете ограничить вывод, используя разбиение на страницы:		Вы можете ограничить вывод, используя разбиение на страницы:
Строка 12:		Строка 12:
	\|GET		\|GET
	\|		\|
	* ~~Удалось~~ https: // {vash-domen} / e / {your-environment-id} / api / v2 / ~~davis~~ / securityAdvices		* Managed https: // {vash-domen} / e / {your-environment-id} / api / v2 / AI / securityAdvices
	* SaaS https: // {your-environment-id} .live.dynatrace.com / api / v2 / davis / securityAdvices.		* Environment АктивныйШлюз https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / AI / securityAdvices
	* Environment АктивныйШлюз https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / ~~davis~~ / securityAdvices
	\|}		\|}

Строка 73:		Строка 72:
	* Параметры ответа		* Параметры ответа

	==== ~~DavisSecurityAdviceList~~ объект ====		==== AISecurityAdviceList объект ====
	Список советов от советника по безопасности ~~Дэвиса~~.		Список советов от советника по безопасности ИИ.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 96:		Строка 95:
	\|-		\|-
	\|advices		\|advices
	\|~~DavisSecurityAdvice~~[]		\|AISecurityAdvice[]
	\| -		\| -
	Может быть <code>null</code>.		Может быть <code>null</code>.
	\|}		\|}

	==== ~~DavisSecurityAdvice~~ объект ====		==== AISecurityAdvice объект ====
	Совет по безопасности от советника по безопасности ~~Дэвиса~~.		Совет по безопасности от советника по безопасности ИИ.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент

ENetrebin: /* Аутентификацияправитьправить код */

2022-04-07T11:56:48Z

Аутентификацияправитьправить код

← Предыдущая		Версия 11:56, 7 апреля 2022
Строка 17:		Строка 17:
	\|}		\|}

	== ~~Аутентификацияправитьправить код~~ ==		== Аутентификация ==
	Чтобы выполнить этот запрос, вам необходимо разрешение на чтение проблем безопасности ( <code>securityProblems.read</code>), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. Токены и аутентификация .		Чтобы выполнить этот запрос, вам необходимо разрешение на чтение проблем безопасности ( <code>securityProblems.read</code>), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. Токены и аутентификация .

	== ~~Параметрыправитьправить код~~ ==		== Параметры ==
	{\| class="wikitable"		{\| class="wikitable"
	!Параметр		!Параметр
Строка 58:		Строка 58:
	\|}		\|}

	== ~~Ответправитьправить код~~ ==		== Ответ ==

	=== Коды ~~ответовправитьправить код~~ ===		=== Коды ответов ===
	{\| class="wikitable"		{\| class="wikitable"
	!Код		!Код
Строка 69:		Строка 69:
	\|}		\|}

	=== Тело ~~ответаправитьправить код~~ ===		=== Тело ответа ===

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

	==== DavisSecurityAdviceList ~~объектправитьправить код~~ ====		==== DavisSecurityAdviceList объект ====
	Список советов от советника по безопасности Дэвиса.		Список советов от советника по безопасности Дэвиса.
	{\| class="wikitable"		{\| class="wikitable"
Строка 101:		Строка 101:
	\|}		\|}

	==== DavisSecurityAdvice ~~объектправитьправить код~~ ====		==== DavisSecurityAdvice объект ====
	Совет по безопасности от советника по безопасности Дэвиса.		Совет по безопасности от советника по безопасности Дэвиса.
	{\| class="wikitable"		{\| class="wikitable"
Строка 149:		Строка 149:
	* Модель JSON		* Модель JSON

	=== Тело ~~ответаправитьправить код~~ ===		=== Тело ответа ===
	<code>{		<code>{
	"totalCount": 1,		"totalCount": 1,

ENetrebin: Новая страница: « = API советника по безопасности Davis = Davis Advisor Security API перечисляет рекомендации Davis, связанны...»

2022-04-07T11:54:48Z

Новая страница: « = API советника по безопасности Davis = Davis Advisor Security API перечисляет рекомендации Davis, связанны...»

Новая страница

= 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. Чтобы узнать, как его получить и использовать, см. Токены и аутентификация .

== Параметрыправитьправить код ==
{| 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>