Providing domain names to clients

From ISPWiki
Jump to: navigation, search

Service description

If you want to offer domain names to your clients, complete the steps below:

  • Check or create Top-level domains in BILLmanager
  • Set up integration with domain registrars or registry
  • Configure order periods and tariff plans

Once completed, you may provide services taking into account information described in the "" section услуги с учетом особенностей работы BILLmanager, описанных в разделе "Оказание услуги"

Configuration

TLD-settings

BILLmanager includes more than 500 pre-installed Top-level domains that in most cases will be enough for you. However, you may add a new domain or fine-tune existing ones.

TLD settings include:

  • Name - enter a name in punycode or in national characters, which will be converted into punycode
  • whois host - address of the whois server associated with a TLD, or provided by your domain registrar, and supporting the TLD that you configure
  • Search string - подстрока ответа whois сервера, по которой будет определяться доступность домена для регистрации или трансфере
  • Supported characters - support of IDN TLD:
    • Latin alphabet letters - you can register domain names containing only the Latin alphabet letters, digits, and the "-" character.
    • Latin alphabet letters and characters from sets - a domain name can contain either only Latin alphabet letters, or characters from the set specified for TLD.
    • Only characters from sets - a domain name can contain either only characters from the set specified for TLD.

A set of characters for TLD are files kept in the /usr/local/mgr5/etc/idntable directory and containing characters in unicode that can be used in a domain name. A domain name can contain characters only from one set. E.g. if a TLD can use "Russian alphabet letters" and "Lating alpahbet letters", clients will be able to regster domains such as .tld and example.tld, but won't be able to register один-example.tld

  • Minimum name length - the minimum name lenght in letters of national alphavit, if TLD are supported, or in Latin alphabet letters.
  • Minimum name length - the maximum length of a name in punycode.

You can re-define settings for a specific tariff plan by selected the "Re-define zone settings" check box. This will allow you to set different price for domains of different length, or specify different whois server when registering domains with different registrars.

When you create a new tariff plan, you cane add a new TLD by selecting "New zone".

Adding a processing module

To allow clients to register domain names, you can use an integration module available in BILLmanager or create your own module for integration with domains registrars according to this article.

We do not recommend that you connect to a registrar with the same account data, as it may lead to issues with services.

To add a processing module, select "Domains" and a registrar you want to connect to. Enter required parameters to connect to a registrar, a processing module name, and click OK. The billing system will try to connect to the registrar. If the attempt fail, you will see the corresponding notification.

Once completed, you can proceed with configuration of a tariff plan.

Configuring a tariff plan

Navigate to the "Product types" module to check "Domain" settings, paying special attention to:

  • Auto deletion period - when this period is over, a domain name will be deleted from BILLmanager and on the registar's side if needed (it this action is suported).
  • Service deletion rules - select if you want to allow your clients to delete their services
  • Available payment methods - order periods available for this tariff plan. If you offer domain transfer as well, make sure that "Transfer" perio is enabled. Если предполагается предоставление услуги трансфера доменных имен, период с типом "Трансфер" должен быть включен
  • Tariff plan order form - you may ignore it, as it does not affect domain order.

Navigate to Tariff plans and select "Domains". Configuration is similar to configuration of other services in BILLmanager. For more information, refer to the article. The following parameters are specific for domain names:

  • Registrar - domain registrar
  • "Additional settings":
    • The "New zone" option - allows to add a new TLD and connect it to a tariff plan. Displays a list of all the settings described in the TLD section above. позволяет добавить и подключить к тарифу новый домен верхнего уровня, при включении отображает список настроек описанный выше в разделе настройки домена верхнего уровня
    • Domain zone - a Top-level domain, where you want to register your domain names домен верхнего уровня, для которого планируется оказание услуги регистрации доменных имен
    • Transfer policy - domain transfer policy. Possible values:
      1. Without transfer - domain transfer for this tariff is not supported
      2. Transfer without domain renewal - a domain won't be renewed after transfer
      3. Transfer and renewal for 1 year - a domain will be renewed for 1 year after transfer. You need to set any price for transfer

Other settings :

  • Late renewal fee - необходима настройка стоимости вывода из карантина, в случае если операция платна у регистратора
  • Auto deletion period - можно указать индивидуальный период удаления просроченного домена
  • Tariff description - описание, которое будет выведено вместо стандартного при заказе услуги регистрации доменных имен. Можно указать условия предоставления услуги, наименование регистратора, через которого предоставляется услуги, либо другую информацию на свое усмотрение
  • Labels - позволяют клиента фильтровать список тарифов на регистрацию доменов на форме заказа

