Как настроить регистрацию и аутентификацию на Drupal с помощью SMS API
Подтверждение регистрации и аутентификация через SMS API — эффективный инструмент на множестве сайтов. Такая функция помогает уменьшить количество спам-аккаунтов, улучшить взаимодействие с пользователями и предоставить ценные данные для целевых кампаний. Разберёмся, как реализовать такое подтверждение через МТС Exolve на сайтах с Drupal.
Преимущества SMS-подтверждения
Рассмотрим преимущества такого подтверждения подробнее.
Повышение безопасности
Двухфакторная аутентификация (2FA) делает безопаснее работу пользователя с сайтом. SMS-код служит дополнительным уровнем защиты, уменьшая риск несанкционированного доступа, даже если злоумышленник получил доступ к паролю. Отправка кода подтверждения на номер телефона помогает удостовериться, что пользователь владеет указанным номером, снижая вероятность создания фейковых аккаунтов. Но есть много тонкостей, о них коллеги уже говорили.
Улучшение пользовательского опыта
Это простой и быстрый способ подтверждения личности. Большинство пользователей знакомы с процессом получения и ввода SMS-кодов, что делает процесс регистрации и аутентификации интуитивно понятным. Пользователи получают уведомления в режиме реального времени.
Снижение количества фальшивых регистраций
Это хороший способ фильтрации спам-аккаунтов: требование подтверждения по SMS помогает снизить количество автоматических регистраций и спам-аккаунтов, что улучшает качество базы данных пользователей.
Восстановление доступа
SMS можно использовать для отправки кодов восстановления пароля, что упрощает пользователям процесс восстановления доступа к своим учетным записям.
Маркетинговые возможности
Таким способом удобно собирать маркетинговые данные. Номер телефона, подтвержденный через SMS — ценный ресурс. Это позволяет маркетологам отправлять целевые предложения и уведомления, увеличивая вовлеченность пользователей.
Кроме того, SMS позволяет быстро и надежно информировать пользователей о важных событиях, акциях и новостях.
Соответствие требованиям безопасности
В некоторых отраслях, таких как финансы или здравоохранение, подтверждение личности через SMS может быть требованием для соответствия стандартам безопасности и защиты данных.
Аудит и отслеживание
Интеграция с SMS API позволяет вести журналы отправленных кодов и подтверждений, что упрощает аудит безопасности и отслеживание подозрительной активности.
Очевидно, что все эти преимущества стоят того, чтобы внедрить их у себя. Более того, без использования регистрации и аутентификация через SMS вряд ли получится создать коммерчески успешный сайт.
Как сделать подтверждение регистрации и аутентификацию через SMS на CMS Drupal
Интеграция SMS-подтверждения имеет два ограничения: используемый SMS-шлюз и движок сайта. В этой статье мы рассмотрим вариант для Drupal и API-платформы МТС Exolve.
Установка модулей
Начнем с установки модуля SMS Framework:
Переходим на страницу модуля SMS Framework на Drupal.org и его скачиваем. При желании можно использовать Composer:
```bash
composer require drupal/smsframework
```
Устанавливаем модуль для SMS API провайдера, в нашем случае МТС Exolve. Здесь придется повозиться. Прежде чем начинать, установите и настройте Drupal 9 или 10.
Шаг 1. Подготовка к работе с API МТС Exolve
Зарегистрируйтесь на сайте МТС Exolve и получите учетные данные для API.
Шаг 2. Создание кастомного модуля для интеграции с API МТС Exolve.
Создаем структуру модуля:
Перейдите в директорию `modules/custom` вашего сайта Drupal.
Создайте новую папку для вашего модуля, например, `mts_sms`.
Внутри папки `mts_sms` создайте файл `mts_sms.info.yml` со следующим содержимым:
```yaml
name: 'MTS SMS Integration'
type: module
description: 'Module for SMS registration confirmation using MTS Exolve API.'
core_version_requirement: ^9 || ^10
package: Custom
dependencies:
- drupal/user
Создаем файл модуля `mts_sms.module`.
Внутри папки `mts_sms` создайте файл `mts_sms.module` и добавьте следующий код:
'tel',
'#title' => t('Phone Number'),
'#required' => TRUE,
];
// Add a submit handler to the registration form.
$form['#submit'][] = 'mts_sms_user_register_form_submit';
}
/**
* Submit handler for user registration form.
*/
function mts_sms_user_register_form_submit($form, FormStateInterface $form_state) {
// Get the phone number from the form.
$phone_number = $form_state->getValue('phone_number');
// Generate a random confirmation code.
$confirmation_code = rand(100000, 999999);
// Save the confirmation code to the user's session.
\Drupal::service('user.private_tempstore')->get('mts_sms')->set('confirmation_code', $confirmation_code);
// Send the confirmation code via SMS.
$api_key = 'YOUR_API_KEY';
$api_secret = 'YOUR_API_SECRET';
$sender = 'YourSenderName';
$message = "Your confirmation code is $confirmation_code";
mts_sms_send_sms($api_key, $api_secret, $phone_number, $sender, $message);
}
/**
* Function to send SMS via MTS Exolve API.
*/
function mts_sms_send_sms($api_key, $api_secret, $phone_number, $sender, $message) {
$url = 'https://api.mts.exolve.ru/sms/send';
$data = [
'api_key' => $api_key,
'api_secret' => $api_secret,
'to' => $phone_number,
'sender' => $sender,
'message' => $message,
];
$options = [
'http' => [
'header' => "Content-type: application/x-www-form-urlencoded\r\n",
'method' => 'POST',
'content' => http_build_query($data),
],
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
if ($result === FALSE) {
\Drupal::logger('mts_sms')->error('Failed to send SMS.');
} else {
\Drupal::logger('mts_sms')->notice('SMS sent successfully.');
}
}
Создаем файл `mts_sms_confirm.module` для обработки ввода и проверки кода подтверждения:
'textfield',
'#title' => $this->t('Confirmation Code'),
'#required' => TRUE,
];
$form['submit'] = [
'#type' => 'submit',
'#value' => $this->t('Confirm'),
];
return $form;
}
/**
* {@inheritdoc}
*/
public function submitForm(array &$form, FormStateInterface $form_state) {
$entered_code = $form_state->getValue('confirmation_code');
$stored_code = \Drupal::service('user.private_tempstore')->get('mts_sms')->get('confirmation_code');
if ($entered_code == $stored_code) {
\Drupal::messenger()->addMessage($this->t('Registration confirmed successfully.'));
// Complete the user registration process here.
} else {
\Drupal::messenger()->addError($this->t('Invalid confirmation code.'));
}
}
}
Регистрируем маршрут для подтверждения кода, для чего создаем файл `mts_sms.routing.yml` и добавляем следующий код:
```yaml
confirm_code.form:
path: '/confirm-code'
defaults:
_form: '\Drupal\mts_sms\Form\ConfirmCodeForm'
_title: 'Confirm Registration Code'
requirements:
_permission: 'access content'
Шаг 3. Активация и настройка модуля
Активируем и настраиваем модуль. Для активации перейдите в административную панель Drupal и активируйте модуль `MTS SMS Integration`. Далее перейдите на страницу регистрации и зарегистрируйте нового пользователя. Остается проверить, как оно работает: отправляем SMS с кодом подтверждения на введённый номер, переходим на страницу `/confirm-code`, вводим полученный код и смотрим результат.
Учитывайте, что инструкция для интеграции с SMS API в Drupal предельно обобщенная. Весьма вероятно, что понадобится дополнительная настройка и доработка в зависимости от специфики вашего проекта и ваших требований.
Устанавливаем модуль для двухфакторной аутентификации: переходим на страницу модуля [TFA (Two-factor Authentication) ] и просто скачиваем его.
Все, необходимые модули установлены.
Настройка SMS Framework
В административной панели Drupal активируем установленные модули `SMS Framework`,`SMS МТС Exolve` и `TFA`. После этого настраиваем SMS Gateway. Переходим в `Configuration` → `SMS Framework` → `Gateways`; нажимаем `Add Gateway` и выбираем МТС Exolve, после чего вводим данные, которые нам выдали при регистрации на API-платформе.
Настройка двухфакторной аутентификации (2FA)
Чтобы настроить TFA модуль, перейдите в `Configuration` → `People` → `Two-factor Authentication`. В разделе `Plugin settings` выберите `SMS` как метод аутентификации и настройте отправку SMS с использованием ранее настроенного SMS Gateway.
Настройка подтверждения регистрации
Чтобы настроить подтверждение регистрации, снова придется немного повозиться. Выглядеть все будет примерно так:
Делаем кастомный модуль для подтверждения регистрации. Создайте папку для вашего модуля в `modules/custom` и создайте файл с именем `registration_confirm.info.yml`:
```yaml
name: 'Registration Confirmation'
type: module
description: 'Module for SMS registration confirmation.'
core_version_requirement: ^8 || ^9
package: Custom
dependencies:
- drupal/smsframework
Создаем файл модуля `registration_confirm.module`, в котором будем обрабатывать регистрацию пользователя и отправку SMS:
'tel',
'#title' => t('Phone Number'),
'#required' => TRUE,
];
// Add a submit handler to the registration form.
$form['#submit'][] = 'registration_confirm_user_register_form_submit';
}
/**
* Submit handler for user registration form.
*/
function registration_confirm_user_register_form_submit($form, FormStateInterface $form_state) {
// Get the phone number from the form.
$phone_number = $form_state->getValue('phone_number');
// Generate a random confirmation code.
$confirmation_code = rand(100000, 999999);
// Save the confirmation code to the user's session.
\Drupal::service('user.private_tempstore')->get('registration_confirm')->set('confirmation_code', $confirmation_code);
// Send the confirmation code via SMS.
$message = new SmsMessage();
$message->setRecipient($phone_number);
$message->setBody(t('Your confirmation code is @code', ['@code' => $confirmation_code]));
\Drupal::service('smsprovider')->sendMessage($message);
}
Для обработки подтверждение кода создаем форму для ввода кода и обработчик для проверки введенного кода.
Завершение и тестирование
Переходим в административную панель и активируем модуль `Registration Confirmation`. Осталось зарегистрировать нового пользователя и убедиться, что SMS отправляется корректно и пользователь может подтвердить регистрацию с помощью кода.
Преимущества подтверждения регистрации и аутентификации пользователей через API
SMS-шлюзов сейчас более чем достаточно, но вариант с API-платформой даёт немало преимуществ.
Упрощённое управление и масштабируемость
Такие платформы предлагают удобные и комплексные панели управления, что упрощает администрирование и мониторинг SMS-сообщений. С API легче масштабировать сервис при увеличении количества пользователей.
Расширенные функциональные возможности
Часто есть все средства для различных сценариев использования, таких как двухфакторная аутентификация (2FA), проверка номера телефона, уведомления и др. Помимо этого, можно легко настроить шаблоны сообщений и персонализацию.
Отчётность и аналитика
Платформы предоставляют подробные отчёты по доставке сообщений, что помогает отслеживать эффективность и выявлять проблемы. В архиве сохраняется история сообщений, есть журнал событий.
Техническая поддержка и документация
Например, в МТС Exolve чёткая, внятная документация с технической поддержкой.
Выбор между интеграцией с API-платформой и обычным SMS-шлюзом зависит от конкретных потребностей и ресурсов вашего проекта. API-платформа подходит для более сложных и масштабируемых проектов, где важны расширенные функции и безопасность, тогда как обычный SMS-шлюз может подойти для небольших и менее сложных задач с ограниченным бюджетом.
Надеюсь, эта статья поможет вам с настройкой интеграции. Учитывайте, пожалуйста, что приведенный код надо корректировать, чтобы он соответствовал требованиям вашего сайта, CMS и провайдера.
Автор: Роман Андреев