.. _epp-sandbox:

EPP Sandbox
===========

Accept-Test:

.. toctree::
   :maxdepth: 1

   accepttest


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)

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

.. * Domain name ``example-pending-{account-name}.lv`` in a ``pendingCreate`` state.
   * domains for testing Domain Transfer command:
   1) You can make transfer requests for the following domains, ``<domain:pw>`` is the same as domain name in UTF-8 form (lowercase):
     * ``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``

   2) These domains are requested away from Your registrar and You can choose to ``accept`` or ``reject`` domain transfer request:
     * ``transfer-away-{client}-{1..12}.lv``
     * ``transfer-away-idn-ļā-{client}-{1..12}.lv``

    - both "managed" by a fake LVNIC registrar account (representing the Registry)

    For all accounts, ``example-reserved.lv`` domain name is available (cannot be registered).

.. note::

   Your Sandbox account will be reset at every midnight and newly created accounts will become available after the next reset cycle.

.. _epp-sandbox-transfer-testing:

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

1) 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``

2) These domains are requested away from Your registrar and You can choose to ``accept`` or ``reject`` 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 :ref:`EPP testing sequence <epp-accepttest>` should
be performed successfully before getting access to the live system.