EPP Sandbox¶
Accept-Test:
To support our clients in developing and testing of their EPP client implementations, we offer a sandbox environment.
Sandbox server is available at epp-sandbox.nic.lv, on the standard EPP port number 700 and uses TCP over SSL for connection. The client SSL certificate is optional.
To gain access to the sandbox environment, the client should have a contract with the Registry as a registrar and submit a request to registrars@nic.lv, providing one or more IP addresses from which connections would be made.
In response, we will provide access details for the sandbox account: EPP client ID (account name) and an initial password. The answer would include:
- contact handle of the billing contact (containing the same data as registrar’s primary person in the real system)
- contact handle of the default technical contact (too, copied from registrar’s default hostmaster account in the real system)
A new account on the sandbox server will be created along with a minimum dataset for testing purposes, including:
- a registered domain name
example-{account-name}.lv
along with:- registrant and administrative contacts for the domain (with fake data). (These contacts may be assigned to other domains, created in a testing process)
- Two networks (nameservers):
- subordinated host:
ns.example-{account-name}.lv
(with IP address given for glue record) - delegated host:
ns.nonexisting.lv
(without IP)
- subordinated host:
- Registrar primary person (billing contact) and hostmaster contact would have the same details as Your registrar account in our live web selfcare panel, https://www.nic.lv.
- contact handle for billing contact:
{account-name}-bill
- contact handle for hostmaster contact(s):
{account-name}-adm0
,{account-name}-adm1
and so on..
- contact handle for billing contact:
Note
Your Sandbox account will be reset at every midnight and newly created accounts will become available after the next reset cycle.
Transfer Testing¶
In order to test <transfer>
command in epp-sandbox.nic.lv, we provide each registrar with test domains. Each domain is named after an action that the sandbox server will carry out on behalf of the other party - acting in name of registrar, holding sponsorship of domain name. E.g. Your request will be accepted if You (epp user - “TestUser”) will request a transfer of transfer-accept-testuser-7.lv
.
- You can make transfer requests for the following domains,
<domain:pw>
is expected to contain the same domain name (lowercased) in UTF-8 form:
transfer-accept-{client}-{1..12}.lv
transfer-accept-idn-ļā-{client}-{1..12}.lv
transfer-reject-{client}-{1..12}.lv
transfer-reject-idn-ļā-{client}-{1..12}.lv
transfer-ignored-{client}-{1..12}.lv
transfer-ignored-idn-ļā-{client}-{1..12}.lv
- These domains are requested away from Your registrar and You can choose to
accept
orreject
domain transfer request:
transfer-away-{client}-{1..12}.lv
transfer-away-idn-ļā-{client}-{1..12}.lv
We provide 12 domain names of every category and, even if used up, they would become available for testing again on the next day.
Where to start?¶
You can checkout already made libraries like https://github.com/metaregistrar/php-epp-client, it supports bunch of different TLDs including .lv .lv repository has demo attached, so there are some premade functions You can use.
Going Live¶
When registrar feels the client-side software is mature enough for moving on from a sandbox to the production environment, a simple EPP testing sequence should be performed successfully before getting access to the live system.