HostMaster

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

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

Функция	Наличие поддержки
Импорт доменов от регистратора
Трансфер доменных имен
Изменение серверов имен
Изменение контактных данных домена
Верификация доменных имен
Управление опцией "Защита данных WHOIS"
Получение информации о балансе аккаунта на стороне регистратора

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

Интеграция настраивается в процессе создания обработчика услуг в BILLmanager.

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

1. Тип продукта: "Домены".
2. Модуль обработки: "HostMaster".
3. Настройка интеграции. Укажите данные для интеграции:
   Заполните форму, используя данные существующего клиента в системе обработчика:
   1. EPP сервер:
      Для настоящих заказов: sslv3://epp.hostmaster.ua:700.
      Для тестового доступа: sslv3://test-epp.hostmaster.ua:700;
   2. Пользователь — имя пользователя для доступа к API HostMaster;
   3. Пароль — пароль пользователя для доступа к API HostMaster;
   4. Номер договора — номер действующего договора между регистратором и администратором публичного домена;
   5. Путь к файлу сертификата — путь до файла сертификата безопасности. Сертификат предоставляется HostMaster;
   6. Путь к файлу ключа — путь до файла ключа сертификата. Ключ предоставляется HostMaster;
   7. Проверка статуса доменного имени через API — опция для выбора способа проверки доступности домена. Если опция выключена, то проверка выполняется через сервис WHOIS. Когда опция активна, проверка выполняется через API регистратора домена;
   8. Отключить проверку статуса clientHold у доменов — опция для управления проверкой статуса clientHold. Статус clientHold устанавливается регистратором и означает окончание срока действия ресурсных записей и приостановку делегирования домена. 
      • Включена — проверка статуса clientHold не работает. В этом случае клиент не получит уведомления об истечении срока поддержки домена. Ресурсные записи будут активны 29 дней, после чего домен сможет купить любой пользователь.
      • Отключена — проверка статуса clientHold работает. Когда проверка статуса clientHold есть — клиент получает предупреждения о приостановке поддержки доменного имени. Работа домена останавливается сразу по завершении срока действия и возобновляется после оплаты. Домен остаётся за клиентом.
   Активируйте опцию Создать нового клиента, чтобы отобразить ссылку для регистрации в системе обработчика.
4. Параметры обработчика услуг. Настройте внутренние (в пределах BILLmanager) параметры обработчика услуг.

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

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

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

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

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

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
...

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

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

Логирование

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

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