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

При подключении модуля обработки DCImanager биллинговая платформа требует выполнить интеграцию с IPmanager. Это необходимо для централизованного управления IP-адресами.

Открывая услугу "Выделенный сервер" BILLmanager самостоятельно контролирует выбор IP-адреса: запрашивает у IPmanager свободный адрес, затем выбирает в DCImanager подходящий сервер и назначает ему этот IP-адрес.

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

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

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

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

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

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

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

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

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

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

Подключение

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

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

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

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

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

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

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

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

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

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

Назначение адресов из определённого диапазона

При интеграции BILLmanager с IPmanager вы можете настроить автоматическое назначение IP-адресов из конкретного диапазона. Для этого:

Авторизуйтесь в IPmanager под учётной записью администратора.
Создайте нужный диапазон адресов: Главное → Сети → Создать.
Создайте специальную группу адресов: Настройки → Группы IP-адресов → Создать.
Назначьте права на доступ к блокам IP-адресов пользователю, который используется для интеграции с BILLmanager: Главное → Пользователи → Права → Создать. В качестве Разрешённой группы IP-адресов отметьте добавленную группу (пункт 3).
Перейдите в BILLmanager и добавьте новое дополнение для типа продукта "Выделенный сервер": Продукты → Типы продуктов → Содержание → Создать. В поле Внутреннее имя укажите значение в формате special_ip_block_<имя группы адресов в IPmanager>. Наименование может быть произвольным.
В содержание тарифа на выделенный сервер добавьте ресурс с новым типом: Продукты → Тарифные планы → Конфиг. → Создать. В поле Тип выберите наименование созданного типа ресурсов (пункт 5). В поле Тип учёта укажите значение "Не учитывать". Этот ресурс отвечает за назначение адреса из IPmanager.
Для настроек монетизации используйте ресурсы тарифного плана "Публичные IPv4 адреса" и "IPv6 адреса".

Настройка интеграции с IPmanager 6

В платформах VMmanager 6 и DCImanager 6 есть встроенный модуль для управления адресным пространством — IPmanager 6. Чтобы настроить интеграцию с этим модулем:

Если требуется доступ только к определённому пулу IP-адресов, создайте в VMmanager 6 (DCImanager 6) пул с суффиксом public. Например, DCI5_public.
Создайте в VMmanager 6 (DCImanager 6) учётную запись администратора с именем ipmgr5@example.com.
ipmgr5@example.com — не пример, а точное имя, которое нужно указать при создании учётной записи.
В DCImanager 5 и BILLmanager:
1. Перейдите в Интеграция → IPmanager.
2. Укажите настройки для интеграции:
  1. URL — https://domain.com/api/ipmgr5/v3/ipmgr
    Пояснения к URL
    domain.com — доменное имя или IP-адрес сервера с VMmanager 6 (DCImanager 6)
  2. Имя пользователя:
    - чтобы панель управления имела доступ только к определённому пулу IP-адресов, укажите pool_XXX;
      Пояснения
      XXX — префикс пула в VMmanager 6 (DCImanager 6). Например, для пула DCI5_public укажите имя пользователя pool_DCI5.
    - чтобы панель управления имела доступ ко всему адресному пространству, укажите произвольное имя пользователя.
  3. Пароль — пароль пользователя ipmgr5@example.com.
  4. В секции Синхронизация списка IP-адресов оставьте пустыми поля Логин администратора и Пароль администратора.
3. Нажмите кнопку Ok.