VKWebAppSecureTokenGet

VKWebAppSecureTokenGet запускает проверку биометрии и после её успешного прохождения возвращает ключ доступа из защищённого хранилища. Ключ доступа устанавливается с помощью события VKWebAppSecureTokenSet.

Окно проверки биометрииОкно проверки биометрии

Пример

JavaScript
bridge.send('VKWebAppSecureTokenGet') .then((data) => { if (data.token) { // Ключ доступа получен } }) .catch((error) => { // Ошибка console.log(error); });

Платформы

Android, iOS

Параметры

—

Результат

Проверить результат можно:

  • •

    Используя объект Promise, который возвращается вызовом bridge.send(...).

  • •

    С помощью событий VKWebAppSecureTokenGetResult и VKWebAppSecureTokenGetFailed.

Подробнее о проверке результатов при вызовах VK Bridge.

Объект Promise

Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise. В качестве ответа платформа возвращает объект со следующим полем:

Поле
Тип
Описание
token
string
Ключ доступа из защищённого хранилища. Если на устройстве нет сохранённого ключа доступа, возвращается значение null.

Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.

События

VKWebAppSecureTokenGetResult

Сигнализирует, что ключ доступа получен. В обработчик события на стороне пользователя передаются следующие данные:

JavaScript
{ detail: { type: "VKWebAppSecureTokenGetResult", data: { result: { token: "le93@1YpW73&1" } } } }

Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.

VKWebAppSecureTokenGetFailed

Информирует об ошибке, которая произошла при взаимодействии с платформой, или означает, что пользователь запретил использование биометрии.

В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.

Пример обработки событий

Подробнее — в разделе Обработка результата.

Рекомендации

  • •
    Чтобы сохранение и получение ключа работало корректно, сначала разрешите вход в мини-приложение c помощью биометрии, используя событие VKWebAppSecureTokenRequestAccess.
  • •
    Чтобы сохранить произвольную строку в качестве ключа доступа, используйте событие VKWebAppSecureTokenSet.

Материалы по теме