Настройка SMS-аутентификации на Ubiquiti UniFi Controller

Эта инструкция поможет вам настоить гостевой портал для Wi-Fi с аутентификацией через СМС в сети Ubiquiti. Уникальное решение Protectimus интегрируется непосредственно с контроллером Ubiquiti UniFi, обеспечивая надежную защиту доступа к вашей Wi-Fi сети с помощью SMS-авторизации. Вы можете выбрать любого поставщика SMS, который соответствует вашим предпочтениям.

После настройки гостевого портала для контроллера UniFi и его интеграции с Protectimus, процедура аутентификации через SMS в Wi-Fi сети будет проходить следующим образом:

1. Пользователь, желающий подключиться к Wi-Fi, вводит свой номер телефона.
2. На телефон пользователя приходит SMS с одноразовым паролем.
3. Пользователь вводит полученный одноразовый пароль в предназначенное для этого поле.
4. Protectimus проверяет введенный одноразовый пароль и определяет, можно ли разрешить пользователю доступ к Wi-Fi сети.

Сервер Protectimus поддерживает детализированное логирование в формате CSV. Записываются MAC-адрес пользователя, MAC-адрес точки доступа, предоставленный IP и введенный номер телефона. Срок хранения данных можно настроить в соответствии с требованиями заказчика. Согласно законодательству большинства стран, данные должны храниться не менее 6 месяцев.

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

1. Зарегистрируйтесь и задайте базовые настройки

1. Зарегистрируйтесь в Облачном сервисе Protectimus и активируйте API или установите Локальную платформу Protectimus (если вы устанавливаете платформу Protectimus на Windows, не забудьте пометить опцию Radius).
2. Создайте ресурс.

2. Установите Protectimus Unifi Guest Portal Server из Docker-образа

1. Для установки Protectimus Unifi Guest Portal Server необходимо скачать и установить docker, docker-compose:

• Docker: https://docs.docker.com/engine/install/
• Docker-compose: https://docs.docker.com/compose/install/

2. Склонировать git репозиторий: https://github.com/protectimus/platform-linux.git

3. После успешного клонирования репозитория git, отредактируйте файл, расположенный по пути unifi-guest-portal/config/guest-portal.yml, и добавьте в него свойства, описанные в третьем параграфе.

4. Перейдите в каталог unifi-guest-portal и запустите:
   
   

   docker-compose up -d

5. За процессом разворачивания Protectimus Unifi Guest Portal Server можно наблюдать используя команду:
   
   

   docker-compose logs -f

6. Также есть дополнительный файл fragments.html, который необходим для настройки интерфейса экрана входа.

7. После завершения процесса запуска, Protectimus Unifi Guest Portal Server будет доступен по адресу:

   https://localhost:8080

   
   
   Вы можете изменить порт в файле конфигурации (unifi-guest-portal/config/guest-portal.yml).

Если по какой-либо причине вы не можете использовать Docker-образ, пожалуйста, свяжитесь с нашей службой поддержки, и мы поможем вам с установкой.

3. Настройте параметры Protectimus Unifi Guest Portal Server

Параметры сервера аутентификации Protectimus Unifi Guest Portal Server можно настроить, указав их в файле guest-portal.all.yml, который должен быть расположен в той же папке, что и запускаемый файл.

Задайте в файле guest-portal.all.yml следующие значения:

3.1. Настройки сервера гостевого портала

server:
  port: 8888
  ssl:
	enabled: true
	key-store-type: PKCS12
	key-store: classpath:keystore/guest-portal.p12
	key-store-password: password
	key-alias: guest-portal

port:

ssl:

3.2. Настройки Unifi

unifi:
  cookie-expiration-time: 30000
  base-url: https://localhost:8443
  username: admin
  password: admin
  sites-verification-enabled: true
  sites:
	- default
  session:
	duration-minutes: 90
	download-speed: 2048
	upload-speed: 640
	quota: 4096
  redirect-page: https://www.google.com

cookie-expiration-time:

base-url:

username:

password:

sites-verification-enabled:

sites:

session:

redirect-page:

