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

ENetrebin в 11:02, 4 апреля 2022

2022-04-04T11:02:03Z

← Предыдущая		Версия 11:02, 4 апреля 2022
Строка 1:		Строка 1:

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

	Вы можете ограничить вывод, используя разбиение на страницы:		Вы можете ограничить вывод, используя разбиение на страницы:

ENetrebin в 10:51, 11 марта 2022

2022-03-11T10:51:40Z

← Предыдущая		Версия 10:51, 11 марта 2022
Строка 1:		Строка 1:

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

	Вы можете ограничить вывод, используя разбиение на страницы:		Вы можете ограничить вывод, используя разбиение на страницы:
Строка 9:		Строка 9:

	Запрос создает <code>application/json</code>полезную нагрузку.		Запрос создает <code>application/json</code>полезную нагрузку.

	~~Первых компаний, внедривших~~

	~~Этот запрос относится к раннему выпуску Adopter и может быть изменен несовместимым образом.~~
	{\| class="wikitable"		{\| class="wikitable"
	\|~~ПОЛУЧИТЬ~~		\|GET
	\|		\|
	* Удалось https: // {vash-domen} / e / {your-environment-id} / api / v2 / davis / securityAdvices		* Удалось https: // {vash-domen} / e / {your-environment-id} / api / v2 / davis / securityAdvices
	* SaaS https: // {your-environment-id} .live.dynatrace.com / api / v2 / davis / securityAdvices.		* SaaS https: // {your-environment-id} .live.dynatrace.com / api / v2 / davis / securityAdvices.
	* ~~Среда ActiveGate~~ https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / davis / securityAdvices		* Environment АктивныйШлюз https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / davis / securityAdvices
	\|}		\|}

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

	== Параметры ==		== Параметры ==
Строка 29:		Строка 25:
	!Тип		!Тип
	!Описание		!Описание
	!В		!In
	!~~необходимые~~		!необходимость
	\|-		\|-
	\|managementZoneFilter		\|managementZoneFilter
	\|~~нить~~		\|string
	\|Чтобы указать зоны управления, используйте одну из опций, перечисленных ниже. Для каждой опции вы можете указать несколько значений, разделенных запятыми. Если указано несколько значений, применяется логика ИЛИ . Все значения чувствительны к регистру и должны быть заключены в кавычки.		\|Чтобы указать зоны управления, используйте одну из опций, перечисленных ниже. Для каждой опции вы можете указать несколько значений, разделенных запятыми. Если указано несколько значений, применяется логика ИЛИ . Все значения чувствительны к регистру и должны быть заключены в кавычки.

Строка 44:		Строка 40:
	\|-		\|-
	\|nextPageKey		\|nextPageKey
	\|~~нить~~		\|string
	\|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.		\|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.

Строка 54:		Строка 50:
	\|-		\|-
	\|размер страницы		\|размер страницы
	\|~~целое число~~		\|integer
	\|Количество советов по безопасности в одной полезной нагрузке.		\|Количество советов по безопасности в одной полезной нагрузке.

Строка 86:		Строка 82:
	!Описание		!Описание
	\|-		\|-
	\|~~общее количество~~		\|totalCount
	\|~~целое число~~		\|integer
	\|Общее количество записей в результате.		\|Общее количество записей в результате.
	\|-		\|-
	\|размер страницы		\|размер страницы
	\|~~целое число~~		\|integer
	\|Количество записей на странице.		\|Количество записей на странице.
	\|-		\|-
	\|nextPageKey		\|nextPageKey
	\|~~нить~~		\|string
	\|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице.		\|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице.

	Используйте его в параметре запроса nextPageKey для получения последующих страниц результата.		Используйте его в параметре запроса nextPageKey для получения последующих страниц результата.

			Может быть <code>null</code>.
	\|-		\|-
	\|~~советы~~		\|advices
	\|~~Совет по безопасности Дэвиса~~ []		\|DavisSecurityAdvice[]
	\|		\| -
			Может быть <code>null</code>.
	\|}		\|}

Строка 112:		Строка 111:
	!Описание		!Описание
	\|-		\|-
	\|~~название~~		\|name
	\|~~нить~~		\|string
	\|Название совета.		\|Название совета.
	\|-		\|-
	\|~~уязвимый компонент~~		\|vulnerableComponent
	\|~~нить~~		\|string
	\|Уязвимый компонент, к которому применяется совет.		\|Уязвимый компонент, к которому применяется совет.
	\|-		\|-
	\|~~технологии~~		\|technology
	\|~~нить~~		\|string
	\|Технология уязвимого компонента.		\|Технология уязвимого компонента.

