Токены доступа

• Токен владельца

Ключ-АСТРОМ 1.227+

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

Весь внешний доступ к вашей среде мониторинга Ключ-АСТРОМ зависит от двух частей информации: идентификатора среды и токена доступа .

Ключ-АСТРОМ использует несколько типов токенов:

• Жетоны доступа и токены личного доступа предоставляют доступ к:
  • Ключ-АСТРОМ API
  • Загрузка установщиков OneAgent и АктивныйШлюз
  • Доступ к интеграции модулей
• Токены клиента позволяют OneAgent передавать данные в Ключ-АСТРОМ.

Формат токена

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

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» .

Создать токен доступа

Чтобы сгенерировать токен доступа

1. В меню Ключ-АСТРОМ выберите маркеры доступа .
2. Выберите Создать новый токен .
3. Введите имя для вашего токена.
4. Выберите необходимые разрешения для токена.
5. Выберите « Создать» .
6. Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем. Вы можете получить доступ к своему токену только один раз после создания. Вы не сможете потом раскрыть это.

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

В качестве альтернативы вы можете использовать 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
Загрузите установщики OneAgent и АктивныйШлюз	InstallerDownload	Позволяет скачивать установщики через Deployment API .
Создание предупреждений о поддержке	SupportAlert	Позволяет создавать оповещения службы поддержки для анализа сбоев.
Модули
Интеграция AppMon для гибридных развертываний	AppMonIntegration	Позволяет импортировать данные мониторинга из AppMon .
Интеграция с Ключ-АСТРОМ NAM	DcrumIntegration	Интеграция с NAM.
Другой
Загрузите плагины с помощью командной строки	PluginUpload	Позволяет загружать расширения OneAgent через инструмент командной строки .