Расширенная конфигурация ЕдиногоАгента для iOS - История изменений

IKuznetsov в 19:31, 2 января 2025

2025-01-02T19:31:53Z

← Предыдущая версия		Версия от 19:31, 2 января 2025
Строка 1:		Строка 1:
			'''''[[Модули платформы]] / [[Модули платформы\|Цифровой опыт]] / [https://docs.expert-apm.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#:~:text=%D0%9C%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F Мобильные приложения] / [https://docs.expert-apm.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#:~:text=%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%B4%D0%BB%D1%8F%20iOS Инструментальные приложения для iOS] / Расширенная конфигурация ЕдиногоАгента для iOS'''''

	Процесс автоинструментирования настраивает ваши приложения iOS для мониторинга с помощью ЕдиныйАгент. Этот автоматизированный способ добавления ЕдиныйАгент в приложение без необходимости вручную изменять его исходный код. Автоинструментированное приложение эквивалентно приложению, которое было вручную инструментировано для сбора базовых данных. Такой уровень инструментирования предоставляет видимость реального пользовательского опыта, обеспечиваемого вашим приложением. Он также позволяет обнаруживать сбои и отслеживать производительность, связанную с запуском приложений и временем ответа на веб-запросы.		Процесс автоинструментирования настраивает ваши приложения iOS для мониторинга с помощью ЕдиныйАгент. Этот автоматизированный способ добавления ЕдиныйАгент в приложение без необходимости вручную изменять его исходный код. Автоинструментированное приложение эквивалентно приложению, которое было вручную инструментировано для сбора базовых данных. Такой уровень инструментирования предоставляет видимость реального пользовательского опыта, обеспечиваемого вашим приложением. Он также позволяет обнаруживать сбои и отслеживать производительность, связанную с запуском приложений и временем ответа на веб-запросы.

IKuznetsov в 14:12, 26 декабря 2024

2024-12-26T14:12:53Z

ENetrebin: Новая страница: «Процесс автоинструментирования настраивает ваши приложения iOS для мониторинга с помощь...»

2023-05-18T17:08:32Z

Новая страница: «Процесс автоинструментирования настраивает ваши приложения iOS для мониторинга с помощь...»

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

Процесс автоинструментирования настраивает ваши приложения iOS для мониторинга с помощью ЕдиныйАгент. Этот автоматизированный способ добавления ЕдиныйАгент в приложение без необходимости вручную изменять его исходный код. Автоинструментированное приложение эквивалентно приложению, которое было вручную инструментировано для сбора базовых данных. Такой уровень инструментирования предоставляет видимость реального пользовательского опыта, обеспечиваемого вашим приложением. Он также позволяет обнаруживать сбои и отслеживать производительность, связанную с запуском приложений и временем ответа на веб-запросы.

= 1. Настройка Public Key Hash Pinning (PKH) pinning с помощью Ключ-АСТРОМ =
Вы можете использовать функцию Public Key Hash Pinning (PKH) для аутентификации.
{| class="wikitable"
|❗ '''''Важно'''''

''Public key pinning сопряжено с риском и может вызвать проблемы, если его настроить неправильно. Если вы допустили ошибку, ваше приложение может закрепить набор ключей, которые подтверждают аутентификацию сегодня, но перестанут работать в какой-то момент в будущем. В таком случае ваше приложение больше не сможет подключаться к серверу и, скорее всего, перестанет работать, пока не будет обновлено новым набором ключей.''
|}

# Перейдите в дистрибутив ЕдиныйАгент, откройте папку '''Certificate Pinning''' и запустите скрипт '''getPKHashFromCertificate.py''' для генерации хэшей из ваших сертификатов.

python getPKHashFromCertificate.py <path to your cert>.<der|pem> --type <DER | PEM>

Вывод должен выглядеть так:

CERTIFICATE INFO

<nowiki>----------------</nowiki>

subject= *****

issuer= *****

SHA1 Fingerprint= ******

