Введение
Веб-часть, которая приносит в интрасеть содержимое извне компании, ставит перед администратором два вопроса: что покидает клиент (тенант) Microsoft 365 и что в него попадает. RSS Reader необычен среди продуктов Vitextra тем, что его содержимое действительно проходит через сервер Vitextra - службу каналов, которая загружает каналы. В этой статье точно указано, что содержит этот запрос, что веб-части разрешено делать в вашем клиенте, где находится её конфигурация, что она хранит в браузере и как обращается с HTML, который издатели помещают в свои каналы.
Кратко для администраторов
| Вопрос | Ответ |
|---|---|
| Какие разрешения API запрашивает пакет? | Никаких |
| Читает ли веб-часть списки SharePoint, файлы или профили пользователей? | Нет |
| Кто загружает каналы? | Служба каналов Vitextra по запросу браузера |
| Что содержит запрос к службе каналов? | Адреса каналов, идентификатор клиента (Tenant ID), идентификатор объекта пользователя, адрес сайта, продукт и его версия |
| Отправляется ли в Vitextra какое-либо содержимое вашего клиента? | Нет |
| Где хранится конфигурация? | В свойствах веб-части на странице; для личного приложения Teams - в службе Vitextra для вашего клиента |
| Что хранится в браузере? | Последние загруженные элементы каналов в хранилище сеанса; кэш используется повторно не более 30 минут |
| Выполняется ли HTML каналов на странице? | Нет - он разбирается инертно; используются только обычный текст и адреса изображений |
Разрешения решения
RSS Reader - это веб-часть SharePoint Framework, которая развёртывается из каталога приложений.
- Пакет не запрашивает разрешений API. На странице Доступ к API Центра администрирования SharePoint ничего не появляется, и веб-часть не обращается за данными ни к Microsoft Graph, ни к REST API SharePoint.
- Из контекста страницы она читает только то, что есть у каждой веб-части: тему, язык, адрес сайта (для проверки лицензии и запроса каналов) и удостоверение вошедшего пользователя (идентификатор объекта, для тех же запросов).
- Она не сохраняет содержимое каналов в SharePoint, OneDrive или Microsoft Entra ID.
Что нужно пользователям
| Задача | Необходимое разрешение |
|---|---|
| Загрузить пакет в каталог приложений, добавить его в Teams | Администратор SharePoint или владелец каталога приложений |
| Добавить веб-часть на страницу и настроить каналы | Разрешение на изменение страницы |
| Сохранить конфигурацию по умолчанию для личного приложения Teams | Разрешение на изменение страницы с веб-частью |
| Читать каналы, переключать источники, фильтровать и искать | Разрешение на чтение страницы |
Как загружаются каналы и что передаётся
Браузеры ограничивают междоменные запросы скриптов, если издатель канала не разрешает их заголовками CORS. RSS Reader использует серверную службу каналов на vitextra.com: браузер отправляет адреса каналов, а служба загружает и разбирает каналы, возвращая их содержимое в виде структурированных данных.
Каждая загрузка и каждое автоматическое обновление - это один запрос к службе каналов со следующим содержимым:
| Поле | Значение |
|---|---|
| Sources | Адреса настроенных каналов |
| TenantId | Идентификатор вашего клиента Microsoft 365 |
| UserId | Идентификатор объекта (GUID) вошедшего пользователя в Microsoft Entra ID |
| SiteUrl | Адрес сайта, на котором работает веб-часть |
| ProductId, ProductName, ProductVersion | Идентификатор, внутреннее имя и версия продукта |
Ответ содержит элементы каналов - заголовки, ссылки, описания, даты, авторов, категории и адреса изображений - и список источников, которые не удалось загрузить. Служба не получает и не возвращает никакого содержимого вашего клиента; пользователь обозначается GUID, а не именем или адресом электронной почты.
Три следствия:
- настроенные адреса каналов передаются службе каналов. Не используйте адреса с конфиденциальными значениями, например персональными токенами или ключами API: они станут доступны службе и всем, кто может читать страницу;
- каналы, доступные только внутри вашей сети, показать нельзя;
- браузер никогда не подключается к серверам издателей за каналом. Он подключается к ним за изображениями элементов, которые загружаются браузером напрямую, как любая картинка на веб-странице, - издатель видит обычный запрос изображения от браузера пользователя.
📝 Заметка
Обработка этих запросов компанией Vitextra описана в Политике конфиденциальности. Запрос сообщает службе, какие каналы настроены на странице, а не какие статьи открывает пользователь: ссылки на статьи ведут прямо к издателю, и ни один клик в Vitextra не передаётся.
Где хранится конфигурация
На странице SharePoint конфигурация - каналы с их адресами, названиями и порядком, макет и переключатели - хранится в свойствах веб-части, внутри страницы в библиотеке Страницы сайта. Каждый, кто может читать страницу, может прочитать конфигурацию; в версиях страницы сохраняются предыдущие конфигурации.
Для личного приложения Teams администратор сохраняет конфигурацию кнопкой Сохранить параметры в группе Личное приложение (Microsoft Teams). Эта конфигурация - те же поля, без названия веб-части - хранится службой Vitextra для вашего клиента и продукта, потому что у личного приложения нет страницы, где её можно было бы хранить. Её читает личное приложение каждого пользователя клиента, и она перезаписывается при следующем нажатии Сохранить параметры. Она содержит только параметры и адреса каналов, никаких данных пользователей.
Во вкладке канала Teams конфигурация хранится вместе с вкладкой, как на странице.
Что хранится в браузере
После успешной загрузки веб-часть сохраняет полученные элементы в хранилище сеанса, используя набор адресов каналов как ключ. Кэш не старше 30 минут используется повторно, пока свежие элементы загружаются в фоне. Этот срок ограничивает повторное использование, а не время физического удаления. Кэш содержит элементы каналов, а не сведения о пользователе. Он относится к сеансу вкладки и может восстановиться при восстановлении сеанса браузером. Для самого кэша каналов локальное хранилище и файлы cookie не используются.
Веб-часть не записывает, какие статьи открывает пользователь. Браузер может сохранять историю посещений и использует собственные сведения о посещённых ссылках для приглушения открытых заголовков.
Как отображается содержимое каналов
Элементы каналов содержат HTML, написанный издателем: описания с разметкой, встроенные изображения, иногда скрипты или пиксели отслеживания. RSS Reader никогда не вставляет этот HTML в страницу:
- описание разбирается в отдельном документе с помощью
DOMParser: скрипты не выполняются, а на странице отображается только обычный текст. Инертный разбор не гарантирует отсутствия запросов к встроенным ресурсам; - изображение берётся из медиаэлементов канала или описания. При поиске изображения в описании веб-часть пропускает изображения с указанной шириной или высотой не более одного пикселя; это не блокирует все изображения отслеживания. Выбранное изображение отображается как обычный элемент
<img>с адресом издателя; - ссылки открывают исходную статью в новой вкладке на сайте издателя; веб-часть не добавляет параметров отслеживания.
Некорректный элемент - с отсутствующими элементами, повреждённой разметкой - показывается с теми данными, которые у него есть, и не мешает отображению остальных элементов.
Запросы к службам Vitextra
| Цель | Что отправляется | Куда |
|---|---|---|
| Служба каналов | См. таблицу выше | vitextra.com |
| Проверка лицензии | Идентификатор клиента (Tenant ID), идентификатор объекта пользователя, адрес сайта, идентификатор, название и версия продукта | vitextra.com |
| Конфигурация личного приложения Teams | Читается при каждой загрузке личного приложения; записывается кнопкой Сохранить параметры: перечисленные выше поля конфигурации | vitextra.com |
| Телеметрия использования | Событие при загрузке веб-части: название и версия продукта, идентификатор и адрес сайта, идентификатор объекта пользователя, язык интерфейса и признак работы веб-части в Teams; технические сведения об ошибках | Azure Application Insights |
| Файлы продукта | Обычный запрос файлов: скрипты и значки веб-части | static.vitextra.com, vitextra-storage.azureedge.net |
Те же сведения по всем продуктам Vitextra см. в статье KB10363. Где продукты Vitextra хранят ваши данные: конфиденциальность, расположение данных и GDPR.
Требования к сети
Разрешите исходящий HTTPS-трафик из сети пользователей и клиента Teams к vitextra.com, static.vitextra.com и vitextra-storage.azureedge.net. Блокировка службы каналов мешает загрузке свежих элементов; если ранее загруженных данных нет, появляется ошибка. Блокировка узлов с файлами продукта может помешать загрузке веб-части. Изображения загружаются с узлов издателей и могут отсутствовать, если эти запросы заблокированы.
Рекомендации
- Используйте каналы издателей, которым доверяет ваша организация, как и для любого внешнего содержимого в интрасети: заголовки, тексты и картинки принадлежат им и меняются без вашей проверки.
- Используйте адреса каналов и изображений по HTTPS. Браузер может заменить HTTP на HTTPS в запросах изображений или заблокировать их; для надёжного отображения нужны прямые HTTPS-адреса изображений.
- Не настраивайте каналы, адрес которых содержит персональный токен; они становятся известны каждому, кто может читать страницу, и службе каналов.
- На общих компьютерах очищайте данные сайтов в браузере при выходе из системы, как и при работе с другими страницами интрасети. Закрытие вкладки не гарантирует удаления данных, если браузер может восстановить сеанс.