Строка 127:		Строка 126:
	\|-		\|-
	\|adviceType		\|adviceType
	\|~~нить~~		\|string
	\|Тип совета.		\|Тип совета.

	Элемент может содержать эти значения		Элемент может содержать эти значения
	\|-		\|-
	\|~~критический~~		\|critical
	\|~~нить~~[]		\|string[]
	\|Идентификаторы проблем <code>critical</code>уровня безопасности, вызванных уязвимым компонентом.		\|Идентификаторы проблем <code>critical</code>уровня безопасности, вызванных уязвимым компонентом.
	\|-		\|-
	\|~~высокий~~		\|high
	\|~~нить~~[]		\|string[]
	\|Идентификаторы проблем <code>high</code>уровня безопасности, вызванных уязвимым компонентом.		\|Идентификаторы проблем <code>high</code>уровня безопасности, вызванных уязвимым компонентом.
	\|-		\|-
	\|~~средний~~		\|medium
	\|~~нить~~[]		\|string[]
	\|Идентификаторы проблем <code>medium</code>уровня безопасности, вызванных уязвимым компонентом.		\|Идентификаторы проблем <code>medium</code>уровня безопасности, вызванных уязвимым компонентом.
	\|-		\|-
	\|~~низкий~~		\|low
	\|~~нить~~[]		\|string[]
	\|Идентификаторы проблем <code>low</code>уровня безопасности, вызванных уязвимым компонентом.		\|Идентификаторы проблем <code>low</code>уровня безопасности, вызванных уязвимым компонентом.
	\|-		\|-
	\|~~никто~~		\|now
	\|~~нить~~[]		\|string[]
	\|Идентификаторы проблем <code>none</code>уровня безопасности, вызванных уязвимым компонентом.		\|Идентификаторы проблем <code>none</code>уровня безопасности, вызванных уязвимым компонентом.
	\|}		\|}

ENetrebin в 18:31, 12 декабря 2021

2021-12-12T18:31:52Z

← Предыдущая		Версия 18:31, 12 декабря 2021
Строка 153:		Строка 153:
	\|}		\|}

			* Модель 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>
	*		*

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

2021-12-12T18:30:20Z

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

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

= API советника по безопасности Davis =
Davis Advisor Security API перечисляет рекомендацию Davis , связанную с открытой и заглушены проблемами безопасности .

Вы можете ограничить вывод, используя разбиение на страницы:

# Укажите количество результатов на странице в параметре запроса pageSize .
# Затем используйте курсор из поля nextPageKey предыдущего ответа в параметре запроса nextPageKey для получения последующих страниц.

Запрос создает <code>application/json</code>полезную нагрузку.

Первых компаний, внедривших

Этот запрос относится к раннему выпуску Adopter и может быть изменен несовместимым образом.
{| class="wikitable"
|ПОЛУЧИТЬ
|
* Удалось https: // {vash-domen} / e / {your-environment-id} / api / v2 / davis / securityAdvices
* SaaS https: // {your-environment-id} .live.dynatrace.com / api / v2 / davis / securityAdvices.
* Среда ActiveGate https: // {your-activegate-domain} / e / {your-environment-id} / api / v2 / davis / securityAdvices
|}

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

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!необходимые
|-
|managementZoneFilter
|нить
|Чтобы указать зоны управления, используйте одну из опций, перечисленных ниже. Для каждой опции вы можете указать несколько значений, разделенных запятыми. Если указано несколько значений, применяется логика ИЛИ . Все значения чувствительны к регистру и должны быть заключены в кавычки.

* Идентификатор зоны управления: ids («mzId-1», «mzId-2»).
* Названия зон управления: наименования («МЗ-1», «МЗ-2»).

Вы можете указать несколько критериев, разделенных запятыми (например, <code>names("myMz"),ids("9130632296508575249")</code>).
|запрос
|по желанию
|-
|nextPageKey
|нить
|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.

Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey .

Если nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса.
|запрос
|по желанию
|-
|размер страницы
|целое число
|Количество советов по безопасности в одной полезной нагрузке.

Максимально допустимый размер страницы - 500.

Если не установлен, используется 5.
|запрос
|по желанию
|}

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
!Описание
|-
|200
|Успех
|}

=== Тело ответа ===

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

==== DavisSecurityAdviceList объект ====
Список советов от советника по безопасности Дэвиса.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|общее количество
|целое число
|Общее количество записей в результате.
|-
|размер страницы
|целое число
|Количество записей на странице.
|-
|nextPageKey
|нить
|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице.

Используйте его в параметре запроса nextPageKey для получения последующих страниц результата.
|-
|советы
|Совет по безопасности Дэвиса []
|
|}

==== DavisSecurityAdvice объект ====
Совет по безопасности от советника по безопасности Дэвиса.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|название
|нить
|Название совета.
|-
|уязвимый компонент
|нить
|Уязвимый компонент, к которому применяется совет.
|-
|технологии
|нить
|Технология уязвимого компонента.

Элемент может содержать эти значения
|-
|adviceType
|нить
|Тип совета.

Элемент может содержать эти значения
|-
|критический
|нить[]
|Идентификаторы проблем <code>critical</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|высокий
|нить[]
|Идентификаторы проблем <code>high</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|средний
|нить[]
|Идентификаторы проблем <code>medium</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|низкий
|нить[]
|Идентификаторы проблем <code>low</code>уровня безопасности, вызванных уязвимым компонентом.
|-
|никто
|нить[]
|Идентификаторы проблем <code>none</code>уровня безопасности, вызванных уязвимым компонентом.
|}

*