<nowiki>----------------------</nowiki> DTXDomainPins item ----------------------

DTXPKHash: SomePublicKeyHash=

DTXPKHashAlgoritm: DTXAlgorithmRsa2048

# В вашем файле '''Info.plist''' используйте вывод скрипта в качестве массива в ключе '''DTXPublicKeyPins'''.

<key>DTXPublicKeyPins</key>

<array>

<dict>

<key>DTXPKHash</key>

<string>SomePublicKeyHash=</string>

<key>DTXPKHashAlgoritm</key>

<string>DTXAlgorithmRsa2048</string>

</dict>

<dict>...script output 2...</dict>

<dict>...script output 3...</dict>

</array>

{| class="wikitable"
|❗ '''''Важно'''''

Если у вас нет дистрибутива ЕдиныйАгент, вы можете скачать его в настройках мобильного приложения.

# В меню Ключ-АСТРОМ выберите '''Mobile''' .
# Выберите мобильное приложение, которое вы хотите настроить.
# Выберите '''More (…) > Edit''' в правом верхнем углу плитки с названием вашего приложения.
# В настройках приложения перейдите к '''Instrumentation wizard'''.
# Выберите '''iOS''' и перейдите на вкладку '''Developer'''.
# Выберите '''Download ЕдиныйАгент'''.
|}

= 2. Используйте настраиваемые заголовки HTTP =
Если HTTP-запросы ЕдиныйАгент не соответствуют требованиям безопасности вашей серверной инфраструктуры, вы можете изменить заголовки HTTP ЕдиныйАгент с помощью '''Ключ-АСТРОМ.setBeaconHeaders([String : String]?)'''. Эта функция позволяет добавлять заголовок '''Authorization''' в HTTP-запросы и немедленно переподключаться к Cluster ActiveGate, когда срок действия токена истек. Чтобы удалить старые заголовки, вызовите '''Ключ-АСТРОМ.setBeaconHeaders(nil)'''.

Ключ-АСТРОМ.setBeaconHeaders(["Cookie" : "n1=v1; n2=v2", "MyHeader" : "MyHeader", "Authorization" : "API-Token aa11bb22cc33dd44ee55"]) ''//set headers onto beacon''

let headers: Dictionary<String, String>? = Ключ-АСТРОМ.beaconHeaders() ''//request the headers that have been set''

''//listen for communication problems (for example, if beacon header contains a token that can expire required to pass a firewall)''

NotificationCenter.default.addObserver(forName: NSNotification.Name(rawValue: Ключ-АСТРОМ.getCommunicationProblemNotificationName()), object: nil, queue: nil) { _ in

''//for example, update beacon header with new token''

}

