Password Vault Обзор
Password Vault хранит хранилище каждого пользователя в файле в папке приложения в OneDrive этого пользователя. Чтобы читать и записывать этот файл, пакет решения запрашивает ровно одно разрешение Microsoft Graph: Files.ReadWrite.AppFolder. Администратор тенанта должен один раз утвердить его после развёртывания пакета; до этого веб-часть не может открыть или создать ни одно хранилище. В этой статье объясняются само разрешение и его утверждение.
Зачем Password Vault нужно это разрешение
Веб-часть использует Microsoft Graph для трёх операций, и все они выполняются в папке приложения в OneDrive вошедшего пользователя:
- поиск файла хранилища
vitextra-password-vault.json; - его создание, когда пользователь впервые открывает Password Vault;
- его чтение и сохранение после каждого изменения.
Password Vault не запрашивает других разрешений Microsoft Graph и не требует разрешений на списки SharePoint: любой пользователь, который может открыть страницу, может пользоваться своим хранилищем.
Пользователю также нужен подготовленный OneDrive и утверждённый доступ. Описанная ниже ошибка разрешений предполагает, что необходимый доступ к файлу не предоставлен другим действующим разрешением.
Что разрешение позволяет и чего не позволяет
| Аспект | Подробности |
|---|---|
| Тип разрешения | Делегированное: действует только от имени вошедшего пользователя, а не от имени независимого приложения |
| Позволяет | Читать и записывать файлы в папке приложения в собственном OneDrive вошедшего пользователя |
| Не позволяет | Читать или изменять другие файлы пользователя в OneDrive, OneDrive других пользователей, сайты SharePoint, почту, календари или данные каталога |
| Доступ приложения (app-only) | Отсутствует; у Password Vault нет служебной учётной записи и фонового процесса |
📝 Заметка
В SharePoint Online разрешения API решений SPFx предоставляются одному приложению Microsoft Entra ID, общему для всех решений SPFx в тенанте, - SharePoint Online Client Extensibility Web Application Principal. Как только разрешение Files.ReadWrite.AppFolder утверждено, оно доступно каждому решению SPFx, развёрнутому в вашем тенанте, а папка приложения - это папка этого общего приложения. Так SharePoint Framework работает для всех поставщиков. Развёртывайте только те решения SPFx, которым вы доверяете; см. замечания о безопасности в статье KB10360. Как одобрить разрешения Microsoft Graph API для решений Vitextra в Центре администрирования SharePoint.
Как утвердить разрешение
Запрос разрешения создаётся при развёртывании пакета Password Vault в каталоге приложений тенанта (см. KB10035. Как установить продукт Vitextra в SharePoint Online). Вам нужна роль Глобальный администратор; одной роли администратора SharePoint недостаточно для утверждения разрешений Microsoft Graph. Microsoft
1. Откройте Центр администрирования SharePoint.
2. Перейдите в раздел Дополнительно > Доступ к API.
3. На вкладке Ожидающие запросы выберите запрос пакета Vitextra Password Vault для Microsoft Graph / Files.ReadWrite.AppFolder.
4. Нажмите Утвердить и подтвердите действие.
5. Убедитесь, что разрешение теперь отображается на вкладке Утвержденные запросы.
Если разрешение Files.ReadWrite.AppFolder уже утверждено для другого решения SPFx, новый запрос не появляется: SharePoint повторно использует существующее разрешение. Пользователи не видят запроса согласия; после утверждения веб-часть работает для всех в тенанте, обычно в течение нескольких минут. Если этого не произошло, перезагрузите страницу.
💡 Совет
Снимки экрана, команды PowerShell, частичное утверждение, отзыв разрешений и поведение при обновлениях описаны в статье KB10360. Как одобрить разрешения Microsoft Graph API для решений Vitextra в Центре администрирования SharePoint.
Что видят пользователи, пока разрешение не утверждено
Пакет можно развернуть, а веб-часть - добавить на страницы, пока запрос ещё ожидает утверждения. Однако без разрешения веб-часть не может прочитать или создать хранилище. Вместо экрана Настройка PIN-кода или запроса Введите PIN-код пользователи видят сообщение «К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку.» с кнопкой Обновить. Файл хранилища не создаётся.
После утверждения пользователи нажимают Обновить или перезагружают страницу, и веб-часть открывается в обычном режиме.
То же сообщение появляется, если утверждённое разрешение позднее удалено на вкладке Утвержденные запросы. Удаление разрешения не удаляет файлы хранилищ: они остаются в OneDrive пользователей и снова открываются, как только разрешение будет утверждено. О других причинах этого сообщения см. KB10459. Почему не загружается Password Vault: сообщение «Произошла непредвиденная ошибка» и ошибки разрешений.
