Токены и аутентификация (API) - История изменений

ENetrebin в 14:31, 24 января 2023

2023-01-24T14:31:37Z

← Предыдущая		Версия 14:31, 24 января 2023
Строка 1:		Строка 1:
	Чтобы пройти аутентификацию для использования ~~Ключ-АСТРОМ~~ API, вам понадобится действующий [[токен доступа]] или действительный [[токен личного доступа]] . Доступ к API детализирован, что означает, что вам также потребуются соответствующие разрешения, назначенные токену. См. описание каждого запроса, чтобы узнать, какие разрешения требуются для его использования.		Чтобы пройти аутентификацию для использования Dynatrace API, вам понадобится действующий [[токен доступа]] или действительный [[токен личного доступа]] . Доступ к API детализирован, что означает, что вам также потребуются соответствующие разрешения, назначенные токену. См. описание каждого запроса, чтобы узнать, какие разрешения требуются для его использования.

	== Формат токена ==		== Формат токена ==
	~~Ключ-АСТРОМ~~ использует уникальный формат токенов, состоящий из трех компонентов, разделенных точками (.). Например:<br>		Dynatrace использует уникальный формат токенов, состоящий из трех компонентов, разделенных точками (.). Например:<br>
	dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM		dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM

	* dt0c01 - Префикс для идентификации токена.		* dt0c01 - Префикс для идентификации токена.
	* ST2...7YN - Открытая часть токена. 24-значный открытый идентификатор токена. Это значение можно безопасно отображать в пользовательском интерфейсе и использовать для ведения журнала.		* ST2...7YN - Открытая часть токена. 24-значный открытый идентификатор токена. Это значение можно безопасно отображать в пользовательском интерфейсе и использовать для ведения журнала.
	* G3D...RZM - Секретная часть токена. 64-символьная секретная часть токена, которую можно рассматривать как пароль, поэтому она не отображается в веб-интерфейсе ~~Ключ-АСТРОМ~~ (после первоначального создания) и не сохраняется в файлах журнала.		* G3D...RZM - Секретная часть токена. 64-символьная секретная часть токена, которую можно рассматривать как пароль, поэтому она не отображается в веб-интерфейсе Dynatrace (после первоначального создания) и не сохраняется в файлах журнала.
	== Создание токена ==		== Создание токена ==
	=== Токен API ===		=== Токен API ===
	Чтобы сгенерировать токен доступа		Чтобы сгенерировать токен доступа

	# В меню ~~Ключ-АСТРОМ~~ выберите маркеры доступа.		# В меню Dynatrace выберите маркеры доступа.
	# Выберите Создать новый токен .		# Выберите Создать новый токен .
	# Введите имя для вашего токена.		# Введите имя для вашего токена.
Строка 24:		Строка 24:
	В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена.		В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена.

	~~Ключ-АСТРОМ~~ не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.		Dynatrace не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.

	=== Токен персонального доступа ===		=== Токен персонального доступа ===
Строка 42:		Строка 42:
	В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена личного доступа.		В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена личного доступа.

	~~Ключ-АСТРОМ~~ не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.		Dynatrace не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.

	== Разрешения токена ==		== Разрешения токена ==
	=== Токен API ===		=== Токен API ===
	~~Ключ-АСТРОМ~~ предоставляет следующие разрешения для токенов API. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]]. Некоторые области доступны только через API.<br>		Dynatrace предоставляет следующие разрешения для токенов API. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]]. Некоторые области доступны только через API.<br>

	{\| class="wikitable"		{\| class="wikitable"
Строка 81:		Строка 81:

	=== Токен персонального доступа ===		=== Токен персонального доступа ===
	~~Ключ-АСТРОМ~~ предоставляет следующие разрешения для токенов личного доступа. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]].<br>		Dynatrace предоставляет следующие разрешения для токенов личного доступа. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]].<br>

	{\| class="wikitable"		{\| class="wikitable"

RGolovanov в 14:55, 13 сентября 2022

2022-09-13T14:55:45Z

← Предыдущая		Версия 14:55, 13 сентября 2022
Строка 8:		Строка 8:
	* ST2...7YN - Открытая часть токена. 24-значный открытый идентификатор токена. Это значение можно безопасно отображать в пользовательском интерфейсе и использовать для ведения журнала.		* ST2...7YN - Открытая часть токена. 24-значный открытый идентификатор токена. Это значение можно безопасно отображать в пользовательском интерфейсе и использовать для ведения журнала.
	* G3D...RZM - Секретная часть токена. 64-символьная секретная часть токена, которую можно рассматривать как пароль, поэтому она не отображается в веб-интерфейсе Ключ-АСТРОМ (после первоначального создания) и не сохраняется в файлах журнала.		* G3D...RZM - Секретная часть токена. 64-символьная секретная часть токена, которую можно рассматривать как пароль, поэтому она не отображается в веб-интерфейсе Ключ-АСТРОМ (после первоначального создания) и не сохраняется в файлах журнала.


	== Создание токена ==		== Создание токена ==
	=== Токен API ===		=== Токен API ===

DKashanov в 09:01, 5 декабря 2021

2021-12-05T09:01:40Z

← Предыдущая		Версия 09:01, 5 декабря 2021
Строка 63:		Строка 63:
	\|metrics.write		\|metrics.write
	\|Предоставляет доступ к [[удалению пользовательской метрики]] для запроса к Metrics API v2.		\|Предоставляет доступ к [[удалению пользовательской метрики]] для запроса к Metrics API v2.
			\|-
			\|Метрики загрузки
			\|metrics.ingest
			\|Предоставляет доступ к POST запросу ingest data points Metrics API v2.
			\|-
			\|Чтение логов
			\|logs.read
			\|Предоставляет доступ к GET запросам [[Log Monitoring API v2]].
			\|-
			\|Логи загрузки
			\|logs.ingest
			\|Предоставляет доступ к POST запросу логов загрузки Log Monitoring API v2.
			\|-
			\|
			\|
			\|

	\|}		\|}