После создания, указания стоимости периодов заказа и активации тарифного плана он будет доступен клиентам на форме заказа услуги регистрации доменных имен

Ordering a service

Domain order and registration can be performed in two ways:

  • Domain registration
  • Domain transfer to a new registrar/registrar partner

In order to register a new domain name, a customer needs to complete the following steps:

  • On a domain selection form enter desired top-level domain names and click "Check". BILLmanager will show a list of domain names that a client can register, or inform him that a desired domain name is no longer available for order. If the client didn't enter a top-level domain, the billing system will check if that domain is available for order according to client's tariff plans and other available tariff plans. The customer will be offered at least 5 domains for registration. He should select desired domains and proceed to the next step.
  • If selected domains have several order periods, the client will be offered to choose an order period for each domain.
  • Then, the client selects a pre-defined domain contact, or creates a new one. Most domain registrars requires several contacts for domain registration. The client can enter either individual or shared parameters for each of them.
  • (for specific domain zones) Next, the client enters additional parameters for his domain names. Parameters may vary depending on a TLD and domain registrar.
  • The client enters name servers that will be passed to his registrar for domain delegation. Depending on a TLD and registrar, this can be an optionsk step.
  • Finally, the client will see information about the domain name he wants to order. He will be asked to read and accept Terms and conditions, if they are configured for this tariff plans, and choose additional paid options for domain names. Paid options can be added in the "Config" section in the "Tariff plans" module.

In order to transfer a new name, a customer needs to complete the same steps, except for:

  • A client won't be offered to order domain names that he didn't enter on a domain order form;
  • Order period step is missing;
  • Instead of domain parameters, the client can enter a domain password for transfer between registrars, if required.

After the client has paid for the service, an additional status will be set for his domain:

  • "Domain registration in progress" - for domain registration
  • "Changing registrar for this domain" - for domain transfer

After the processing module has completed one of the above operations, the service status will change to "Active", and its additional status won't change unless domain verification is complete (see the procedure below).

When you transfer a domain form another registrar, in most cases the operation cannot be performed automatically, and requires manual setup either by client or by partner. In this case, the client will receive instructions, otherwise a domain should be set up manually, the current operation will fail, and you will be asked to perform additional operations to activate services.

Renewing a service

Currently clients can renew their domain names via BILLmanager only 30 days before expiration date and not later than 30 days after registration expiration date. The "Cart" and "Orders" modules can contain only only domain renewal order.

This mechanism will be improved according to individual requirements of domain zones and registrars.

After the client has paid for domain renewal, an additional status will be set: "Domain renewal in progress". The status will change once the domain renewal procedure has been complete.

Additional operations

BILLmanager supports a number of additional operations with domain names:

  • Edit domain's name servers
  • Edit domain's contact data
  • Verification of domain's contact data (for certain TLD and registrars)
  • Synchronization of domain data

Changing name servers

The client can change name servers before he pays for his domain name and after domain registration and transfer to registrar is complete. He can specify a domain name or domain with specific IP as a name server.

The client will be required to specify different name servers. An name server's IP address is a mandatory field, if the server's domain is a subdomain of the domain associated with service.

Changing contact data

Some registrars integrated with BILLmanager, allows to change domain's contact data after registration. A client can change data in the domain edit form, on which he can see the corresponding warning.

Domain data synchronization

BILLmanager synchronizes domain data with registrar's data on a regular basis. Synchronization can be started automatically with the command:

/usr/local/mgr5/sbin/billmaintain --command syncitem

Start time is specified in the Cron, you can set it according to your needs. You can check data for a specific service manually fro the panel interface -- the "Check" button.

The command is executed as follows:

  • If the syncitem command is started without parameters, the system will choose processing modules that support data synchronization and start of the same function, but with the following parameter
--module processing_module_id

