Questions & Answers Обзор
Questions and Answers — это веб-часть SharePoint Framework, которая хранит всё содержимое в списке SharePoint на вашем собственном сайте и читает и записывает его с правами вошедшего пользователя. Один этот факт отвечает на большинство вопросов о безопасности, но детали важны, когда вы решаете, кто может задавать вопросы, кто может публиковать и что покидает клиент (тенант) Microsoft 365. Эта статья — справочник для таких решений.
Кратко для администраторов
| Вопрос | Ответ |
|---|---|
| Какие разрешения API запрашивает пакет? | Никаких |
| От чьего имени выполняются запросы? | От имени вошедшего пользователя — при каждом чтении и записи |
| Где хранятся вопросы, ответы, вложения и комментарии? | В одном списке SharePoint на сайте, где работает веб-часть |
| Хранит ли веб-часть что-либо в другом месте? | Нет — ни на серверах Vitextra, ни в браузере |
| Кто может читать базу знаний? | Все, у кого есть Чтение (Read) на список (и на страницу) |
| Кто может задать вопрос? | Пользователи с разрешением Добавление элементов (Add Items) на список |
| Кто может публиковать ответы? | Пользователи, которые могут изменять элементы списка |
| Что отправляется в Vitextra? | Технические идентификаторы для проверки лицензии и телеметрия использования; никакого содержимого |
| Сторонние службы? | Только плееры YouTube или Vimeo, когда редактор добавляет такую ссылку в вопрос |
Разрешения решения
- Пакет не запрашивает разрешений API: на странице Доступ к API (API access) Центра администрирования SharePoint ничего не появляется, и веб-часть никогда не обращается к Microsoft Graph.
- Веб-часть использует SharePoint REST API текущего сайта, чтобы читать списки, элементы, вложения и комментарии, создавать список и его столбцы, добавлять вопрос и добавлять комментарий. Каждый запрос выполняется от имени вошедшего пользователя; SharePoint применяет к нему свои разрешения.
- Живая карточка профиля контактного лица и упомянутых пользователей — это стандартный компонент SharePoint, загружаемый из самого SharePoint.
Список
Веб-часть создаёт настраиваемый список (или подключается к нему) со столбцами, описанными в KB10382. Справочник параметров веб-части Questions and Answers. Это обычный список в разделе Содержимое сайта (Site contents):
- он наследует разрешения сайта, пока вы не прервёте наследование;
- на него распространяются хранение, обнаружение электронных данных (eDiscovery), аудит и резервное копирование вашего клиента, как и на любой список;
- в параметрах списка можно включить управление версиями, чтобы хранить историю ответов;
- он создаётся с установленным признаком NoCrawl, поэтому его элементы не появляются в результатах поиска SharePoint и в поиске Microsoft 365 — у веб-части есть собственный поиск. Если вы хотите, чтобы вопросы находились глобальным поиском, установите Разрешить отображение элементов этого списка в результатах поиска (Allow items from this list to appear in search results) → Да в разделе Параметры списка → Дополнительные параметры;
- удаление веб-части со страницы не удаляет список; удаление списка удаляет вопросы, их вложения и комментарии (их можно восстановить из корзины в течение обычного срока).
Собственные настройки веб-части — подключённый список, переключатели, сортировка и размер страницы — хранятся в свойствах веб-части на странице.
Кто что может
Из уровней разрешений SharePoint на список следуют три роли:
| Роль | Требуется | Может |
|---|---|---|
| Читатель | Чтение (Read) на список (и на страницу) | Просматривать, искать, раскрывать ответы, открывать вложения, переходить по ссылкам, копировать ссылки на вопросы, видеть комментарии |
| Автор вопроса | Добавление элементов (Add Items) на список — входит в уровни Участие (Contribute) и Изменение (Edit) | Всё, что может читатель, плюс «Задать вопрос» и добавление комментариев |
| Редактор | Изменение элементов (Edit Items) на список — входит в уровни Участие и Изменение | Всё перечисленное выше, плюс написание ответов, назначение категорий, вложений и «Опубликовано» = «Да» |
Кнопка «Задать вопрос» показывается только тогда, когда веб-часть подтверждает, что у пользователя есть разрешение Добавление элементов на список; переключатель в панели свойств включает возможность, а разрешение решает, кто её видит. Неопубликованные вопросы никогда не возвращаются в веб-часть, какими бы ни были разрешения пользователя; редактор видит их только в списке.
Как разрешить задавать вопросы, не разрешая публиковать
Уровень Участие позволяет пользователю добавлять элементы и изменять любой элемент — в том числе установить «Опубликовано» = «Да» в чужом черновике или изменить ответ. Чтобы публикация оставалась в руках редакторов, а задавать вопросы могли все:
- Откройте список, затем Параметры → Параметры списка → Дополнительные параметры.
- В разделе Разрешения на уровне элементов (Item-level Permissions) установите для Доступ на создание и изменение значение Создание элементов и изменение элементов, созданных пользователем (Create items and edit items that were created by the user).
- Предоставьте широкой аудитории уровень Участие на список, а группе редакторов — Изменение (или сделайте их владельцами списка); на уровень Изменение и выше настройка уровня элементов не распространяется.
С этой настройкой сотрудник может прислать вопрос и позже изменить своё обращение, но не может трогать другие элементы. Публикуют редакторы. При необходимости установите для Доступ на чтение значение Чтение всех элементов (по умолчанию), чтобы веб-часть могла показывать опубликованные вопросы всем.
❗ Важно
Разрешение Добавление элементов на список подразумевает возможность добавлять вложения и комментарии к собственным элементам через интерфейс SharePoint, а не только через веб-часть. Держите дополнительные параметры списка (вложения, комментарии) в соответствии с тем, что вы хотите разрешить.
Гости
Гостевые пользователи с доступом к сайту являются читателями или авторами вопросов в зависимости от их уровня разрешений; живые карточки профиля могут показывать гостям меньше сведений. Внешний общий доступ к странице не открывает доступ к списку: человек, который может открыть страницу, но не список, увидит вместо вопросов ошибку.
Вложения и комментарии
Вложения хранятся вместе с элементом списка в собственной папке вложений списка; они следуют разрешениям элемента и удаляются вместе с ним. Комментарии — это комментарии SharePoint к элементу списка (см. KB10381. Комментарии, упоминания @ и глубокие ссылки в Questions and Answers); их можно отключить для списка в разделе Дополнительные параметры → Комментарии.
Что отправляется за пределы клиента
| Назначение | Что отправляется | Куда |
|---|---|---|
| Проверка лицензии | Идентификатор клиента (Tenant ID), идентификатор объекта пользователя, адрес сайта, идентификатор, имя и версия продукта | vitextra.com |
| Телеметрия использования | Событие при загрузке веб-части (продукт и версия, идентификатор и адрес сайта, идентификатор объекта пользователя, язык интерфейса, работает ли веб-часть в Teams) и технические сведения об ошибках | Azure Application Insights |
| Файлы продукта | Обычный запрос скриптов и значков веб-части | static.vitextra.com, vitextra-storage.azureedge.net |
| Видеоплееры | Когда в вопросе указан адрес YouTube или Vimeo и блок «Видео» показан: браузер загружает плеер с youtube.com или player.vimeo.com, которые видят обычный запрос браузера пользователя | YouTube, Vimeo |
| Значки типов файлов | Значки для карточек вложений, загружаемые из CDN Microsoft | static2.sharepointonline.com |
Ни один вопрос, ответ, вложение или комментарий не отправляется ни в Vitextra, ни третьим лицам. Полная картина по всем продуктам Vitextra приведена в KB10363. Где продукты Vitextra хранят ваши данные: конфиденциальность, расположение данных и GDPR.
📝 Заметка
Если в вашей организации не разрешено содержимое с YouTube или Vimeo в интранете, оставьте для «Видео» значение «Скрыть» или используйте видео, хранящиеся в SharePoint: прямая ссылка на файл .mp4 в библиотеке документов воспроизводится собственным плеером браузера без каких-либо внешних запросов.
Отчётность и экспорт
Поскольку содержимое — это список, к нему применимы стандартные инструменты: Экспорт в Excel (Export to Excel) из панели команд списка, отчёт Power BI по списку (например, вопросы по категориям, неотвеченные обращения по давности), поток Power Automate, уведомляющий редакторов о новом вопросе (триггер При создании элемента с «Опубликовано» = «Нет»), и оповещения списка для той же цели.