3.3. Настройки PROTECTIMUS API (настройка подключения к сервису PROTECTIMUS)

protectimus-api:
  login:
  api-key:
  url: https://api.protectimus.com/
  resource-id: 

login:

api-key:

url:

resource-id:

3.4. Настройки файла с отчетом

report:
  csv:
	params:
  	- action
  	- id
  	- ip
  	- ap
  	- ssid
  	- time
  	- phoneNumber
	date-format: 'yyyy-MM-dd HH:mm:ss z'
	zone-id: UTC

csv:

params:

date-format:

zone-id:

3.5. Пример конфигурационного файла guest-portal.all.yml

server:
  port: 8888
  ssl:
	enabled: true
	key-store-type: PKCS12
	key-store: file:guest-portal.p12
	key-store-password: password
	key-alias: guest-portal

unifi:
  base-url: https://localhost:8443
  username: admin
  password: admin
  sites:
	- default

protectimus-api:
  login: test@protectimus.com
  api-key: secret
  url: https://api.protectimus.com/
  resource-id: 1

logging:
  level:
	com.protectimus: INFO

4. Настройте Ubiquiti UniFi Controller

4.1. Создайте гостевую группу пользователей

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

1. Перейдите в Settings —> User Groups.
2. Выберите Create New User Group.
3. Присвойте группе имя, например, Guests.
4. Установите ограничения скорости загрузки и выгрузки. Для базового интернет-серфинга должно быть достаточно 5 Мбит/с для скачивания и 1 Мбит/с загрузки. Однако, если вы хотите разрешить потоковое воспроизведение, убедитесь, что минимальная скорость скачивания составляет 10 Мбит/с.
5. Нажмите Save чтобы сохранить настройки.

4.2. Создайте беспроводную гостевую сеть Unifi

Теперь вам необходимо настроить специальную беспроводную сеть для ваших гостей, Guest Network. В этой сети будут действовать некоторые важные правила:

• Pre and Post-Authorization Access: Это означает, что гости могут использовать страницу входа в сеть для регистрации. Но после того как они войдут в систему, им не будет разрешен доступ к основной сети.
• Client Isolation: Эта функция предотвращает отправку сообщений гостями друг другу внутри той же сети. Она обеспечивает конфиденциальность и безопасность их коммуникации.

Для создания Гостевой сети:

1. Откройте Unifi Controller.
2. Перейдите в Settings —> Wireless Networks.
3. Нажмите на Create New Wireless Network.
4. Присвойте сети имя, которое гости легко будут узнавать.
5. Пока установите безопасность на «открыто» — open.
6. Выберите Apply guest policies (captive portal, guest authentication, access).
7. Раскройте дополнительные настройки Advanced Options.
8. Выберите User Group, которую вы только что создали.

Вы успешно настроили Гостевую сеть (Guest Network). Теперь вам нужно настроить Captive Portal.

4.3. Настройте гостевые политики

В контроллере Unifi перейдите в раздел Управление гостями (Guest Control), где вы легко сможете создать Гостевой портал и настроить метод аутентификации и продолжительность доступа.

Настройте Политики для гостей (Guest Policies), как показано на изображении ниже.

1. Активируйте гостевой портал (Guest Portal).
2. Выберите External portal server.
3. Введите IP-адрес сервера аутентификации гостевого портала Protectimus Unifi в поле IPv4 Address.
4. Выберите Redirect using hostname и укажите URL-адрес страницы, которую клиент попытается открыть после успешной аутентификации на гостевом портале (например, google.com).
5. Поле Pre-Authorization Access обычно остается пустым по умолчанию.
6. Для Post-Authorization Restrictions введите подсеть вашей локальной сети. По умолчанию все возможные адреса локальной сети заблокированы, поэтому вы можете оставить это без изменений. Однако, если вы хотите предоставить гостям доступ к конкретным устройствам, таким как принтер, ограничив доступ к остальной части вашей сети, вы можете установить эти ограничения здесь. Рекомендуется использовать разные подсети для вашей гостевой сети и собственной сети, чтобы упростить эти ограничения.

Если у вас есть другие вопросы, свяжитесь с нашей службой поддержки клиентов.