BILLmanager имеет встроенный модуль интеграции с регистратором доменных имен HostMaster.

Модуль интеграции поддерживает:

ФункцияНаличие поддержки
Импорт доменов от регистратора

Трансфер доменных имен

Изменение серверов имен

Изменение контактных данных домена

Верификация доменных имен

Управление опцией "Защита данных WHOIS"

Получение информации о балансе аккаунта на стороне регистратора

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


Настройка интеграции происходит в процессе создания обработчика услуг в BILLmanager, раздел ИнтеграцияОбработчики услуг → кнопка Создать. Мастер добавления обработчика состоит из четырех шагов:

  • Шаг 1 Тип продукта. Выбор типа продукта. Для интеграции с HostMaster, необходимо выбрать "Домены".
  • Шаг 2 Модуль обработки. Выбор модуля обработки. В качестве модуля обработки указывается "HostMaster".
  • Шаг 3  Настройка интеграции. Ввод информации, необходимой для интеграции с HostMaster.
  • Шаг 4  Параметры обработчика услуг. Настройка внутренних (в пределах BILLmanager) параметров обработчика услуг. 

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

  • EPP сервер — для настоящих заказов: sslv3://epp.hostmaster.ua:700. Для тестового доступа: sslv3://test-epp.hostmaster.ua:700;
  • Пользователь — имя пользователя для доступа к API HostMaster;
  • Пароль — пароль пользователя для доступа к API HostMaster;
  • Номер договора — номер действующего договора между регистратором и администратором публичного домена;
  • Путь к файлу сертификата — путь до файла сертификата безопасности. Сертификат предоставляется HostMaster;
  • Путь к файлу ключа — путь до файла ключа сертификата. Ключ предоставляется HostMaster;
  • Проверка статуса доменного имени через API опция для выбора способа проверки доступности домена. Если опция выключена, то проверка выполняется через сервис WHOIS. Когда опция активна, проверка выполняется через API регистратора домена;
  • Отключить проверку статуса clientHold у доменов — опция для управления проверкой статуса clientHold. Статус clientHold устанавливается регистратором и означает окончание срока действия ресурсных записей и приостановку делегирования домена. 
    • Включена — проверка статуса clientHold не работает. В этом случае клиент не получит уведомления об истечении срока поддержки домена. Ресурсные записи будут активны 29 дней, после чего домен сможет купить любой пользователь.
    • Отключена — проверка статуса clientHold работает. Когда проверка статуса clientHold есть — клиент получает предупреждения о приостановке поддержки доменного имени. Работа домена останавливается сразу по завершении срока действия и возобновляется после оплаты. Домен остаётся за клиентом. 

Проверка подключения

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

Если подключение завершилось ошибкой: "Не удалось установить соединение с модулем обработки", то рекомендуется: 

  • Убедиться, что данные для подключения указаны верно;
  • URL адрес регистратора доменных имен доступен с сервера, где установлен BILLmanager;
  • В кабинете регистратора разрешено выполнять API запросы с IP-адреса BILLmanager;
  • Срок действия сертификата безопасности не истек. 

Для проверки используется команда:

openssl x509 -noout -text -in  <путь до файла сертификата>
CODE

Вывод будет следующим:

Certificate:
Data:
Version: 3 (0x2)
Serial Number: 6 (0x6)
Signature Algorithm: sha1WithRSAEncryption
Issuer: C=RU, ST=Moscow, L=Moscow, O=Hostmaster Ltd., OU=NOC, CN=hostmaster.net.ua/emailAddress=help@hostmaster.ua
Validity
Not Before: May 16 10:10:10 2016 GMT
Not After : May 16 10:10:10 2017 GMT
Subject: C=RU, ST=Moscow, L=Moscow, O=ISPsystem Ltd, OU=EPP Client, CN=ispsystem.com/emailAddress=admin@ispsystem.com
Subject Public Key Info:
Public Key Algorithm: rsaEncryption
Public-Key: (2048 bit)
Modulus:
...
Exponent: 65537 (0x10001)
X509v3 extensions:
X509v3 Subject Key Identifier: 
...
X509v3 Authority Key Identifier: 
...
X509v3 Basic Constraints: 
CA:TRUE
Signature Algorithm: sha1WithRSAEncryption
...
CODE


Not Before — дата выдачи сертификата.

Not After — дата окончания действия сертификата.

  • Ключ соответствует сертификату безопасности.

Проверка выполняется с помощью команд:

openssl x509 -noout -modulus -in <путь до файла сертификата> | openssl md5
openssl rsa -noout -modulus -in <путь до файла ключа сертификата> | openssl md5
CODE

Каждая команда вернет хеш данных. Если значения совпадают, то ключ соответствует сертификату.

Логирование


Лог взаимодействия биллинговой системы с HostMaster записывается в файл /usr/local/mgr5/var/pmhostmaster.log'

Для настройки расширенного отображения информации в логе необходимо добавить строку pmhostmaster.* 9 в файл /usr/local/mgr5/etc/debug.conf.