Установка Passkey 1.2.0 для 1С-Битрикс

Пакет и требования

Эта инструкция относится к полному пакету bbcoding.passkey 1.2.0 с корневой папкой .last_version. Архив обновления 1.2.0.tar.gz имеет другое назначение и не заменяет полный пакет при первой установке. Контрольная сумма полного архива: a5e9fe297bebc8fcc9da140c7d908a6060697733ce8721e4c563717966304410.

По документации выпуска требуются 1С-Битрикс main >= 24.0.0, PHP 8.2–8.4, UTF-8, HTTPS, OpenSSL, cURL и поддерживаемая SQL-СУБД. Это требования выпуска; конкретные браузеры и устройства имеют отдельную матрицу проверки. Внешний аппаратный USB/NFC-ключ не заявляется как проверенный сценарий этого выпуска.

Перед установкой сделайте резервную копию файлов и базы сайта. Сначала повторите установку на тестовой копии. Сохраните рабочий обычный парольный вход и доступ администратора.

Первая установка

Для установки через Маркетплейс используйте штатный установщик 1С-Битрикс. Доступная версия указана в карточке модуля.

Для ручной установки полного пакета распакуйте содержимое .last_version в local/modules/bbcoding.passkey вашего сайта. Внутри этого каталога должны оказаться include.php, install/version.php и остальные файлы модуля, а не ещё одна вложенная папка .last_version.

Не копируйте репозиторий разработки и не оставляйте вторую копию в bitrix/modules/bbcoding.passkey. Если модуль уже установлен из Marketplace в bitrix/modules, используйте штатное обновление, а не создание второй установки.

Откройте стандартную страницу модулей 1С-Битрикс, выберите модуль Passkey и установите его. Выполните встроенную диагностику: HTTPS, UTF-8, версия PHP, OpenSSL и cURL.

Настройка профиля

Создайте RP-профиль и привязку к SITE_ID, домену и точному HTTPS-origin. Origin включает протокол и при необходимости порт; он должен соответствовать адресу, по которому пользователь открывает сайт.

Включите профиль и нужную привязку. Включённая интеграция стандартной формы добавляет кнопку на обычную страницу входа Битрикс.

Сначала проверьте обычный парольный вход. Затем авторизованный активный пользователь может добавить ключ в своём профиле. Для готовой страницы управления ключами предусмотрен адрес /bitrix/tools/bbcoding.passkey/account.php либо компонент bbcoding:passkey.register.

Проверка результата

На поддерживаемом устройстве зарегистрируйте ключ доступа в профиле пользователя. Выйдите из аккаунта и проверьте вход с этим ключом на том же настроенном origin. Затем проверьте, что обычный парольный вход остаётся доступен.

Проверьте список ключей и отзыв тестового ключа в интерфейсе сайта. Удаление ключа только в менеджере устройства не отзывает серверную запись. Отзыв на сайте также не удаляет локальную запись операционной системы.

Если кнопка не появилась, проверьте включённость RP-профиля, привязку SITE_ID/origin и выбранную интеграцию формы. Не меняйте origin наугад и не передавайте ключи или коды в поддержку.

Внешний вход и обновление

В 1.2.0 добавлена отдельная настройка VK ID, Яндекс ID и тестового Сбер ID SB. Новый внешний вход после установки и обновления выключен. Настройка приложений провайдеров и точных callback выполняется отдельно; её успех не следует из проверки Passkey. Тестовый SB не означает готовность рабочего Сбер ID.

Обновление выполняйте штатно, сохранив предварительную резервную копию. Удаление модуля предлагает сохранение данных по умолчанию либо явное полное удаление; ручное удаление каталогов не заменяет штатное удаление.

Обращение в поддержку

Сообщите версию 1.2.0, версии PHP и Битрикс, браузер и устройство, шаг ошибки и ожидаемый результат. Сначала используйте тестовый аккаунт. Пароли, коды, секреты провайдеров и приватные ключи в обращение не включайте.