DKashanov в 11:20, 3 декабря 2021

2021-12-03T11:20:30Z

← Предыдущая		Версия 11:20, 3 декабря 2021
Строка 94:		Строка 94:
	--url https://mySampleEnv.ruscomtech.ru/api/v1/config/clusterversion \<br>		--url https://mySampleEnv.ruscomtech.ru/api/v1/config/clusterversion \<br>
	--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ </code>		--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ </code>

			=== Используя параметр запроса ===
			Вы можете пройти аутентификацию, добавив токен в качестве значения параметра запроса api-token.

			<code>
			curl --request GET \<br>
			--url 'https://mySampleEnv.live.dynatrace.com/api/v1/config/clusterversion?api-token=abcdefjhij1234567890' \ </code>


			== Аутентификация в API Explorer ==
			Выберите значок замока рядом с любым эндпоинтом, чтобы отобразить информацию о токенах API, которые защищают этот эндпоинт. Каждый эндпоинт требует определенного типа токена.

			Вы также можете разблокировать все эндпоинты, выбрав '''Авторизовать'''. В отображаемом диалоговом окне вы можете увидеть, какие разрешения токена необходимы для каждого эндпоинта API. Введя свой токен API в диалоговое окно Доступные авторизации , вы можете разблокировать все связанные эндпоинты API.

DKashanov в 11:15, 3 декабря 2021

2021-12-03T11:15:10Z

← Предыдущая		Версия 11:15, 3 декабря 2021
Строка 92:		Строка 92:
	<code>		<code>
	curl --request GET \<br>		curl --request GET \<br>
	--url https://mySampleEnv.~~live~~.~~dynatrace.com~~/api/v1/config/clusterversion \<br>		--url https://mySampleEnv.ruscomtech.ru/api/v1/config/clusterversion \<br>
	--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ </code>		--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ </code>

DKashanov в 11:13, 3 декабря 2021

2021-12-03T11:13:43Z

← Предыдущая		Версия 11:13, 3 декабря 2021
Строка 81:		Строка 81:
	\|Предоставляет доступ к POST, PUT и DELETE запросам [[API токенов аутентификации]]		\|Предоставляет доступ к POST, PUT и DELETE запросам [[API токенов аутентификации]]
	\|}		\|}

			== Аутентификация ==
			У вас есть два варианта передачи токена API: в HTTP-заголовке авторизации или в параметре запроса '''api-token''' .

			Мы рекомендуем использовать заголовок авторизации, поскольку URL-адреса (вместе с переданными в них токенами) могут регистрироваться в разных местах. Пользователи также могут добавлять URL-адреса в закладки или делиться ими в виде обычного текста. Следовательно, размещение токенов аутентификации в URL-адресе увеличивает риск того, что они будут захвачены злоумышленником.

			=== Используя заголовок HTTP ===
			Вы можете пройти аутентификацию, прикрепив токен к HTTP-заголовку авторизации. В следующем примере показана аутентификация через HTTP-заголовок:<br>

			<code>
			curl --request GET \<br>
			--url https://mySampleEnv.live.dynatrace.com/api/v1/config/clusterversion \<br>
			--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ </code>

DKashanov в 10:39, 3 декабря 2021

2021-12-03T10:39:49Z

