Adding Domain Registrars

Communication between CloudBlue Commerce and a domain registrar is performed using a domain plugin. This is a PHP script that implements registration operations, configuration, and other functions. Plugins for the following domain registrars are installed with CloudBlue Commerce by default:

Dummy Registrar. The dummy registrar emulates the operation of a real domain registrar and is meant to be used primarily for testing purposes.
Nominet. Nominet is the registration authority in the United Kingdom that operates the .uk domain. To learn more, visit http://www.nominet.uk.
eNom. eNom, Inc. is a domain name registrar and web hosting company that also sells SSL certificates, email services, and website building software. To learn more, visit http://www.enom.com.
WebNIC. WebNIC is a domain name registrar that also sells SSL certificates. To learn more, visit https://www.webnic.cc/aboutus/.
InternetX. InternetX, GmbH offers domain registration, SSL certificates, server hosting in their own datacenter, and web hosting services for resellers. To learn more, visit https://www.internetx.com/en/.
Note: The InternetX registrar renews specified TLD automatically. For these TLDs, the Auto-renewal option in Billing Terms of the corresponding service plan must be set to 1 day(s) before Expiration Date. Otherwise, an order fails if a registrar does not renew a domain. For information on TLDs that are renewed automatically, refer to the InternetX registrar.
MelbourneIT. Melbourne IT offers domain registration, web hosting, application development services, and managed cloud and security services for enterprises and small businesses. To learn more, visit https://www.melbourneit.com.au/about-melbourne-it/.
Openprovider. Openprovider is a Netherlands-based domain registration authority that offers domain name registration services, DNS hosting, SSL certificates, and license keys for virtualization and hosting management software by CloudBlue. To learn more, visit https://www.openprovider.co.uk/products/domainregistration/.
LogicBoxes. LogicBoxes specializes in domain registration services, web and email hosting for enterprises, and consulting domain resellers, web hosts, ISPs and telecommunication companies on gaining ICANN accreditation. To learn more, visit http://www.resellerclub.com/.
Note: The LogicBoxes plugin currently supports only the registration of domain names in the COM, NET, and ORG top level domains.
RRPproxy. RRPproxy offers domain registration, DNS and web hosting services, and SSL certificates. To learn more, visit https://www.rrpproxy.net/Contact/About_The_Company.
GoDaddy. GoDaddy offers domain registration, web and email hosting services, and SSL certificates. To learn more, visit https://aboutus.godaddy.net/newsroom/fact-sheet/default.aspx.
Note: The .es TLD is not currently supported by the plugin.
OpenSRS. OpenSRS offers domain registration, SSL certificates, hosted email services, and website security solutions. To learn more, visit https://opensrs.com/services/.
Note: The OpenSRS plugin currently supports only the registration of domain names in the COM, NET, and ORG top-level domains.
RuCenter. RU-CENTER is the Russian domain name registrar in .ru, .su, and .рф ccTLDs. To learn more, visit https://www.nic.ru/.

If the domain registrar of your choice is not on this list, you can create a custom domain registrar plugin, as described in the Domain SDK Guide, and then upload it to CloudBlue Commerce. To upload your custom domain registrar plugin, complete these steps:

Notes:

1. In the commands below, CBC_NAMESPACE is the namespace of your CloudBlue Commerce installation.

2. If you are a CloudBlue Commerce reseller, ask your CloudBlue Commerce provider to upload your custom plugin for you.

Place your custom plugin on a server from which you can access your Kubernetes cluster with kubectl. For example:

[root@ce313c210179 ~]# tree .
...
└── CustomDNSRegistrationPlugin
    └── CustomDNSRegistrationPlugin.php
...

Get the name of a Domain SDK pod. For example:

[root@ce313c210179 ~]# kubectl -n CBC_NAMESPACE get pods | grep domain-sdk
NAME                                                            READY   STATUS      RESTARTS   AGE
...
domain-sdk-75769d4dfd-vnvs8                                     1/1     Running     0          2d23h
...

Copy the directory of your custom plugin from the server to the pod to the /custom directory (the custom persistent volume is mounted to that directory). For example:
```
[root@ce313c210179 ~]# kubectl -n CBC_NAMESPACE cp CustomDNSRegistrationPlugin domain-sdk-75769d4dfd-vnvs8:/custom/
```

Restart the pods of the Domain SDK component. For example:

[root@ce313c210179 ~]# kubectl -n CBC_NAMESPACE rollout restart deployment/domain-sdk
deployment.apps/domain-sdk restarted

Wait until the pods of the Domain SDK component are restarted. After that, get the name of a Domain SDK pod. For example:

[root@ce313c210179 ~]# kubectl -n CBC_NAMESPACE get pods | grep domain-sdk
NAME                                                            READY   STATUS      RESTARTS   AGE
...
domain-sdk-6d9f84fc95-mbtbg                                     1/1     Running     0          42s
...

In that Domain SDK pod, check that the directory of your custom plugin was copied from /custom to /var/www/pa-domain-sdk. For example:

[root@ce313c210179 ~]# kubectl -n CBC_NAMESPACE exec -ti domain-sdk-6d9f84fc95-mbtbg -- ls -l /var/www/pa-domain-sdk
...
drwxr-x--x 2 apache apache  4096 Nov 29 10:44 CustomDNSRegistrationPlugin
...

Domain Registrar Configuration Workflow

To enable your customers to order domains from a registrar, do the following:

Log in to the Operations PCP.
Go to Services > Domain Registrars > Add New Registrar.
Select the respective domain plugin and click Next.
Specify plugin's required parameters and click Next.
Select the top-level domains for which the registrar will handle domains. The Available group shows the top-level domains in which this registrar can register domains. Move the required domain zones from the Available group to the Selected and click Next.
Verify the configuration and click Finish.
The selected domain registrar is now available in CloudBlue Commerce. However, to be able to register and sell domains through this registrar, you need to create service plans for all TLDs that you picked during the registrar configuration.

Note: Only providers can add new domain registrars.