Введение

Веб-часть, которая приносит в интрасеть содержимое извне компании, ставит перед администратором два вопроса: что покидает клиент (тенант) 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. Блокировка службы каналов мешает загрузке свежих элементов; если ранее загруженных данных нет, появляется ошибка. Блокировка узлов с файлами продукта может помешать загрузке веб-части. Изображения загружаются с узлов издателей и могут отсутствовать, если эти запросы заблокированы.

Рекомендации

  1. Используйте каналы издателей, которым доверяет ваша организация, как и для любого внешнего содержимого в интрасети: заголовки, тексты и картинки принадлежат им и меняются без вашей проверки.
  2. Используйте адреса каналов и изображений по HTTPS. Браузер может заменить HTTP на HTTPS в запросах изображений или заблокировать их; для надёжного отображения нужны прямые HTTPS-адреса изображений.
  3. Не настраивайте каналы, адрес которых содержит персональный токен; они становятся известны каждому, кто может читать страницу, и службе каналов.
  4. На общих компьютерах очищайте данные сайтов в браузере при выходе из системы, как и при работе с другими страницами интрасети. Закрытие вкладки не гарантирует удаления данных, если браузер может восстановить сеанс.

Вопросы и ответы

Задайте вопрос по статье и получите официальный ответ нашей команды.

Вопросов пока нет. Задайте первый вопрос.

Рекомендуемые статьи

Как импортировать классическую доску обсуждений SharePoint в Discussions

Пошаговое руководство по встроенному импорту веб-части Vitextra Discussions: где находится кнопка «Импорт классической доски», как выбрать сайт и классический список Discussion Board, что показывает сводка пробного прогона, параметры «Сохранить исходных авторов и даты» и «Скопировать вложения», этапы выполнения, итоговый отчёт с предупреждениями и повторный запуск без дублей.

55 7 мин
Quick Poll. Обзор решения: веб-часть опросов для SharePoint

Обзор Vitextra Quick Poll, веб-части для SharePoint Online и Microsoft Teams: создание опросов, голосование, результаты на диаграмме в реальном времени, расписание, управление опросами, экспорт в Excel, конфиденциальность данных, локализация и системные требования.

105 5 мин
Как настроить аудиторию кампании ознакомления

Объединяйте группы Entra ID и SharePoint, атрибуты сотрудников и индивидуальные исключения для выбора аудитории кампании.

18 4 мин

Поделиться