← Предыдущая		Версия 10:39, 3 декабря 2021
Строка 63:		Строка 63:
	\|metrics.write		\|metrics.write
	\|Предоставляет доступ к [[удалению пользовательской метрики]] для запроса к Metrics API v2.		\|Предоставляет доступ к [[удалению пользовательской метрики]] для запроса к Metrics API v2.
			\|}

			=== Токен персонального доступа ===
			Ключ-АСТРОМ предоставляет следующие разрешения для токенов личного доступа. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]].<br>

			{\| class="wikitable"
			!Имя
			!Значение API
			!Описание
			\|-
			\|Чтение токенов API
			\|apiTokens.read
			\|Предоставляет доступ к GET запросам [[API токенов аутентификации]]
			\|-
			\|Запись токенов API
			\|apiTokens.write
			\|Предоставляет доступ к POST, PUT и DELETE запросам [[API токенов аутентификации]]
	\|}		\|}

DKashanov в 10:34, 3 декабря 2021

2021-12-03T10:34:34Z

← Предыдущая		Версия 10:34, 3 декабря 2021
Строка 18:		Строка 18:
	# Введите имя для вашего токена.		# Введите имя для вашего токена.
	# Выберите необходимые разрешения для токена.		# Выберите необходимые разрешения для токена.
	# Выберите ~~« Создать»~~ .		# Выберите «Создать» .
	# Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем.<br>		# Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем.<br>
	'''Вы можете получить доступ к своему токену только один раз после его создания.'''		'''Вы можете получить доступ к своему токену только один раз после его создания.'''
Строка 36:		Строка 36:
	# Введите имя для вашего токена.		# Введите имя для вашего токена.
	# Выберите необходимые разрешения для токена.		# Выберите необходимые разрешения для токена.
	# Выберите ~~« Создать»~~ .		# Выберите «Создать» .
	# Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем.<br>		# Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем.<br>
	'''Вы можете получить доступ к своему токену только один раз после его создания.'''		'''Вы можете получить доступ к своему токену только один раз после его создания.'''
Строка 45:		Строка 45:

	Ключ-АСТРОМ не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.		Ключ-АСТРОМ не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.

			== Разрешения токена ==
			=== Токен API ===
			Ключ-АСТРОМ предоставляет следующие разрешения для токенов API. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]]. Некоторые области доступны только через API.<br>

			{\| class="wikitable"
			\|+API v2
			!Имя
			!Значение API
			!Описание
			\|-
			\|Чтение метрик
			\|metrics.read
			\|Предоставляет доступ к GET-запросам [[Metrics API v2]] .
			\|-
			\|Запись метрик
			\|metrics.write
			\|Предоставляет доступ к [[удалению пользовательской метрики]] для запроса к Metrics API v2.
			\|}

DKashanov: Новая страница: «Чтобы пройти аутентификацию для использования Ключ-АСТРОМ API, вам понадобится действующ...»

2021-12-03T10:21:35Z

Новая страница: «Чтобы пройти аутентификацию для использования Ключ-АСТРОМ API, вам понадобится действующ...»

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

Чтобы пройти аутентификацию для использования Ключ-АСТРОМ API, вам понадобится действующий [[токен доступа]] или действительный [[токен личного доступа]] . Доступ к API детализирован, что означает, что вам также потребуются соответствующие разрешения, назначенные токену. См. описание каждого запроса, чтобы узнать, какие разрешения требуются для его использования.

== Формат токена ==
Ключ-АСТРОМ использует уникальный формат токенов, состоящий из трех компонентов, разделенных точками (.). Например:<br>
dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM

* dt0c01 - Префикс для идентификации токена.
* ST2...7YN - Открытая часть токена. 24-значный открытый идентификатор токена. Это значение можно безопасно отображать в пользовательском интерфейсе и использовать для ведения журнала.
* G3D...RZM - Секретная часть токена. 64-символьная секретная часть токена, которую можно рассматривать как пароль, поэтому она не отображается в веб-интерфейсе Ключ-АСТРОМ (после первоначального создания) и не сохраняется в файлах журнала.

== Создание токена ==
=== Токен API ===
Чтобы сгенерировать токен доступа

# В меню Ключ-АСТРОМ выберите маркеры доступа.
# Выберите Создать новый токен .
# Введите имя для вашего токена.
# Выберите необходимые разрешения для токена.
# Выберите « Создать» .
# Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем.<br>
'''Вы можете получить доступ к своему токену только один раз после его создания.'''

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

В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена.

Ключ-АСТРОМ не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.

=== Токен персонального доступа ===
Для создания токена личного доступа

# Выберите меню пользователя в правом верхнем углу страницы.
# Выберите токены личного доступа .
# Выберите Создать новый токен .
# Введите имя для вашего токена.
# Выберите необходимые разрешения для токена.
# Выберите « Создать» .
# Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем.<br>
'''Вы можете получить доступ к своему токену только один раз после его создания.'''

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

В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена личного доступа.

Ключ-АСТРОМ не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.