Почему не загружается Password Vault: сообщение «Произошла непредвиденная ошибка» и ошибки разрешений

Обзор

Когда Password Vault не показывает ваши записи, экран подсказывает, где искать причину. В этой статье перечислены симптомы с быстрой проверкой и решением для каждого из них. Некоторые решения выполняет сам пользователь, для других нужен администратор с соответствующей ролью Microsoft 365.

Полезно знать, как веб-часть получает данные. Хранилище каждого пользователя - это один файл, vitextra-password-vault.json, в папке приложения в собственном OneDrive пользователя. При открытии страницы веб-часть читает этот файл через Microsoft Graph от имени самого пользователя; если файла ещё нет, она создаёт пустой. Каждое изменение сохраняется обратно в тот же файл. Ничего не хранится на странице, в списках SharePoint или на серверах Vitextra. Подробнее: KB10453. Где Password Vault хранит ваши пароли: папка приложения в OneDrive.

Начните здесь: что показывает веб-часть?

Хранилище не открывается

Симптом. Вместо списка веб-часть показывает красное сообщение К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку. и кнопку Обновить.

Причина. При загрузке страницы веб-части не удалось прочитать файл хранилища из OneDrive пользователя. Возможные причины, начиная с самой частой:

1. Разрешение Microsoft Graph не одобрено

Password Vault запрашивает одно делегированное разрешение Microsoft Graph - Files.ReadWrite.AppFolder, которое позволяет читать и записывать файлы только в собственной папке приложения в OneDrive пользователя. Если необходимое разрешение не предоставлено клиентскому субъекту SharePoint, веб-часть не может прочитать или создать хранилище. Сам по себе ожидающий запрос пакета не доказывает отсутствие разрешения: другая SPFx-надстройка могла уже получить его.

Проверка. В Центре администрирования SharePoint откройте Дополнительно → Доступ к API. Если запрос Microsoft Graph - Files.ReadWrite.AppFolder указан в разделе Ожидающие запросы, он ещё не одобрен.

Решение. Запрос одобряет глобальный администратор. Одной роли администратора SharePoint недостаточно для разрешений Microsoft Graph. Затем перезагрузите страницу или кликните Обновить. Пошаговые инструкции: KB10454. Разрешение Microsoft Graph Files.ReadWrite.AppFolder: зачем оно нужно Password Vault и как его утвердить и KB10360. Как одобрить разрешения Microsoft Graph API для решений Vitextra в Центре администрирования SharePoint.

2. У пользователя нет OneDrive

Хранилище находится в собственном OneDrive пользователя, поэтому пользователь без OneDrive в клиенте не может работать с Password Vault. Если ошибка появляется только у некоторых пользователей, а остальные работают нормально, это первое, что нужно проверить.

Проверка. Попросите пользователя открыть OneDrive в Microsoft 365 (например, из средства запуска приложений). Если OneDrive не открывается или OneDrive пользователя ещё не настроен, веб-часть тоже не сможет открыть хранилище.

Решение. Администратор Microsoft 365 проверяет, что у пользователя есть лицензия, включающая OneDrive, и что OneDrive пользователя подготовлен. Затем пользователь перезагружает страницу.

3. Сетевая или временная ошибка Microsoft Graph

Браузер не смог в этот момент связаться с Microsoft Graph или с OneDrive пользователя: пользователь не в сети, прокси-сервер или фильтр содержимого блокирует запрос, либо служба вернула временную ошибку.

Проверка и решение. Кликните Обновить. Если хранилище открылось, это был кратковременный сбой. Если ошибка сохраняется только в одной сети или на одном компьютере, откройте OneDrive в новой вкладке на том же компьютере; если OneDrive тоже не работает, сеть или браузер блокирует службы Microsoft 365, и сначала нужно устранить эту проблему. В Microsoft Teams то же самое должно работать из клиента Teams.

Не удалось обновить данные

Симптом. Список записей отображается, а над ним остаётся красное сообщение К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку.

Причина. Ранее хранилище было успешно открыто, но последующая повторная загрузка файла - кнопкой Обновить - не удалась. Список по-прежнему показывает загруженные ранее данные.

Решение. Когда подключение восстановится, снова кликните Обновить или перезагрузите страницу. После успешной загрузки сообщение исчезнет. Не вносите изменений, пока сообщение отображается: список может быть устаревшим (см. Изменения, сделанные в другом месте, не отображаются).

Не удаётся сохранить изменение

Симптом. После того как вы кликнули Сохранить в диалоговом окне Создать элемент или Изменить свойства, подтвердили Удалить или кликнули звёздочку записи - или после того как вы кликнули Сохранить на экране Настройка PIN-кода или Сменить PIN-код на экране Изменить PIN-код либо подтвердили Сбросить на экране Сброс, - на несколько секунд появляется красное сообщение К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку.

