Password Vault Обзор
Когда Password Vault не показывает ваши записи, экран подсказывает, где искать причину. В этой статье перечислены симптомы с быстрой проверкой и решением для каждого из них. Некоторые решения выполняет сам пользователь, для других нужен администратор SharePoint.
Полезно знать, как веб-часть получает данные. Хранилище каждого пользователя — это один файл, vitextra-password-vault.json, в папке приложения в собственном OneDrive пользователя. При открытии страницы веб-часть читает этот файл через Microsoft Graph от имени самого пользователя; если файла ещё нет, она создаёт пустой. Каждое изменение сохраняется обратно в тот же файл. Ничего не хранится на странице, в списках SharePoint или на серверах Vitextra. Подробнее: KB10453. Где Password Vault хранит ваши пароли: папка приложения в OneDrive.
Начните здесь: что показывает веб-часть?
| Что вы видите | Перейти к разделу |
|---|---|
| К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку. и кнопка Обновить, записей нет | Хранилище не открывается |
| Записи показаны, а над списком — то же красное сообщение | Не удалось обновить данные |
| Красное сообщение на несколько секунд после сохранения, удаления или пометки записи либо на экране Настройка PIN-кода, Изменить PIN-код или Сброс | Не удаётся сохранить изменение |
| Запись, добавленная или изменённая на другом устройстве или в другой вкладке, отсутствует | Изменения, сделанные в другом месте, не отображаются |
| Хранилище само блокируется, и прежний PIN-код не принимается | Изменения, сделанные в другом месте, не отображаются |
| Записи отображаются с пустыми значениями, и правильный PIN-код не принимается | Записи выглядят пустыми |
| Экран Настройка PIN-кода, хотя записи у вас уже были | Хранилище пусто и запрашивает новый PIN-код |
| Экран Сброс с сообщением Вы слишком много раз вводили неправильный PIN-код. | Хранилище заблокировано |
| Сообщение Мы надеемся, что вам понравилась бесплатная пробная версия… | Сообщение о лицензии |
Хранилище не открывается
Симптом. Вместо списка веб-часть показывает красное сообщение К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку. и кнопку Обновить.
Причина. При загрузке страницы веб-части не удалось прочитать файл хранилища из OneDrive пользователя. Возможные причины, начиная с самой частой:
1. Разрешение Microsoft Graph не одобрено
Password Vault запрашивает одно делегированное разрешение Microsoft Graph — Files.ReadWrite.AppFolder, которое позволяет читать и записывать файлы только в собственной папке приложения в OneDrive пользователя. Пока администратор не одобрит этот запрос, веб-часть не может прочитать или создать ни одно хранилище, поэтому экран ошибки видят все пользователи. Это обычная причина сразу после первой установки.
Проверка. В Центре администрирования SharePoint откройте Дополнительно → Доступ к API. Если запрос Microsoft Graph — Files.ReadWrite.AppFolder указан в разделе Ожидающие запросы, он ещё не одобрен.
Решение. Администратор SharePoint (или глобальный администратор) одобряет запрос. Затем перезагрузите страницу или кликните Обновить. Пошаговые инструкции: KB10454. Разрешение Microsoft Graph Files.ReadWrite.AppFolder: зачем оно нужно Password Vault и как его утвердить и KB10360. Как одобрить разрешения Microsoft Graph API для решений Vitextra в Центре администрирования SharePoint.
📝 Заметка
После обновления или повторного развёртывания пакета ещё раз проверьте страницу Доступ к API: если там появился новый запрос, его тоже нужно одобрить.
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-код либо подтвердили Сбросить на экране Сброс, — на несколько секунд появляется красное сообщение К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку.
Причина. Не удалось записать файл хранилища в OneDrive — обычно из-за сбоя сети или временной ошибки Microsoft Graph. Изменение применяется только при успешном сохранении, поэтому хранилище остаётся прежним.
Решение.
- Если не удалось сохранить новую или изменённую запись, диалоговое окно остаётся открытым с введёнными данными. Подождите немного и снова кликните Сохранить.
- Если не удалось удалить запись или изменить отметку избранного, просто повторите действие.
- Если сохранение не удалось на экране Настройка PIN-кода, Изменить PIN-код или Сброс, сообщение отображается на этом экране, а сам экран остаётся открытым. Подождите немного и повторите шаг.
- Если ошибка повторяется, скопируйте введённые значения в надёжное место, перезагрузите страницу и проверьте причины, описанные в разделе Хранилище не открывается.
Изменения, сделанные в другом месте, не отображаются
Симптом. Вы добавили или изменили запись на другом компьютере, в другой вкладке браузера или в Microsoft Teams, но на открытой странице её нет.
Причина. Веб-часть читает файл хранилища при открытии страницы и работает с этой копией до перезагрузки. Она не отслеживает изменения файла, сделанные на других устройствах. Изменения, сделанные в другом месте, появляются, когда вы кликаете Обновить, а также после следующего сохранения или разблокировки на этой странице.
Решение. Кликните кнопку Обновить (круговая стрелка в правом верхнем углу веб-части) или перезагрузите страницу.
📝 Заметка
Изменения, сделанные в другом месте, не перезаписываются. Каждое сохранение отправляется вместе с версией файла хранилища, на основе которой оно было подготовлено; если тем временем хранилище было сохранено на другом устройстве или в другой вкладке, веб-часть загружает последнюю версию файла и применяет к ней ваше изменение. Если на другом устройстве был изменён PIN-код — или хранилище было сброшено, — открытая страница блокируется, как только обнаруживает это (при нажатии Обновить, при сохранении или при разблокировке), и запрашивает новый PIN-код; прежний PIN-код там больше не действует.
Записи выглядят пустыми
Симптом. Веб-часть показывает список ваших записей, но их названия и значения пусты, а правильный PIN-код не принимается.
Причина. На странице работает более старая версия Password Vault. Текущая версия шифрует хранилище ключом, производным от 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: как приобрести и активировать лицензию.
💡 Совет
Если Password Vault отсутствует на панели элементов веб-частей или среди приложений вашего сайта, пакет не установлен или недоступен на этом сайте; см. KB10035. Как установить продукт Vitextra в SharePoint Online. О проблемах, характерных для Microsoft Teams, см. KB10457. Как добавить Password Vault в Microsoft Teams.
