Namingo EPP

Namingo EPP is an open-source PHP EPP client that enables seamless connection to EPP servers for domain registration and management. It supports multiple EPP extensions, integrates easily with any PHP framework, and is fully customizable for various domain registries.

The client also provides EPP modules for WHMCS and FOSSBilling, supporting all essential features for efficient domain management.

Install

To begin, simply follow the steps below. This installation process is optimized for a VPS running Ubuntu 22.04/24.04 or Debian 12.

Minimum requirement: a VPS with at least 1 CPU core, 2 GB RAM, and 10 GB hard drive space. Please use PHP 8.2 or PHP 8.3.

1. Navigate to your project directory and run the following command:

composer require pinga/tembo

2. In your PHP code, include the Connection.php file from the Tembo package:

require_once 'Connection.php';

3. To create test certificates (cert.pem and key.pem), if the registry does not have mandatory SSL certificates, you can use:

openssl genrsa -out key.pem 2048

openssl req -new -x509 -key key.pem -out cert.pem -days 365

4. You can now use the EppClient class and its functions in your code. You can refer to the examples directory for examples of how the package can be used.

5. To test if you have access to the EPP server from your system, you may use:

openssl s_client -showcerts -connect epp.example.com:700

openssl s_client -connect epp.example.com:700 -CAfile cacert.pem -cert cert.pem -key key.pem

6. If the registry you need to connect gave you certificates in P12 format, you will need to convert them to PEM using:

openssl pkcs12 -in your_certificate.p12 -clcerts -nokeys -out cert.pem

openssl pkcs12 -in your_certificate.p12 -nocerts -out key.pem

openssl rsa -in key.pem -out newkey.pem

Supported EPP Commands

command	domain	contact	host	session
check	✅	✅	✅	login ✅
checkClaims	✅	N/A	N/A	logout ✅
info	✅	✅	✅	poll ✅
create	✅	✅	✅	hello ✅
createDNSSEC	✅	N/A	N/A	keep-alive ✅
createClaims	✅	N/A	N/A	new password ✅
update	N/A	✅	✅
updateNS	✅	N/A	N/A
updateContact	✅	N/A	N/A
updateAuthinfo	✅	N/A	N/A
updateStatus	✅	❌	❌
updateDNSSEC	✅	N/A	N/A
renew	✅	N/A	N/A
delete	✅	✅	✅
transferRequest	✅	❌	❌
transferQuery	✅	❌	❌
transferApprove	✅	❌	❌
transferReject	✅	❌	❌
transferCancel	✅	❌	❌
rgp:restore	✅	N/A	N/A
rgp:report	✅	N/A	N/A

Supported Connection Types

type	status
EPP over TLS/TCP	✅
EPP over HTTPS	✅
RRI	✅
TMCH	✅
REGRR	❌

Registry Support (37 backends and counting)

Registry	TLDs	Extension	Status	TODO
Generic RFC EPP	any		✅
AFNIC	.fr/others	FR	✅
CARNET	.hr	HR	✅
Caucasus Online	.ge		✅
CentralNic	all		✅
CoCCA	all		✅
CORE/Knipp	all		✅
DENIC	.de		✅
Domicilium	.im		✅
DOMREG	.lt	LT	🚧	work on extensions
DRS.UA	all		✅
EURid	.eu	EU	✅
FORTH-ICS	.gr, .ελ	GR	✅
FRED	.cz/any	FRED	✅	domain update NS/DNSSEC
GoDaddy Registry	all		✅
Google Nomulus	all		✅
Hostmaster	.ua	UA	✅
Identity Digital	all		✅
IIS	.se, .nu	SE	✅
HKIRC	.hk	HK	✅
NASK	.pl	PL	✅
Namingo	all		✅
NIC Chile	.cl		✅
NIC Mexico	.mx	MX	✅
NIC.LV	.lv	LV	✅
NORID	.no	NO	✅
.PT	.pt	PT	✅
Registr.io	all		✅
Registro.it	.it	IT	🚧	work on extensions
RoTLD	.ro		✅
RyCE	all		✅
SIDN	all		✅	more tests
SWITCH	.ch, .li		✅
Traficom	.fi	FI	✅	only org contacts; more tests
Verisign	all	VRSN	✅
ZADNA	.za		✅
ZDNS	all		✅

Integration with billing systems

Would you like to see any registry added as a WHMCS/FOSSBilling module? Or an EPP module for any other billing system? Simply create an issue in this project and let us know.

WHMCS

Registry	TLDs	Status	Project
Generic RFC EPP	any	✅	whmcs-epp-rfc
Hostmaster	.ua	✅	whmcs-epp-ua
EURid	.eu	✅	whmcs-epp-eurid

FOSSBilling

Registry	TLDs	Status	Project
Generic RFC EPP	any	✅	fossbilling-epp-rfc
Hostmaster	.ua	✅	fossbilling-epp-ua
FRED	.cz/any	✅	fossbilling-epp-fred
AFNIC	.fr/others	✅	fossbilling-epp-fr
Caucasus Online	.ge	✅	fossbilling-epp-ge

Issues?

If you have any questions or need further information, feel free to reach out at help@namingo.org or join our Discord channel.