ENetrebin в 15:44, 12 декабря 2025

2025-12-12T15:44:59Z

RGolovanov: Новая страница: «Внешний доступ к среде мониторинга зависит от '''идентификатора среды''' и '''''то...»

2022-09-13T14:54:00Z

Новая страница: «Внешний доступ к среде мониторинга зависит от '''идентификатора среды''' и '''''то...»

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

Внешний доступ к среде мониторинга зависит от '''[[ID среды|идентификатора среды]]''' и '''''токена доступа'''''.

В Ключ-АСТРОМ применяются:

* '''Токены доступа''' и '''токены личного доступа''', которые обеспечивают работу с [[API Ключ-АСТРОМ]] и [[Интеграции|интеграциям]]<nowiki/>и, а также загрузку ЕдиногоАгента и АктивногоШлюза.
* '''Токены среды''', разрешающие отправку данных ЕдиногоАгента Ключу-АСТРОМ.

== Формат токена ==
В Ключе-АСТРОМ токен разделяется точками <code>( . )</code> на три компонента.

<code>dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM</code>

Часть токена, состоящая из префикса и открытой части токена, является '''идентификатором токена'''. Например, <code>dt0c01.ST2EY72KQINMH574WMNVI7YN</code>. Идентификатор токена может безопасно отображаться в интерфейсе и использоваться в логах.

<code>dt0c01</code> — '''префикс''', определяющий тип токена.

<code>ST2...7YN</code> — '''открытая часть токена''' — 24-значный публичный идентификатор токена.

<code>G3D...RZM</code> — '''секретная часть токена''' — 64-значная часть токена, являющаяся паролем. Не должна отображаться в веб-интерфейсе Ключа-АСТРОМ или храниться в логах.

Компонентный формат токена имеет ряд преимуществ:

* Избегание пуша токена в Git-репозитории при помощи pre-commit хуков,
* Определение правил маскирования данных для обфускации секретной части токена при записи в логи,
* Обнаружение токенов в файлах и коммуникациях,
* Включение [https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning#about-secret-scanning-for-public-repositories службы сканирования секретных данных GitHub] для поиска всех токенов в публичном репозитории

Для поиска токенов используйте регулярное выражение:

<code>dt0[a-zA-Z]{1}[0-9]{2}\.[A-Z0-9]{24}\.[A-Z0-9]{64}</code>

Начиная с версии Ключ-АСТРОМ 1.210, данный формат используется по умолчанию. Ранее созданные токены старого формата действительны.

=== Выключить новый формат ===
В течение ограниченного времени Вы можете отказаться от использования нового формата токенов:

* SaaS и Менеджер окружения — '''Настройки''' '''> Интеграция > Настройки токена.'''
* Менеджер кластера — '''Настройки > API токены.'''

== Создание токена доступа ==
Для создания токена доступа, выполните следующие шаги:

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

== Разрешения токена ==
В целях безопасности Вы можете ограничить доступ к определённой функциональности при помощи разрешений. Разрешения устанавливаются в веб-интерфейсе или через [[API Токенов доступа]].
{| class="wikitable"
|+
!Название
!Значение API
!Описание
|-
| colspan="3" |'''API v2'''
|-
|Чтение метрик
|<code>metrics.read</code>
|Доступ к GET-запросам API Метрики v2
|-
|Запись метрик
|<code>metrics.write</code>
|Доступ к DELETE-запросам API Метрики v2
|-
|Анализ метрик
|<code>metrics.ingest</code>
|Доступ к POST-запросам анализа API Метрики v2
|-
|Чтение логов
|<code>logs.read</code>
|Доступ к GET-запросам API МониторингЛогов v2
|-
|Анализ логов
|<code>logs.ingest</code>
|Доступ к POST-запросам анализа API МониторингЛогов v2
|-
|Анализ ОткрытойТелеметрии
|<code>openTelemetryTrace.ingest</code>
|Доступ к анализу следов ОткрытойТелеметрии
|-
|Поиск следа
|<code>traces.lookup</code>
|Проверяет присутствие следа в трейсинге между средами
|-
|Чтение объектов
|<code>entities.read</code>
|Доступ к GET-запросам API Отслеживаемые объекты и Пользовательские Теги
|-
|Анализ объектов
|<code>entities.write</code>
|Доступ к POST, PUT и DELETE-запросам API Отслеживаемые объекты и Пользовательские Теги
|-
|Чтение проблем
|<code>problems.read</code>
|Доступ к GET-запросам API Проблемы v2
|-
|Запись проблем
|<code>problems.write</code>
|Доступ к POST, PUT и DELETE-запросам API Проблемы v2
|-
|Чтение событий
|<code>events.read</code>
|Доступ к GET-запросам API События v2
|-
|Анализ событий
|<code>events.ingest</code>
|Доступ к POST-запросам API События v2
|-
|Чтение сетевых зон
|<code>networkZones.read</code>
|Доступ к GET-запросам API Сетевые Зоны v2
|-
|Запись сетевых зон
|<code>networkZones.write</code>
|Доступ к POST, PUT и DELETE-запросам API Сетевые Зоны
|-
|Чтение АктивныхШлюзов
|<code>activeGates.read</code>
|Доступ к GET-запросам API Активных Шлюзов
|-
|Запись АктивныхШлюзов
|<code>activeGates.write</code>
|Доступ к POST, PUT и DELETE-запросам API Активных Шлюзов
|-
|Чтение токенов АктивныхШлюзов
|<code>activeGateTokenManagement.read</code>
|Доступ к GET-запросам API Токенов Активных Шлюзов
|-
|Создание токенов АктивныхШлюзов
|<code>activeGateTokenManagement.create</code>
|Доступ к POST-запросам API Токенов Активных Шлюзов
|-
|Запись токенов АктивныхШлюзов
|<code>activeGateTokenManagement.write</code>
|Доступ к POST и DELETE-запросам API Токенов Активных Шлюзов
|-
|Чтение расширений
|<code>extensions.read</code>
|Доступ к GET-запросам API Расширения 2.0
|-
|Запись расширений
|<code>extensions.write</code>
|Доступ к POST и DELETE-запросам API Расширения
|-
|Чтение конфигурации расширений среды
|<code>extensionEnvironment.read</code>
|Доступ к GET-запросам API Расширения Конфигурации Окружения 2.0
|-
|Запись конфигурации расширений среды
|<code>extensionEnvironment.write</code>
|Доступ к POST, PUT и DELETE-запросам API Расширения Конфигурации Окружения 2.0
|-
|Чтение конфигурации расширений мониторинга
|<code>extensionConfigurations.read</code>
|Доступ к GET-запросам API Расширения Мониторинга Окружения 2.0
|-
|Запись конфигурации расширений мониторинга
|<code>extensionConfigurations.write</code>
|Доступ к POST, PUT и DELETE-запросам API Расширения Мониторинга Окружения 2.0
|-
|Чтение проблем безопасности
|<code>securityProblems.read</code>
|Доступ к GET-запросам API Проблемы Безопасности
|-
|Запись проблем безопасности
|<code>securityProblems.write</code>
|Доступ к POST-запросам API Проблемы Безопасности
|-
|Чтение синтетических локаций
|<code>syntheticLocations.read</code>
|Доступ к GET-запросам API Синтетические Локации v2 и API Синтетические Ноды v2
|-
|Запись синтетических локаций
|<code>syntheticLocations.write</code>
|Доступ к POST, PUT и DELETE-запросам API Синтетические Локации v2 и API Синтетические Ноды v2
|-
|Чтение настроек
|<code>settings.read</code>
|Доступ к GET-запросам к API Настроек
|-
|Запись настроек
|<code>settings.write</code>
|Доступ к POST и DELETE-запросам к API Настроек
|-
|Ротация токена среды
|<code>tenantTokenRotation.write</code>
|Доступ к API Токенов Среды
|-
|Чтение SLO
|<code>slo.read</code>
|Доступ к GET-запросам к API SLO
|-
|Запись SLO
|<code>slo.write</code>
|Доступ к POST, PUT и DELETE-запросам к API SLO
|-
|Чтение API-токенов
|<code>apiTokens.read</code>
|Доступ к GET-запросам к API Токенов Доступа
|-
|Запись API-токенов
|<code>apiTokens.write</code>
|Доступ к POST, PUT и DELETE-запросам к API Токенов Доступа
|-
|Чтение релизов
|<code>releases.read</code>
|Доступ к API Релизы
|-
|Чтение логов аудита
|<code>auditLogs.read</code>
|Доступ к API Журнала Аудита
|-
|Чтение географических регионов
|<code>geographicRegions.read</code>
|Доступ к API Географических Регионов
|-
|Чтение результатов синтетического мониторинга
|<code>syntheticExecutions.read</code>
|Доступ к GET-запросам к API <code>/synthetic/executions</code>
|-
|Запись результатов синтетического мониторинга
|<code>syntheticExecutions.write</code>
|Доступ к POST-запросам к API <code>/synthetic/executions</code>
|-
| colspan="3" |'''API v1'''
|-
|Чтение объектов хранилища данных
|<code>credentialVault.read</code>
|Доступ к GET-запросам к API Хранилища Данных
|-
|Запись объектов хранилища данных
|<code>credentialVault.write</code>
|Доступ к POST, PUT и DELETE-запросам к API Хранилища Данных
|-
|Проблемы с доступом, журнал событий, метрики и топология
|<code>DataExport</code>
|Доступ к различным вызовам к API Окружения
|-
|Создание и запись синтетических мониторов, локаций и нод
|<code>ExternalSyntheticIntegration</code>
|Доступ к API Синтетика
|-
|Чтение синтетических мониторов, локаций и нод
|<code>ReadSyntheticData</code>
|Доступ к GET-запросам к API Синтетика
|-
|Чтение конфигурации
|<code>ReadConfig</code>
|Доступ к GET-запросам к API Конфигурации
|-
|Запись конфигурации
|<code>WriteConfig</code>
|Доступ к POST, PUT и DELETE-запросам к API Конфигурации
|-
|Изменение настроек конфиденциальности данных
|<code>DataPrivacy</code>
|Доступ к API Конфиденциальности данных и вызовам к API Конфигурации веб-приложений
|-
|Пользовательские сессии
|<code>DTAQLAccess</code>
|Доступ к API Пользовательских сессий
|-
|Анонимизировать пользовательские сессии для конфиденциальности
|<code>UserSessionAnonymization</code>
|Доступ к API Анонимизации
|-
|Менеджмент файла мобильной символизации
|<code>DssFileManagement</code>
|Доступ к API Мобильной Символизации
|-
|Менеджмент JavaScript-тега Мониторинга Реального Пользователя
|<code>RumJavaScriptTagManagement</code>
|Доступ к API Мониторинга Реального Пользователя посредством JS
|-
|Менеджмент сертификата АктивногоШлюза
|<code>ActiveGateCertManagement</code>
|Конфигурация сертификата на частном АктивномШлюзе
|-
|Анализ данных
|<code>DataImport</code>
|Импорт данных и событий с внешних источников
|-
|Получение данных с удалённого окружения
|<code>RestRequestForwarding</code>
|Скачивание данных с удалённых окружений для создания дашбордов между окружениями
|-
|Захват данных запроса
|<code>CaptureRequestData</code>
|Доступ к API Атрибуты запросов
|-
|Чтение содержимого лога
|<code>LogExport</code>
|Доступ к API Мониторинга Логов
|-
|Браузерное расширение Мониторинга Реального Пользователя
|<code>RumBrowserExtension</code>
|Отправка браузерным расширением Мониторинга Реального Пользователя данных Ключу-АСТРОМ
|-
| colspan="3" |'''PaaS'''
|-
|Скачивание установщиков ЕдиногоАгента и АктивногоШлюза
|<code>InstallerDownload</code>
|Скачивание установщиков через API Развёртки
|-
|Создание уведомления поддержки
|<code>SupportAlert</code>
|Создание уведомления поддержки для анализа сбоев
|-
| colspan="3" |'''Другое'''
|-
|Загрузить плагины через командную строку
|<code>PluginUpload</code>
|Загрузка расширения ЕдиногоАгента через командную строку
|}

← Предыдущая		Версия 15:44, 12 декабря 2025
Строка 1:		Строка 1:
	Внешний доступ к среде мониторинга зависит от '''[[ID среды\|идентификатора среды]]''' и '''''токена доступа'''''.		Внешний доступ к среде мониторинга зависит от '''[[ID среды\|идентификатора среды]]''' и '''''токена доступа'''''.

	В ~~Ключ-АСТРОМ~~ применяются:		В Dynatrace применяются:

	* '''Токены доступа''' и '''токены личного доступа''', которые обеспечивают работу с [[API Ключ-АСТРОМ]] и [[Интеграции\|интеграциям]]<nowiki/>и, а также загрузку ЕдиногоАгента и АктивногоШлюза.		* '''Токены доступа''' и '''токены личного доступа''', которые обеспечивают работу с [[API Ключ-АСТРОМ\|API Dynatrace]] и [[Интеграции\|интеграциям]]<nowiki/>и,<nowiki/> а также загрузку ЕдиногоАгента и АктивногоШлюза.
	* '''Токены среды''', разрешающие отправку данных ЕдиногоАгента Ключу-АСТРОМ.		* '''Токены среды''', разрешающие отправку данных ЕдиногоАгента Ключу-АСТРОМ.

Строка 30:		Строка 30:
	<code>dt0[a-zA-Z]{1}[0-9]{2}\.[A-Z0-9]{24}\.[A-Z0-9]{64}</code>		<code>dt0[a-zA-Z]{1}[0-9]{2}\.[A-Z0-9]{24}\.[A-Z0-9]{64}</code>

	Начиная с версии ~~Ключ-АСТРОМ~~ 1.210, данный формат используется по умолчанию. Ранее созданные токены старого формата действительны.		Начиная с версии Dynatrace 1.210, данный формат используется по умолчанию. Ранее созданные токены старого формата действительны.

	=== Выключить новый формат ===		=== Выключить новый формат ===
Строка 41:		Строка 41:
	Для создания токена доступа, выполните следующие шаги:		Для создания токена доступа, выполните следующие шаги:

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

Токен доступа - История изменений

ENetrebin в 15:44, 12 декабря 2025

RGolovanov: Новая страница: «Внешний доступ к среде мониторинга зависит от '''идентификатора среды''' и '''''то...»