https://doc.ruscomtech.ru/index.php?action=history&feed=atom&title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%B4%D0%BE%D0%BC%D0%B5%D0%BD%D0%B0_cookie_RUM_%D0%B4%D0%BB%D1%8F_%D0%B2%D0%B5%D0%B1-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9Настройка домена cookie RUM для веб-приложений - История изменений2026-05-11T23:01:36ZИстория изменений этой страницы в викиMediaWiki 1.36.1https://doc.ruscomtech.ru/index.php?title=%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D0%B4%D0%BE%D0%BC%D0%B5%D0%BD%D0%B0_cookie_RUM_%D0%B4%D0%BB%D1%8F_%D0%B2%D0%B5%D0%B1-%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9&diff=5618&oldid=prevIKuznetsov: Новая страница: «Ключ-АСТРОМ '''Real User Monitoring''' использует '''HTTP'''-'''cookies''' для группировки действий пользовате...»2025-09-01T20:25:35Z<p>Новая страница: «Ключ-АСТРОМ '''Real User Monitoring''' использует '''HTTP'''-'''cookies''' для группировки действий пользовате...»</p>
<p><b>Новая страница</b></p><div>Ключ-АСТРОМ '''Real User Monitoring''' использует '''HTTP'''-'''cookies''' для группировки действий пользователя в сеансы и связывания их с соответствующими [[Распределенные трассировки|распределёнными трассировками]]. Браузеры включают куки в заголовок запроса <code>Cookie</code> только в том случае, если '''URL'''-адрес запроса попадает в область действия куки, что определяется атрибутами <code>Domain</code> и <code>Path</code>.<br />
<br />
Ключ-АСТРОМ всегда устанавливает атрибут <code>Path</code> cookie-файлов RUM равным <code>/</code>, чтобы область действия '''cookie''' охватывала все '''URL'''-пути в пределах домена. Этот атрибут <code>Domain</code> определяется автоматически по умолчанию, но его также можно '''настроить вручную для каждого приложения''' (см. ниже).<br />
<br />
== Автоматическое определение домена cookie ==<br />
Если вы не '''настроили домен 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>.<br />
<br />
Домен '''cookie''' определяется либо на стороне сервера с помощью ЕдиногоАгента, либо на стороне клиента с помощью '''RUM''' '''JavaScript''', в зависимости от того, какой из них первым фиксирует взаимодействие пользователя с вашим приложением. Если '''RUM''' '''JavaScript''' внедряется автоматически, домен '''cookie''' обычно определяет ЕдиныйАгент. Однако, когда браузер загружает страницу из кэша, домен '''cookie''' определяется '''RUM JavaScript'''.<br />
<br />
=== Возможные проблемы с автоматическим определением домена cookie ===<br />
OneAgent использует результат определения имени хоста в качестве отправной точки при определении домена cookie. Если имеется неинструментированный компонент, который перезаписывает часть URL-адреса, относящуюся к хосту, для автоматического определения домена cookie крайне важно правильно настроить определение имени хоста. Подробнее см. в разделе « Что делать, если неинструментированный компонент перезаписывает части URL-адреса?»<br />
<br />
== Ручная настройка домена cookie ==<br />
В большинстве случаев нет необходимости настраивать домен '''cookie''' вручную. Однако есть два случая, когда это необходимо:<br />
<br />
* Вам необходимо разделить действия пользователей разных поддоменов на отдельные пользовательские сеансы.<br />
* Автоматическое определение домена '''cookie''' не работает, поскольку неинструментированный компонент перезаписывает часть URL-адреса, относящуюся к хосту, и не передаёт исходную информацию о хосте в заголовке запроса. Предпочтительным решением является настройка компонента на добавление такого заголовка (см. инструкции в разделе «[[Определение приложений для Мониторинга реального пользователя|Что делать, если неинструментированный компонент перезаписывает части URL-адреса?]]»). Однако ручная настройка домена '''cookie''' также является возможным решением.<br />
<br />
=== Настройте домен cookie вручную ===<br />
Чтобы настроить домен '''cookie'''<br />
<br />
# Перейдите в '''Веб-приложения'''.<br />
# Выберите приложение, которое вы хотите настроить.<br />
# В правом верхнем углу страницы обзора приложения выберите '''Дополнительно ( … ) > Редактировать'''.<br />
# В настройках приложения выберите '''Внедрение > Файлы cookie'''.<br />
# В поле '''Домен''', который будет использоваться для размещения '''cookie'''-файлов, введите требуемый домен.<br />
<br />
=== Возможные проблемы с ручной настройкой ===<br />
<br />
==== Настроенный домен cookie — это публичный суффикс ====<br />
Браузеры не позволяют устанавливать файлы '''cookie''' с атрибутом <code>Domain</code>, выходящим за пределы одной организации. Поэтому установка домена '''cookie''' на [https://publicsuffix.org/list/ публичный суффикс] не работает.<br />
<br />
==== Несколько доменов без общего eTLD+1 отображаются в настроенном приложении. ====<br />
Поскольку домен '''cookie''' настраивается для каждого приложения, все домены, которые сопоставляются с вашим приложением, должны иметь как минимум общий '''eTLD+1''', чтобы разрешить определение домена '''cookie'''.<br />
<br />
Например, вы не сможете вручную настроить домен '''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>.<br />
<br />
==== Перекрывающиеся домены cookie ====<br />
Если вы вручную настраиваете домен '''cookie''' для всех или некоторых своих приложений, вы должны убедиться, что домены '''cookie''' ваших приложений не перекрываются.<br />
<br />
Рассмотрим следующий пример. Домен <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''' на короткие пользовательские сеансы и действия пользователей, а распределенные трассировки могут не быть связаны ожидаемым образом.</div>IKuznetsov