Токены доступа
Начало работы с Ключ-АСТРОМ / Токены доступа
Ключ-АСТРОМ 1.227+
На этой странице описан подход к пользовательскому интерфейсу, доступный начиная с Ключ-АСТРОМ версии 1.227. Процедуру для более старой версии смотрите в описании устаревшей версии . В качестве альтернативы вы можете использовать Tokens API v2 .
Весь внешний доступ к вашей среде мониторинга Ключ-АСТРОМ зависит от двух частей информации: идентификатора среды и токена доступа .
Ключ-АСТРОМ использует несколько типов токенов:
- Токены доступа и токены личного доступа предоставляют доступ к:
- Ключ-АСТРОМ API
- Загрузка установщиков ЕдиногоАгента и АктивногоШлюза
- Токены личного доступа предоставляют доступ к некоторым конечным точкам Ключ-АСТРОМ API
- Токены клиента позволяют ЕдиномуАгенту передавать данные в Ключ-АСТРОМ.
Формат токена
Ключ-АСТРОМ использует уникальный формат токенов, состоящий из трех компонентов, разделенных точками ( .).
dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM
dt0c01
|
Префикс для идентификации токена. |
ST2...7YN
|
Открытая часть токена
24-значный открытый идентификатор токена. Это значение можно безопасно отображать в пользовательском интерфейсе и использовать для ведения журнала. |
G3D...RZM
|
Секретная часть токена
64-символьная секретная часть токена, которую можно рассматривать как пароль, поэтому ее не нужно отображать в веб-интерфейсе Ключ-АСТРОМ (после первоначального создания) или сохранять в файлах журнала. |
Предсказуемый формат дает вам несколько преимуществ, таких как:
- Использование хуков предварительной фиксации Git, чтобы избежать отправки токенов в репозитории исходного кода (например, с помощью таких инструментов, как git-secrets )
- Определение правил маскирования для сокрытия секретных частей токенов при записи файлов журналов
- Обнаружение токенов во внутренних файлах или сообщениях
- Включение службы сканирования секретов GitHub для идентификации любого токена, отправленного в общедоступный репозиторий GitHub
Используйте это регулярное выражение для поиска токенов:
dt0[a-zA-Z]{1}[0-9]{2}\.[A-Z0-9]{24}\.[A-Z0-9]{64}
С выпуском Ключ-АСТРОМ версии 1.210 этот формат включен по умолчанию (все вновь сгенерированные токены будут использовать новый формат).
Все существующие токены старого формата остаются в силе.
Отключить новый формат
В течение ограниченного времени у вас есть возможность отказаться от использования нового формата токена. Вы можете найти настройку здесь:
- SaaS и управляемое окружениеПерейдите в Настройки> Интеграция> Настройки токена .
- Управляемый кластерВ веб-интерфейсе CMC выберите «Настройки»> «Токены API» .
Создать токен доступа
Чтобы сгенерировать токен доступа
- В меню Ключ-АСТРОМ выберите маркеры доступа .
- Выберите Создать новый токен .
- Введите имя для вашего токена.
- Выберите необходимые разрешения для токена.
- Выберите « Создать» .
- Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем. Вы можете получить доступ к своему токену только один раз после создания. Вы не сможете потом раскрыть это.
Вы можете назначить несколько разрешений одному токену или сгенерировать несколько токенов, каждый с разными уровнями доступа, и использовать их соответствующим образом - проверьте политики безопасности вашей организации, чтобы получить наилучшие рекомендации.
В качестве альтернативы вы можете использовать POST вызов токена API токенов аутентификации API для создания токена.
Ключ-АСТРОМ не требует уникальных имен токенов. Вы можете создать несколько токенов с одним и тем же именем. Обязательно укажите понятное имя для каждого генерируемого токена. Правильное именование поможет вам эффективно управлять своими токенами и, возможно, удалять их, когда они больше не нужны.
Объемы токенов
У токенов доступа есть детализированные области действия, чтобы ограничить доступ к определенным функциям продукта по соображениям безопасности.
Ключ-АСТРОМ предоставляет следующие разрешения для токенов API. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через API токенов аутентификации API . Некоторые области доступны только через API.
| Имя | Значение API | Описание |
|---|---|---|
API v2 | ||
| Читать метрики | metrics.read
|
Предоставляет доступ к запросам GET Metrics API v2 . |
| Напишите метрики | metrics.write
|
Предоставляет доступ к DELETE для запроса пользовательской метрики Metrics API v2. |
| Показатели приема | metrics.ingest
|
Предоставляет доступ к запросу точек данных POST для Metrics v2 API. |
| Читать журналы | logs.read
|
Предоставляет доступ к запросам GET API мониторинга журналов версии 2. |
| Журналы приема | logs.ingest
|
Предоставляет доступ к запросу журналов приема POST API мониторинга журналов v2. |
| Получение следов OpenTelemetry | openTelemetryTrace.ingest
|
Позволяет получать следы OpenTelemetry . |
| Читать сущности | entities.read
|
Предоставляет доступ к запросам GET отслеживаемых объектов и API настраиваемых тегов . |
| Запись сущностей | entities.write
|
Предоставляет доступ к запросам POST, PUT и DELETE отслеживаемых объектов и API настраиваемых тегов . |
| Проблемы с чтением | problems.read
|
Предоставляет доступ к запросам GET API проблем v2 . |
| Проблемы с записью | problems.write
|
Предоставляет доступ к запросам POST, PUT и DELETE API проблем v2 . |
| Читать события | events.read
|
Предоставляет доступ к запросам GET для Events API v2 . |
| Принять события | events.ingest
|
Предоставляет доступ к POST-запросу Events API v2 . |
| Чтение сетевых зон | networkZones.read
|
Предоставляет доступ к GET-запросам API сетевых зон . |
| Запись сетевых зон | networkZones.write
|
Предоставляет доступ к запросам POST, PUT и DELETE API сетевых зон . |
| Читать АктивныйШлюзs | activeGates.read
|
Предоставляет доступ к GET-запросам АктивныйШлюзs API . |
| Написать АктивныйШлюзs | activeGates.write
|
Предоставляет доступ к запросам POST и DELETE API АктивныйШлюзs . |
| Читать расширения | extensions.read
|
Предоставляет доступ к GET запросов от Extensions секции Extensions 2.0 API . |
| Написать расширения | extensions.write
|
Предоставляет доступ к POST и DELETE запросов от Extensions секции Extensions 2.0 API . |
| Чтение конфигурации среды расширений | extensionEnvironment.read
|
Предоставляет доступ к запросам GET из раздела конфигурации среды Extensions API Extensions 2.0 . |
| Конфигурация среды написания расширений | extensionEnvironment.write
|
Предоставляет доступ к запросам POST, PUT и DELETE из раздела конфигурации среды Extensions API Extensions 2.0 . |
| Чтение конфигурации мониторинга расширений | extensionConfigurations.read
|
Предоставляет доступ к запросам GET из раздела конфигурации мониторинга расширений API расширений 2.0 . |
| Запись конфигурации мониторинга расширений | extensionConfigurations.write
|
Предоставляет доступ к запросам POST, PUT и DELETE из раздела конфигурации мониторинга расширений API расширений 2.0 . |
| Прочтите проблемы безопасности | securityProblems.read
|
Предоставляет доступ к запросам GET API проблем безопасности . |
| Проблемы безопасности записи | securityProblems.write
|
Предоставляет доступ к POST-запросам API проблем безопасности . |
| Читать синтетические локации | syntheticLocations.read
|
Предоставляет доступ к запросам GET API синтетических расположений v2 и API синтетических узлов v2 . |
| Напишите синтетические местоположения | syntheticLocations.write
|
Предоставляет доступ к запросам POST, PUT и DELETE API синтетических расположений v2 и API синтетических узлов v2 . |
| Прочитать настройки | settings.read
|
Предоставляет доступ к запросам GET API настроек . |
| Записать настройки | settings.write
|
Предоставляет доступ к запросам POST и DELETE API настроек . |
| Ротация токенов арендатора | tenantTokenRotation.write
|
Предоставляет доступ к API токенов клиента . |
| Читать SLO | slo.read
|
Предоставляет доступ к запросам GET API целей уровня обслуживания . |
| Написать SLO | slo.write
|
Предоставляет доступ к запросам POST, PUT и DELETE API целей уровня обслуживания . |
| Читать токены API | apiTokens.read
|
Предоставляет доступ к запросам GET API токенов аутентификации API . |
| Написать токены API | apiTokens.write
|
Предоставляет доступ к запросам POST, PUT и DELETE API токенов аутентификации API . |
| Читать релизы | releases.read
|
Предоставляет доступ к Releases API . |
| Читать журналы аудита | auditLogs.read
|
Предоставляет доступ к журналу аудита . |
API v1 | ||
| Чтение записей хранилища учетных данных | credentialVault.read
|
Предоставляет доступ к запросам GET API хранилища учетных данных . |
| Запись записей в хранилище учетных данных | credentialVault.write
|
Предоставляет доступ к запросам POST, PUT и DELETE API хранилища учетных данных . |
| Проблемы доступа и лента событий, метрики и топология | DataExport
|
Предоставляет доступ к различным вызовам Environment API . |
| Создание и чтение синтетических мониторов, локаций и узлов | ExternalSyntheticIntegration
|
Предоставляет доступ к синтетическому API . |
| Чтение синтетических мониторов, локаций и узлов | ReadSyntheticData
|
Предоставляет доступ к запросам GET синтетического API . |
| Прочитать конфигурацию | ReadConfig
|
Предоставляет доступ к GET-вызовам Configuration API . |
| Запись конфигурации | WriteConfig
|
Предоставляет доступ к вызовам POST, PUT и DELETE Configuration API . |
| Изменить настройки конфиденциальности данных | DataPrivacy
|
Предоставляет доступ к API конфиденциальности данных и вызовам API конфигурации веб-приложений для обеспечения конфиденциальности данных . |
| Пользовательские сеансы | DTAQLAccess
|
Предоставляет доступ к API пользовательских сессий . |
| Анонимизируйте пользовательские сеансы по соображениям конфиденциальности данных | UserSessionAnonymization
|
Предоставляет доступ к API анонимизации . |
| Управление файлами мобильной символики | DssFileManagement
|
Предоставляет доступ к API мобильной символики . |
| Управление тегами JavaScript Real User Monitoring | RumJavaScriptTagManagement
|
Предоставляет доступ к Real User Monitoring JavaScript API . |
| Управление токенами | TenantTokenManagement
|
Позволяет создавать и удалять токены, а также просматривать их метаданные через Tokens API . |
| Управление сертификатами АктивныйШлюз | ActiveGateCertManagement
|
Позволяет настроить сертификат на частных АктивныйШлюзs. |
| Получение данных | DataImport
|
Позволяет импортировать данные и события из внешних источников. |
| Получение данных из удаленной среды | RestRequestForwarding
|
Позволяет получать данные из удаленных сред Ключ-АСТРОМ для мониторинга нескольких сред. |
| Захват данных запроса | CaptureRequestData
|
Предоставляет доступ к API атрибутов запроса . |
| Прочитать содержимое журнала | LogExport
|
Предоставляет доступ к API мониторинга журналов . |
| Расширение браузера RUM | RumBrowserExtension
|
Разрешает расширению браузера RUM отправлять данные в Ключ-АСТРОМ. |
PaaS | ||
| Загрузите установщики ЕдиныйАгент и АктивныйШлюз | InstallerDownload
|
Позволяет скачивать установщики через Deployment API . |
| Создание предупреждений о поддержке | SupportAlert
|
Позволяет создавать оповещения службы поддержки для анализа сбоев. |
Модули | ||
| Интеграция AppMon для гибридных развертываний | AppMonIntegration
|
Позволяет импортировать данные мониторинга из AppMon . |
| Интеграция с Ключ-АСТРОМ NAM | DcrumIntegration
|
Интеграция с NAM. |
Другой | ||
| Загрузите плагины с помощью командной строки | PluginUpload
|
Позволяет загружать расширения ЕдиныйАгент через инструмент командной строки . |
