HostMaster

BILLmanager is integrated with HostMaster, one of the popular domain name registrars.

The integration module supports the following features:

Function	Supported
Import of domains from the registrar
Transfer of domain names
Change of name servers
Change of domain contact information
Domain name verification
WHOIS data protection management
Information about account balance on the registrar side

Integration with HostMaster

Integration is configured in the process of creating a service processing module in BILLmanager.

To create a service processing module, enter Integration → Processing modules → click Add. The processing module adding wizard consists of the following steps:

1. Product type: select "Domains".
2. Processing module: select "HostMaster".
3. Integration settings. Specify the data for integration:
   
   1. EPP server:
      • for real orders: sslv3://epp.hostmaster.ua:700;
      • for tests: sslv3://test-epp.hostmaster.ua:700.
   2. User — username for access to API HostMaster;
   3. Password — user password for access to API HostMaster;
   4. Contract number  — the number  of the contract between the registrar and the public domain administrator;
   5. Path to the certificate file — path to the security certificate file. The certificate is provided by HostMaster.
   6. Path to the key file — path to the security certificate key file. Key is provided by HostMaster;
   7. Check domain status via API — check the domain status on the registrar side. Disable to option to run the check via WHOIS. Enable the option to check via the registrar's API;
   8. Disable clientHold status check for domains  — the clientHold status is set by the registrar and it means that the domain has expired and has been placed into a hold state;
      • Enabled — when the clientHold status check is disabled a client won't receive the domain expiration notification. Resource records will be active for 29 days. Later a new customer can buy the domain.
      • Disabled — when the clientHold status check is enabled a client will receive the domain suspension notification. The domain will be suspended after the expiration date and will be activated after payment. The owner won't be changed.
4. Processing module parameters. Configure internal (within BILLmanager) parameters of the service processing module.

Connection test

On the last step, BILLmanager tries to connect to the registrar with the data you have specified.

If connection ends up with the error: Cannot connect to the processing module, we recommend to check that:

• connection data is correct.
• The URL address of the registrar is accessible from the server with BILLmanager.
• you can execute API calls from the IP address of BILLmanager from your account in the registrar system.
• The security certificate has not expired.

openssl x509 -noout -text -in  <path to the certificate file>

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

• Key corresponds to the certificate.

openssl x509 -noout -modulus -in <path to certificate file> | openssl md5
openssl rsa -noout -modulus -in <path to certificate key file> | openssl md5

Logging

Log of interaction between HostMaster and the billing platform is recorded in file '/usr/local/mgr5/var/pmhostmaster.log'.

You can add string 'pmhostmaster.* 9' to file '/usr/local/mgr5/etc/debug.conf' to display more information in the log.