← Предыдущая версия		Версия от 14:12, 26 декабря 2024
Строка 1:		Строка 1:
	Процесс автоинструментирования настраивает ваши приложения iOS для мониторинга с помощью ЕдиныйАгент. Этот автоматизированный способ добавления ЕдиныйАгент в приложение без необходимости вручную изменять его исходный код. Автоинструментированное приложение эквивалентно приложению, которое было вручную инструментировано для сбора базовых данных. Такой уровень инструментирования предоставляет видимость реального пользовательского опыта, обеспечиваемого вашим приложением. Он также позволяет обнаруживать сбои и отслеживать производительность, связанную с запуском приложений и временем ответа на веб-запросы.		Процесс автоинструментирования настраивает ваши приложения iOS для мониторинга с помощью ЕдиныйАгент. Этот автоматизированный способ добавления ЕдиныйАгент в приложение без необходимости вручную изменять его исходный код. Автоинструментированное приложение эквивалентно приложению, которое было вручную инструментировано для сбора базовых данных. Такой уровень инструментирования предоставляет видимость реального пользовательского опыта, обеспечиваемого вашим приложением. Он также позволяет обнаруживать сбои и отслеживать производительность, связанную с запуском приложений и временем ответа на веб-запросы.

	= 1. Настройка Public Key Hash Pinning (PKH) pinning с помощью ~~Ключ-АСТРОМ~~ =		= 1. Настройка Public Key Hash Pinning (PKH) pinning с помощью АппОптима =
	Вы можете использовать функцию Public Key Hash Pinning (PKH) для аутентификации.		Вы можете использовать функцию Public Key Hash Pinning (PKH) для аутентификации.
	{\| class="wikitable"		{\| class="wikitable"
Строка 61:		Строка 61:
	Если у вас нет дистрибутива ЕдиныйАгент, вы можете скачать его в настройках мобильного приложения.		Если у вас нет дистрибутива ЕдиныйАгент, вы можете скачать его в настройках мобильного приложения.

	# В меню ~~Ключ-АСТРОМ~~ выберите '''Mobile''' .		# В меню АппОптима выберите '''Mobile''' .
	# Выберите мобильное приложение, которое вы хотите настроить.		# Выберите мобильное приложение, которое вы хотите настроить.
	# Выберите '''More (…) > Edit''' в правом верхнем углу плитки с названием вашего приложения.		# Выберите '''More (…) > Edit''' в правом верхнем углу плитки с названием вашего приложения.
Строка 70:		Строка 70:

	= 2. Используйте настраиваемые заголовки HTTP =		= 2. Используйте настраиваемые заголовки HTTP =
	Если HTTP-запросы ЕдиныйАгент не соответствуют требованиям безопасности вашей серверной инфраструктуры, вы можете изменить заголовки HTTP ЕдиныйАгент с помощью '''~~Ключ-АСТРОМ~~.setBeaconHeaders([String : String]?)'''. Эта функция позволяет добавлять заголовок '''Authorization''' в HTTP-запросы и немедленно переподключаться к Cluster ActiveGate, когда срок действия токена истек. Чтобы удалить старые заголовки, вызовите '''~~Ключ-АСТРОМ~~.setBeaconHeaders(nil)'''.		Если HTTP-запросы ЕдиныйАгент не соответствуют требованиям безопасности вашей серверной инфраструктуры, вы можете изменить заголовки HTTP ЕдиныйАгент с помощью '''АппОптима.setBeaconHeaders([String : String]?)'''. Эта функция позволяет добавлять заголовок '''Authorization''' в HTTP-запросы и немедленно переподключаться к Cluster ActiveGate, когда срок действия токена истек. Чтобы удалить старые заголовки, вызовите '''АппОптима.setBeaconHeaders(nil)'''.

	~~Ключ-АСТРОМ~~.setBeaconHeaders(["Cookie" : "n1=v1; n2=v2", "MyHeader" : "MyHeader", "Authorization" : "API-Token aa11bb22cc33dd44ee55"]) ''//set headers onto beacon''		АппОптима.setBeaconHeaders(["Cookie" : "n1=v1; n2=v2", "MyHeader" : "MyHeader", "Authorization" : "API-Token aa11bb22cc33dd44ee55"]) ''//set headers onto beacon''

	let headers: Dictionary<String, String>? = ~~Ключ-АСТРОМ~~.beaconHeaders() ''//request the headers that have been set''		let headers: Dictionary<String, String>? = АппОптима.beaconHeaders() ''//request the headers that have been set''

	''//listen for communication problems (for example, if beacon header contains a token that can expire required to pass a firewall)''		''//listen for communication problems (for example, if beacon header contains a token that can expire required to pass a firewall)''

	NotificationCenter.default.addObserver(forName: NSNotification.Name(rawValue: ~~Ключ-АСТРОМ~~.getCommunicationProblemNotificationName()), object: nil, queue: nil) { _ in		NotificationCenter.default.addObserver(forName: NSNotification.Name(rawValue: АппОптима.getCommunicationProblemNotificationName()), object: nil, queue: nil) { _ in

	''//for example, update beacon header with new token''		''//for example, update beacon header with new token''

	}		}