Причина. Не удалось записать файл хранилища в OneDrive - обычно из-за сбоя сети или временной ошибки Microsoft Graph. Изменение применяется только при успешном сохранении, поэтому хранилище остаётся прежним.

Решение.

• Если не удалось сохранить новую или изменённую запись, диалоговое окно остаётся открытым с введёнными данными. Подождите немного и снова кликните Сохранить.
• Если не удалось удалить запись или изменить отметку избранного, просто повторите действие.
• Если сохранение не удалось на экране Настройка PIN-кода, Изменить PIN-код или Сброс, сообщение отображается на этом экране, а сам экран остаётся открытым. Подождите немного и повторите шаг.
• Если ошибка повторяется, скопируйте введённые значения в надёжное место, перезагрузите страницу и проверьте причины, описанные в разделе Хранилище не открывается.

Изменения, сделанные в другом месте, не отображаются

Симптом. Вы добавили или изменили запись на другом компьютере, в другой вкладке браузера или в Microsoft Teams, но на открытой странице её нет.

Причина. Веб-часть читает файл хранилища при открытии страницы и работает с этой копией до перезагрузки. Она не отслеживает изменения файла, сделанные на других устройствах. Изменения, сделанные в другом месте, появляются, когда вы кликаете Обновить, а также после следующего сохранения или разблокировки на этой странице.

Решение. Кликните кнопку Обновить (круговая стрелка в правом верхнем углу веб-части) или перезагрузите страницу.

Записи выглядят пустыми

Симптом. Веб-часть показывает список ваших записей, но их названия и значения пусты, а правильный PIN-код не принимается.

Причина. На странице работает более старая версия Password Vault. Текущая версия шифрует хранилище ключом, производным от PIN-кода, и автоматически преобразует существующее хранилище в новый формат файла при первом вводе правильного PIN-кода. Более старые версии не могут прочитать преобразованное хранилище. Так происходит, если в другом каталоге приложений клиента - например, в каталоге приложений семейства сайтов - всё ещё развёрнута более старая версия пакета, а хранилище уже было преобразовано на странице с текущей версией. Записи не потеряны: текущая версия показывает их как обычно.

Для преобразования старый ключ должен расшифровать каждую запись, а преобразованный файл должен успешно сохраниться. Если одно из условий не выполнено, миграция не происходит; одного ввода правильного PIN-кода недостаточно.

Решение. Администратор обновляет Password Vault во всех каталогах приложений клиента - в каталоге приложений клиента и в каждом каталоге приложений семейства сайтов, где развёрнут пакет; см. KB10050. Как обновить решение Vitextra на SPFx в SharePoint Online и KB10361. Каталог приложений тенанта или каталог приложений семейства сайтов: куда развёртывать приложения Vitextra. После обновления не пользуйтесь страницами с более старой версией и перезагрузите страницы, которые были открыты ещё до него.

Хранилище пусто и запрашивает новый PIN-код

Симптом. Веб-часть показывает экран Настройка PIN-кода, хотя у вас уже было хранилище с записями.

Причина. Веб-часть показывает этот экран, когда в файле хранилища нет PIN-кода, - то есть когда хранилище было сброшено или когда файл не был найден в папке приложения в вашем OneDrive и был создан новый, пустой. Пять неверных PIN-кодов блокируют хранилище, но не очищают его. Пустое хранилище появляется только после подтверждения пользователем Сбросить и успешного сохранения сброса; это могло произойти на другом устройстве или в Microsoft Teams.

Что делать. Если хранилище было сброшено, Password Vault не может вернуть его записи. Настройте новый PIN-код и добавьте записи заново; см. KB10442. Как настроить PIN-код в Password Vault. Если вы не сбрасывали хранилище и вашей учётной записью больше никто не пользуется, обратитесь к администратору Microsoft 365, прежде чем настраивать новый PIN-код.

Хранилище заблокировано

Экран Сброс с текстом Вы слишком много раз вводили неправильный PIN-код. - это не ошибка веб-части: неверный PIN-код был введён пять раз подряд. Что это означает и что делает кнопка Сбросить, объясняется в статье KB10461. Почему Password Vault заблокирован: «Вы слишком много раз вводили неправильный PIN-код».

Сообщение о лицензии

Симптом. Вся веб-часть заменена сообщением Мы надеемся, что вам понравилась бесплатная пробная версия. Купите сейчас полную версию и продолжите работу.

Причина. Для вашего клиента закончился пробный период или истекла подписка. Пока лицензия не продлена, пользователи не могут открыть свои записи. Файлы хранилищ в OneDrive пользователей не изменяются и не удаляются; записи снова отображаются, как только лицензия становится активной.

Решение. См. KB10365. Почему веб-часть Vitextra показывает сообщение «Надеемся, вам понравилась бесплатная пробная версия»: причины и решения, KB10364. Что происходит, когда заканчивается пробный период или подписка Vitextra и KB10206. Лицензирование и учётная запись Vitextra: как приобрести и активировать лицензию.