Password Vault Обзор
Password Vault не хранит ваши учётные данные на странице SharePoint, в списке SharePoint или на серверах Vitextra. Хранилище каждого пользователя - это один файл в собственном OneDrive этого пользователя. В этой статье описаны файл, папка, в которой он находится, порядок его создания и то, что нужно учитывать при работе с хранилищем на нескольких устройствах.
Кратко
| Вопрос | Ответ |
|---|---|
| Имя файла | vitextra-password-vault.json |
| Расположение | Папка приложения в собственном OneDrive вошедшего пользователя |
| Формат | Файл JSON; текстовые поля записей зашифрованы алгоритмом AES ключом, производным от PIN-кода; в файле также хранятся соль, число итераций и контрольное значение, но ни PIN-кода, ни его хеша |
| Сколько хранилищ у одного пользователя? | Одно - одно и то же хранилище на каждой странице, сайте и во всех вкладках и приложениях Teams |
| Кто его создаёт? | Веб-часть, автоматически, когда пользователь открывает её впервые |
| Что хранится в других местах? | Данные хранилища не сохраняются; настройки и кэш лицензии хранятся отдельно |
| Требование | У пользователя должен быть OneDrive в тенанте |
Папка приложения
Папка приложения находится внутри Apps, в подпапке с именем приложения Microsoft Entra ID. Microsoft Graph создаёт её при первом обращении к approot. Password Vault сохраняет в ней файл vitextra-password-vault.json. Microsoft Learn. KB10454. Разрешение Microsoft Graph Files.ReadWrite.AppFolder: зачем оно нужно Password Vault и как его утвердить
Файл принадлежит вашему OneDrive, как и любой другой файл. На него распространяются те же разрешения OneDrive, пространство хранения, журнал версий, корзина и параметры хранения (retention), которые ваша организация применяет к содержимому OneDrive. Поля его записей зашифрованы ключом, который формируется из вашего PIN-кода и не хранится в файле, поэтому файл не содержит ваши записи в виде открытого текста (см. KB10452. Как Password Vault защищает ваши данные: шифрование, PIN-код и хранение).
❗ Важно
Не удаляйте, не переименовывайте, не перемещайте и не изменяйте файл vitextra-password-vault.json. Password Vault ищет файл по имени в папке приложения; любое изменение файла может сделать ваши записи недоступными.
Одно хранилище на пользователя - везде
Поскольку файл хранится в OneDrive пользователя, хранилище привязано к пользователю, а не к странице:
- Каждый пользователь, открывший страницу с веб-частью, видит своё собственное хранилище. Размещение веб-части на общей странице или в канале Teams не открывает коллегам доступ к паролям друг друга.
- Одно и то же хранилище отображается на каждой странице, сайте и во вкладке или личном приложении Microsoft Teams, куда добавлена веб-часть. Запись, созданная на одной странице, доступна на всех остальных.
- Удаление веб-части со страницы или удаление всего продукта из тенанта не удаляет файл хранилища: он остаётся в OneDrive пользователя.
Как создаётся файл хранилища
Когда пользователь впервые открывает Password Vault, веб-часть не находит файл хранилища и автоматически создаёт пустой файл в папке приложения. Затем появляется экран Настройка PIN-кода. После того как пользователь сохранит PIN-код, хранилище готово к работе, а в списке отображается сообщение «В этом списке нет элементов.». См. KB10442. Как настроить PIN-код в Password Vault.
Если файл удалён или перемещён
Если файл хранилища удалён, переименован или перемещён из папки приложения, веб-часть больше не находит его. Когда пользователь в следующий раз откроет Password Vault, будет создано новое пустое хранилище и показан экран Настройка PIN-кода. Записи из старого файла в новом хранилище не отображаются.
Восстановление удалённого файла или его более ранней версии - это операция OneDrive, а не Password Vault: используйте корзину или журнал версий OneDrive в пределах, допускаемых параметрами вашей организации. Веб-часть открывает тот файл с именем vitextra-password-vault.json, который находит в папке приложения; восстановленный файл открывается с PIN-кодом, который действовал для этой версии хранилища, а файл в прежнем формате снова обновляется при первом вводе правильного PIN-кода.
📝 Заметка
У Vitextra нет копии вашего хранилища, и Vitextra не может его восстановить. Резервное копирование и восстановление содержимого OneDrive регулируются Microsoft 365 и политиками вашей организации.
Пользователи без OneDrive
Для работы Password Vault у вошедшего пользователя должен быть OneDrive в вашем клиенте Microsoft 365. Пользователь, у которого нет OneDrive, не может пользоваться веб-частью: она показывает сообщение «К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку.». О других причинах этого сообщения см. KB10459. Почему не загружается Password Vault: сообщение «Произошла непредвиденная ошибка» и ошибки разрешений.
Работа на двух устройствах или в двух вкладках
Веб-часть читает файл хранилища при загрузке страницы и держит данные в открытой странице. Каждое сохранение - создание, изменение и удаление записей, отметка избранного, смена PIN-кода и обновление счётчика неудачных попыток - отправляется вместе с версией (eTag) файла, на основе которой было сделано изменение. Если за это время хранилище было сохранено в другом месте, OneDrive отклоняет сохранение, а веб-часть загружает последнюю версию файла и применяет изменение к ней. Поэтому изменения разных записей, внесённые на другом устройстве или в другой вкладке, сохраняются. При одновременном редактировании одной записи последние сохранённые значения её редактируемых полей могут заменить предыдущие изменения; отдельные поля не объединяются.
Изменение, сохранённое в одном месте, появляется на другой открытой странице после нажатия там кнопки Обновить, а также после следующего сохранения или разблокировки на этой странице. Если PIN-код был изменён или хранилище было сброшено на другом устройстве, открытая страница блокируется, как только обнаруживает это (при нажатии Обновить, при сохранении или при разблокировке), и запрашивает новый PIN-код; старый PIN-код там больше не действует. Если хранилище сброшено и новый PIN-код ещё не задан, вместо этого появляется экран первоначальной настройки.
💡 Совет
Чтобы сразу увидеть изменения, внесённые на другом устройстве, нажмите кнопку Обновить в правом верхнем углу веб-части. Она заново загружает файл хранилища из OneDrive и доступна также, пока хранилище заблокировано.
После перехода на новый формат файла
Текущая версия Password Vault сохраняет хранилище в новом формате файла, в котором ключ формируется из PIN-кода с помощью PBKDF2 (см. KB10452. Как Password Vault защищает ваши данные: шифрование, PIN-код и хранение). Существующее хранилище обновляется автоматически, когда его владелец впервые вводит правильный PIN-код в новой версии; записи сохраняются.
Обновление завершается, только если удалось расшифровать все записи и успешно сохранить обновлённый файл. При сбое на любом из этих этапов веб-часть может продолжить текущий сеанс в прежнем формате; сама разблокировка не подтверждает успешное обновление.
❗ Важно
Более ранние версии веб-части не могут открыть обновлённое хранилище: они показывают записи с пустыми значениями и не принимают PIN-код. Администраторам следует обновить Password Vault во всех каталогах приложений тенанта - в каталоге приложений тенанта и в каждом каталоге приложений семейства сайтов, где развёрнут пакет, - а пользователям не следует работать с более ранними версиями после обновления. См. KB10050. Как обновить решение Vitextra на SPFx в SharePoint Online и KB10361. Каталог приложений тенанта или каталог приложений семейства сайтов: куда развёртывать приложения Vitextra.
Страницы, которые были открыты ещё до обновления, по-прежнему выполняют предыдущую версию и хранят старые данные в памяти. Перезагрузите их, прежде чем продолжить работу с хранилищем.
Конфиденциальность и расположение данных
Поскольку хранилище - это обычный файл OneDrive, оно хранится в том же расположении данных Microsoft 365, что и остальное содержимое OneDrive пользователя. Vitextra не получает данных хранилища. Обзор по всем продуктам Vitextra см. в статье KB10363. Где продукты Vitextra хранят ваши данные: конфиденциальность, расположение данных и GDPR.
