Show/Hide Toolbars

Руководство администратора

Двухфакторная аутентификация через Telegram

Ссылки Назад Вверх Вперед

Процесс двухфакторной аутентификации в системе "Первая Форма" через Telegram:

1. Пользователь вводит в системе "Первая Форма" логин и пароль.

2. Если данные корректны, система запрашивает Telegram Bot API для создания запроса доступа. В ответе API содержится уникальный адрес страницы доступа.

3. Система переадресовывает пользователя на страницу доступа Telegram, где ему будет предложено пройти второй фактор аутентификации. После успешного завершения, Telegram создает токен доступа и возвращает пользователя в "Первую Форму" .

4. Система проверяет токен и авторизует пользователя.

 

Настройка двухфакторной аутентификации через Telegram

1. Создание чат-бота в Telegram

Настройка двухфакторной аутентификации происходит через чат-бота Telegram. Для получения идентификатора нового бота (bot token) найдите в Telegram пользователя @BotFather, запустите с ним чат (команда /start при первом обращении) и введите команду создания нового бота: /newbot.

botfather

Команда создания нового бота

Введите публичное имя для вашего бота и имя пользователя для бота в Telegram. Обратите внимание: имя пользователя должно быть уникальным и должно заканчиваться на "bot" (например: Chat1FBot). Если пользователь с таким именем уже существует вы увидите ошибку: "Sorry, this username is invalid" — необходимо ввести уникальное имя.

При успешном создании вы получите сообщение с ссылкой на свого бота в Telegram и токеном для доступа к HTTP API.

botfather2

Сообщение об успешном создании чат-бота

2. Настройка провайдера аутентификации в "Первой Форме".

Задействуйте второй фактор в дополнительных настройках провайдера аутентификации. Для перехода в настройкам провайдера нажмите на иконку global_js_insert_iconв колонке Доп.настройки.

auth_dop

Доп.настройки на странице Провайдеров аутентификации

В открывшемся окне в качестве второго фактора выберите Telegram, после чего появятся поля: "Имя пользователя бота" и "id и токен бота".

telegram_two_factor_authentication

Окно доп.настроек провайдера аутентификации

В поле "Имя пользователя бота" добавьте имя, которое вы указали вторым для @BotFather — см. п.1.

В поле "id и токен бота" укажите токен API из сообщения об успешном создании чат-бота (пример токена: 123456789:ABC1xKdeM3KFkXorZa8Dsg4uOD7hUcTLqeM)

Сохраните настройки.

3. Настройка права для группы

Перед использованием для группы пользователей необходимо выдать специальное право FormsAuthWithTelegram.

groups_spec_rights_telegram

Выдача группе права FormsAuthWithTelegram

 

4. Привязка бота

После начала чата с ботом в Telegram, автоматически создается чат в "Первой Форме".

start_bot_telegram

Начало чата с ботом в Telegram

Полезные ссылки