Просмотр кода страницы Настройка домена cookie RUM для веб-приложений

Ключ-АСТРОМ '''Real User Monitoring''' использует '''HTTP'''-'''cookies''' для группировки действий пользователя в сеансы и связывания их с соответствующими [[Распределенные трассировки|распределёнными трассировками]]. Браузеры включают куки в заголовок запроса <code>Cookie</code> только в том случае, если '''URL'''-адрес запроса попадает в область действия куки, что определяется атрибутами <code>Domain</code> и <code>Path</code>.

Ключ-АСТРОМ всегда устанавливает атрибут <code>Path</code> cookie-файлов RUM равным <code>/</code>, чтобы область действия '''cookie''' охватывала все '''URL'''-пути в пределах домена. Этот атрибут <code>Domain</code> определяется автоматически по умолчанию, но его также можно '''настроить вручную для каждого приложения''' (см. ниже).

== Автоматическое определение домена cookie ==
Если вы не '''настроили домен cookie''', Ключ-АСТРОМ определит его автоматически. Ключ-АСТРОМ выбирает [https://web.dev/articles/same-site-same-origin?hl=ru эффективный домен верхнего уровня плюс один (eTLD+1)] URL-адреса запроса. Например, Ключ-АСТРОМ выбирает домен '''cookie''' <code>example.com</code> для домена <code>www.example.com</code> или домен '''cookie''' <code>example.co.uk</code> для домена <code>www.example.co.uk</code>. Благодаря этому выбору Ключ-АСТРОМ может фиксировать непрерывный сеанс, даже если ваши пользователи посещают несколько поддоменов при взаимодействии с вашими приложениями, например, при переходе с <code>www.example.com</code> на <code>shop.example.com</code>.

Домен '''cookie''' определяется либо на стороне сервера с помощью ЕдиногоАгента, либо на стороне клиента с помощью '''RUM''' '''JavaScript''', в зависимости от того, какой из них первым фиксирует взаимодействие пользователя с вашим приложением. Если '''RUM''' '''JavaScript''' внедряется автоматически, домен '''cookie''' обычно определяет ЕдиныйАгент. Однако, когда браузер загружает страницу из кэша, домен '''cookie''' определяется '''RUM JavaScript'''.

=== Возможные проблемы с автоматическим определением домена cookie ===
OneAgent использует результат определения имени хоста в качестве отправной точки при определении домена cookie. Если имеется неинструментированный компонент, который перезаписывает часть URL-адреса, относящуюся к хосту, для автоматического определения домена cookie крайне важно правильно настроить определение имени хоста. Подробнее см. в разделе « Что делать, если неинструментированный компонент перезаписывает части URL-адреса?»

== Ручная настройка домена cookie ==
В большинстве случаев нет необходимости настраивать домен '''cookie''' вручную. Однако есть два случая, когда это необходимо:

* Вам необходимо разделить действия пользователей разных поддоменов на отдельные пользовательские сеансы.
* Автоматическое определение домена '''cookie''' не работает, поскольку неинструментированный компонент перезаписывает часть URL-адреса, относящуюся к хосту, и не передаёт исходную информацию о хосте в заголовке запроса.  Предпочтительным решением является настройка компонента на добавление такого заголовка (см. инструкции в разделе «[[Определение приложений для Мониторинга реального пользователя|Что делать, если неинструментированный компонент перезаписывает части URL-адреса?]]»). Однако ручная настройка домена '''cookie''' также является возможным решением.

=== Настройте домен cookie вручную ===
Чтобы настроить домен '''cookie'''

# Перейдите в '''Веб-приложения'''.
# Выберите приложение, которое вы хотите настроить.
# В правом верхнем углу страницы обзора приложения выберите '''Дополнительно ( … ) > Редактировать'''.
# В настройках приложения выберите '''Внедрение > Файлы cookie'''.
# В поле '''Домен''', который будет использоваться для размещения '''cookie'''-файлов, введите требуемый домен.

=== Возможные проблемы с ручной настройкой ===

==== Настроенный домен cookie — это публичный суффикс ====
Браузеры не позволяют устанавливать файлы '''cookie''' с атрибутом <code>Domain</code>, выходящим за пределы одной организации. Поэтому установка домена '''cookie''' на [https://publicsuffix.org/list/ публичный суффикс] не работает.

==== Несколько доменов без общего eTLD+1 отображаются в настроенном приложении. ====
Поскольку домен '''cookie''' настраивается для каждого приложения, все домены, которые сопоставляются с вашим приложением, должны иметь как минимум общий '''eTLD+1''', чтобы разрешить определение домена '''cookie'''.

Например, вы не сможете вручную настроить домен '''cookie''' для приложения, где отображаются оба домена : <code>www.example.com</code>  и <code>www.example.co.uk</code>. Если вы выберете домен '''cookie''' <code>example.com</code>, браузер будет отклонять файлы '''cookie RUM''' при запросах к <code>www.example.co.uk</code>.

==== Перекрывающиеся домены cookie ====
Если вы вручную настраиваете домен '''cookie''' для всех или некоторых своих приложений, вы должны убедиться, что домены '''cookie''' ваших приложений не перекрываются.

Рассмотрим следующий пример. Домен <code>www.example.com</code> сопоставлен с приложением '''Example''', а домен <code>shop.example.com</code> — с приложением '''Shopping'''. По умолчанию домен '''cookie''' <code>example.com</code> определяется автоматически для обоих доменов. Если вы установите домен cookie <code>shop.example.com</code> для приложения '''Shopping''', а ваши пользователи будут переключаться между двумя приложениями, возникнут неоднозначные ситуации, поскольку файлы '''cookie RUM''' для приложения '''Example''' имеют тот же домен '''cookie''' <code>example.com</code> и, следовательно, применимы и к приложению '''Shopping''', у которого есть другой набор файлов '''cookie RUM''' с этим доменом <code>shop.example.com</code>. При такой конфигурации Ключ-АСТРОМ может случайным образом разбивать собранные данные '''RUM''' на короткие пользовательские сеансы и действия пользователей, а распределенные трассировки могут не быть связаны ожидаемым образом.