IKuznetsov: Новая страница: «= Настройка атрибутов cookie RUM = Система '''Мониторинга реальных пользователей''' Ключ-АСТРОМ использует набор '''HTTP'''-cookie; см. раздел «Файлы cookie и клиентское хранилище для '''RUM''' и воспроизведения сессий». Вы можете настроить некоторые атрибуты cookie. Чтобы по...»

2026-08-19T15:17:08Z

Новая страница: «= Настройка атрибутов cookie RUM = Система '''Мониторинга реальных пользователей''' Ключ-АСТРОМ использует набор '''HTTP'''-cookie; см. раздел «Файлы cookie и клиентское хранилище для '''RUM''' и воспроизведения сессий». Вы можете настроить некоторые атрибуты cookie. Чтобы по...»

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

= Настройка атрибутов cookie RUM =

Система '''Мониторинга реальных пользователей''' Ключ-АСТРОМ использует набор '''HTTP'''-cookie; см. раздел «Файлы cookie и клиентское хранилище для '''RUM''' и воспроизведения сессий». Вы можете настроить некоторые атрибуты cookie.

Чтобы получить доступ к этим параметрам:

# Перейдите в раздел '''Ключевые показатели опыта''' > '''Обзор'''.
# Выберите '''Веб''', чтобы просмотреть все веб-интерфейсы.
# Выберите интерфейс, который хотите настроить.
# На вкладке '''Настройки''' выберите '''Открыть в настройках'''.
# Перейдите в раздел '''Сбор и захват данных''' > '''Инструментарий''' > '''Cookies'''.

В следующих разделах описаны доступные настройки.

== Настройка атрибутов cookie, относящихся к защите данных ==

Если политика безопасности вашей компании требует наличия атрибутов <code>Secure</code> и <code>SameSite</code> у cookie, вам необходимо настроить '''RUM''' для их установки, поскольку по умолчанию они не заданы.

'''RUM''' Ключ-АСТРОМ не поддерживает атрибут <code>HttpOnly</code>. Поскольку <code>HttpOnly</code> cookie недоступны для '''JavaScript''', '''JavaScript RUM''' не может их читать или изменять. Убедитесь, что ваша инфраструктура не добавляет атрибут <code>HttpOnly</code>, так как это нарушит работу мониторинга.

=== Установка атрибута Secure ===

Атрибут <code>Secure</code> cookie гарантирует, что браузеры отправляют cookie только по защищенным соединениям.

Прежде чем включать атрибут <code>Secure</code>, убедитесь, что ваше приложение работает исключительно через защищенные соединения. В противном случае вы потеряете возможность отслеживать незашифрованную '''HTTP'''-коммуникацию.

Чтобы задать атрибут <code>Secure</code> cookie, включите параметр '''Cookie''' > '''Use the Secure cookie attribute for cookies set by Ключ-АСТРОМ'''.

=== Установка атрибута SameSite ===

Атрибут <code>SameSite</code> cookie определяет, отправляет ли браузер cookie с межсайтовыми запросами. Подробное объяснение этого атрибута и его значений см. в разделе «Объяснение SameSite cookies».

Чтобы задать атрибут <code>SameSite</code> cookie, перейдите в раздел '''Cookie''' > '''SameSite cookie attribute''' и выберите одно из значений: <code>None</code>, <code>Lax</code> или <code>Strict</code>.

== Настройка атрибута Domain ==

Атрибуты <code>Domain</code> и <code>Path</code> cookie определяют область действия cookie. Эта область действия определяет, отправляют ли браузеры cookie с запросом и может ли клиентский '''JavaScript''' получить к нему доступ для данного '''URL'''-адреса.

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

По умолчанию атрибут <code>Domain</code> определяется автоматически, но вы также можете настроить его вручную для каждого интерфейса.

В следующих разделах объясняется, как Ключ-АСТРОМ определяет домен cookie по умолчанию и когда может потребоваться его ручная настройка.

=== Домен cookie по умолчанию ===

По умолчанию Ключ-АСТРОМ автоматически определяет домен cookie, выбирая эффективный домен верхнего уровня плюс один ('''eTLD+1''') из '''URL'''-адреса запроса. Например, Ключ-АСТРОМ выбирает домен <code>example.com</code> для <code>www.example.com</code> и <code>example.co.uk</code> для <code>www.example.co.uk</code>. Это позволяет Ключ-АСТРОМ фиксировать непрерывную сессию, даже когда пользователи перемещаются между поддоменами при взаимодействии с вашими интерфейсами, например, с <code>www.example.com</code> на <code>shop.example.com</code>.

Домен cookie определяется либо на стороне сервера с помощью ЕдиногоАгента, либо на стороне клиента с помощью '''JavaScript RUM'''.

* Если '''JavaScript RUM''' внедряется автоматически, ЕдиныйАгент обычно определяет домен cookie, используя результат определения имени хоста в качестве отправной точки. Если неинструментированный компонент перезаписывает часть '''URL''', относящуюся к хосту, убедитесь, что определение имени хоста настроено правильно.
* При использовании '''RUM''' без агентов домен cookie определяется '''JavaScript RUM'''.

=== Настройка домена cookie вручную ===

В большинстве случаев ручная настройка домена cookie не требуется. Однако ручная настройка полезна в следующих случаях:

* Необходимо разделить действия пользователей из разных поддоменов на отдельные пользовательские сессии.
* Автоматическое определение домена cookie не работает, поскольку неинструментированный компонент перезаписывает часть '''URL'''-адреса, относящуюся к хосту, и не передает исходную информацию о хосте в заголовке запроса. Предпочтительное решение — настроить компонент для добавления такого заголовка; см. раздел «Настройка определения имени хоста». Ручная настройка домена cookie также является возможным обходным путем.

Чтобы настроить домен для размещения cookie, перейдите в раздел '''Cookie''' > '''Domain to be used for cookie placement''' и введите необходимый домен.

=== Распространенные ошибки и ограничения ручной настройки ===

==== Указанный домен cookie представляет собой публичный суффикс ====
Браузеры не позволяют устанавливать cookie с атрибутом <code>Domain</code>, выходящим за рамки одной организации. Поэтому установка домена cookie в виде общедоступного суффикса не работает.

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

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

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

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

Настройка атрибутов cookie RUM - История изменений