Документация BILLmanager 6

Интеграция с IPmanager. ISPmanager


Интеграция с IPmanager используется, когда в рамках услуги виртуального хостинга провайдер предоставляет клиентам выделенные (не общедоступные) IP-адреса.

Выделение IP-адресов в IPmanager не требуется в двух случаях:

  • настройки тарифа не позволяют заказывать выделенные IP-адреса для услуги виртуального хостинга. Клиенты на стороне ISPmanager могут использовать только общий IP-адрес сервера;
  • интеграция выполняется с ISPmanager Lite. Версия Lite не поддерживает назначение выделенных IP-адресов пользователям. 

В этих случаях интеграция с IPmanager может быть "фиктивной". Это значит, что можно добавить интеграцию под пользователем, у которого не настроен доступ к IP-адресам. Такого пользователя можно создать, в IPmanager, или в ISPmanager Business.

Настройка на стороне ISPmanager

Создание "фиктивного" пользователя в ISPmanager Business

Для создания пользователя в ISPmanager Business:

  1. Перейдите в Учётные записиПользователиСоздать. Заполните необходимые для создания пользователя поля.
  2. Перейдите в Учётные записиПользователи → выберите созданного пользователя → ПраваIP-адресаВыкл.

Подробнее о настройках ISPmanager см. в официальной документации.

Настройка на стороне IPmanager

IPmanager может быть установлен как на тот же сервер, где установлен BILLmanager, так и на отдельный сервер. После установки IPmanager необходимо выполнить интеграцию BILLmanager с ним. 

Перед интеграцией, на стороне IPmanager необходимо создать и настроить аккаунт (пользователя) и сети IP-адресов. 

В разделе IPmanager ГлавноеСети создаются сети, IP-адреса из которых будут выделяться для пользователей виртуального хостинга.

В разделе ГлавноеПользователи рекомендуется создать новый аккаунт (а не использовать существующий) с уровнем доступа "пользователь", который впоследствии будет использоваться для интеграции.

Каждому пользователю устанавливаются права на использование IP-адресов. Это могут быть конкретные адреса, диапазоны адресов или подсети. Для настройки прав доступа необходимо перейти в раздел Пользователи и нажать кнопку Права

Например, провайдер услуг располагает сетью IP-адресов 133.31.223.0/24. Для услуги виртуального хостинга необходимо использовать только диапазон 133.31.223.0-133.31.223.128. В таком случае, в IPmanager создается сеть 133.31.223.0/24, но пользователю назначаются права только на диапазон 133.31.223.0-133.31.223.128. 


В списке Разрешенные группы IP-адресов необходимо отметить значение alias. IP-адреса только этой группы используются для назначения пользователям виртуального хостинга. 

Настройка на стороне BILLmanager

Интеграция с IPmanager настраивается в разделе BILLmanager Интеграция IPmanager. Форма интеграции состоит из двух разделов — "Подключение" и "Синхронизация списка IP-адресов".

Подключение

  • Наименование — произвольное наименование интеграции.
  • URL — адрес IPmanager. Важно, чтобы с сервера BILLmanager указанный адрес был доступен.
  • Имя пользователя — аккаунт в IPmanager с правами доступа "пользователь". От имени этого пользователя BILLmanager будет обращаться к IPmanager и получать / возвращать IP-адреса. 
  • Пароль — пароль пользователя.
Обратите внимание!
Если вы используете "фиктивную" интеграцию с IPmanager через ISPmanager Business, укажите данные пользователя для интеграции и URL сервера с ISPmanager Business.

Синхронизация списка IP-адресов

В процессе синхронизации происходит сравнение статусов IP-адресов в IP-manager с данными BILLmanager:

  • Если IP-адрес занят в IPmanager, но в биллинге отсутствует, то BILLmanager отправит в IPmanager запрос на освобождение адреса.
  • Если IP-адрес свободен в IPmanager, но в биллинге адрес привязан к какой-либо услуге, то биллинг сделает этот адрес занятым в IPmanager.

Синхронизация выполняется от имени пользователя, под которым настроена интеграция. Соответственно, BILLmanager сможет освобождать или занимать в IPmanager адреса, принадлежащие только этому пользователю. Поэтому, иногда, для исправления статуса IP-адреса может не хватить прав доступа. На вкладке настройки синхронизации можно указать логин и пароль администратора IPmanager, чтобы исправления выполнялись без ограничений по правам доступа.

Если необходимо, чтобы некоторые типы IP-адресов не освобождались/не занимались при синхронизации, укажите их в поле Не учитывать типы IP-адресов. Под "типами IP адресов" подразумеваются группы IP-адресов, созданные в IPmanager → Группы IP адресов. Для услуг виртуального хостинга BILLmanager использует только адреса группы alias.

Обратите внимание!

Для синхронизации IP-адресов не рекомендуется указывать данные администратора IPmanager. Особенно, если в IPmanager существуют IP-адреса, занятые вручную (не BILLmanager'ом) и в биллинговой платформе эти адреса не привязаны к услугам.

В противном случае адреса будут автоматически освобождены панелью управления BILLmanager.

За синхронизацию IP-адресов отвечает задание планировщика cron fix.moduleip. По умолчанию оно запускается каждый день в 03:15.