Therefore, services synchronization is started on all processing modules.

  • Domains with statuses "Domain registration in progress" and "Domain renewal in progress" are selected, and request data from registrar. Domains are selected regardless the last synchronization date and domain order or renewal completion date. Check interval matches cron job interval. Отбор доменов происходит не зависимо от даты последней синхронизации или даты выполнения заказа доменного имени или его продления. Таким образом периодичность проверки совпадает с периодичность запуска задания в планировщике
  • Domains with statuses "Domain transfer from registrar" and "Changing registrar for this domain" are selected. Domain transfer order date and the last data synchronization time are checked. проверяется дата заказа услуги трансфера доменного имени и последнее время запуска синхронизации данных, для доменов прошедших отбор поочередно запрашиваются данные у регистратора. Отбор происходит по следующим критериям:
    • либо с момента заказа услуги трансфера домена не прошло одного дня (без учета времени заказа)
    • либо последний запрос данных происходил в предыдущие сутки

Таким образом в день заказа услуги периодичность ее синхронизации совпадает с периодичностью синхронизации услуг на регистрации и продлении и далее раз в сутки.

  • Отбираются домены со статусами: "Domain is registered and delegated", "Domain is registered, but not delegated" и "Закончилось делегирование домена", проверяется дата заказа услуги и последнее время запуска синхронизации данных, для доменов прошедших отбор поочередно запрашиваются данные у регистратора. Отбор происходит по следующим критериям:
    • or if less than one day passed since the service order day (order period is not taking into account)
    • or the last data request was sent more than 7 days ago

Таким образом в день заказа услуги периодичность ее синхронизации совпадает с периодичностью синхронизации услуг на регистрации и продлении и далее раз в неделю.

Domain names without statuses or with statuses different from those described above, won't be synchronized automatically. You should run the synchronization process manually.

When the processing module receives domain data synchronization command, it will request a current domain status, and its registration period, and passes them to BILLmanager. Data received from BILLmanager will be processed as follows:

  • If the service was deleted, the "Domain is not registered with registrar" status will be set regardless data received
  • For domains with the "Domain registration in progress" status:
    • При наличии текущей операции на регистрацию домена не выполняется никаких действий
    • If the "Domain is registered and delegated" or "Domain is registered, but not delegated" statuses are received, и срок действия более чем на месяц превышающий текущую дату, домен считается зарегистрированным, статус меняется на полученный, срок действия выставляется полученный от регистратора, при отсутствии выставляется дата открытия услуги
    • If the "Domain is not registered with registrar " or "Domain delegation has expired" statuses, и с даты открытия услуги прошло более семи дней, выставляется полученный статус, статус услуги меняется на "остановлен", срок действия выставляется текущей датой
  • For domains with the status "Domain renewal in progress":
    • If the renewal operation is currently running, do not perform any action. При наличии текущей операции на продление не выполняется никаких действий
    • If the "Domain is registered and delegated" or "Domain is registered, but not delegated" statuses are received, и срок действия более чем на месяц превышающий текущую дату, домен считается продленным, статус меняется на полученный, срок действия выставляется полученный от регистратора, при необходимости запускается операция активации домена
    • If the "Domain is not registered with registrar" status is received, that status will be set, the service status will change to "suspended", the срок действия выставляется текущей датой
  • for domains with the "Changing registrar for this domain" status:
    • При наличии текущей операции на трансфер или отсутствии даты открытия у услуги не выполняется никаких действия
    • If the "Domain is registered and delegated" or "Domain is registered, but not delegated" statuses are received, the domain is considered transfered, the status will change into the received one, the домен считается перенесенным, статус меняется на полученный, срок действия выставляется полученный от регистратора, клиенту отправляется уведомление о завершении процедуры переноса домена
    • If the "Домен отсутствует у регистратора" or "Закончилось делегирование домена" statuses are received, a и с даты инициирования трансфера прошло более месяца, статус меняется на полученный, срок действия меняется на текущую дату + 1 месяц или дату полученную от регистратора при наличии, клиенту отправляется уведомление о превышении срока ожидания завершения трансфера домена. Если же еще не прошло месяца с даты инициации трансфера домена
  • Для остальных текущих статусов домена:
    • Если получены статусы "Domain is not present on registrar side" или "Domain delegation expired" и не получен от регистратора срок действия или срок действия меньше текущей даты, для домена выставляется полученный от модуля статус, срок действия меняется на текущую дату
    • В случае, если у домена был статус "Domain is registered and delegated" или "Domain is registered, but not delegated" и от регистратора получен статус "Domain is registered and delegated" or "Domain is registered, but not delegated" и получена информация о сроке действия, то выставляется полученный статус и срок действия

If other data are used, no operations are performed.