Create domain[Link]

Purpose

create a new domain name.

The EPP protocol specifies two ways of working with name servers:

name servers as first-class objects.
name servers merely as attributes to a domain name. It is this possibility that DNS Belgium has adopted. Technically speaking, this means you will need to use the <hostAttr> element and not the <hostObj> element.

DNS Belgium does not have host objects as separate entities. A name server is specified on the domain object command; and is created, deleted or updated as needed, transparently to the client. A host/name server cannot be accessed directly as an EPP object.

The EPP standard supposes that the domain name that is being registered, contains the trailing TLD extension. This is because EPP can be used by registries that manage more than one extension. For consistency reasons, we will accept domain names without the ‘.be’ extensions. If, however, an extension is provided, it will be checked and only ‘.be’ extensions will be handled.

The elements and tags that are relevant for DNS Belgium are specified below. Tags that are optional can be omitted without producing an XML parsing error. Some components of the command need further explanation:

<domain:name> is required. Is the domain name to create, with or without the trailing ‘.be’. It can be more than 63 characters long but will return an error from the transaction processor when that is the case.
<domain:period> is optional. Is the domain validity period. Only accepted values are 1 with unit ‘y’ (year) and 12 with unit ‘m’ (month).
<domain:ns> is optional. Contains a list of name servers.
<domain:hostAttr> is required if <domain:ns> is present. DNS Belgium server policy limits up to 9. Optional <hostAddr> elements allow for specifying required glue records.
<domain:registrant> is required. Is the registrant alias of the domain. The registrant must be a valid contact, created on the system before with either EPP or via other means (web).
<domain:contact> Is the list of contacts to associate with this domain. The type attribute can be one of: ‘billing’ (billing contact) (exactly 1), ‘tech’ (technical contact) (0 to 5), ‘onsite’ (onsite contact) (0 to 5). DNS Belgium policy requires 1 ‘billing’ contact and at least 1 of ‘tech’ or ‘onsite’. The command will fail when the number of contacts per type violates the above rules.
<domain:authInfo> Contains the authorization information associated with the domain. This value is currently ignored. As it is a required element in the schema, it must be provided. However, you don’t have to specify a value between the tags.
<dnsbe:nsgroup> is optional. Contains the list of name server groups.
<dnsbe:keygroup> is optional. Contains the list of keygroups.
<secDNS:keyData> is optional. Contains a list of maximum 4 keys. Following elements are required if this is present:
<secDNS:flags> DNS Belgium only accepts flag 257 (KSK).
<secDNS:protocol> Indicates the protocol used, DNSSEC requires protocol 3.
<secDNS:alg> Indicates the algorithm used to generate the key, DNS Belgium recommends these algorithms to generate keys: (8) RSA-SHA256, (10) RSA-SHA512, (13) ECDSA Curve P-256 with SHA-256, (14) ECDSA Curve P-384 with SHA-384, (15) ED25519 and (16) ED448.
<secDNS:pubKey> Contains the value of the public key.

More information about new domain names can be found under General.

Please refer to the examples to see a complete request.

Examples[Link]

A simple registration:

<epp xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd urn:ietf:params:xml:ns:domain-1.0 domain-1.0.xsd http://www.dns.be/xml/epp/dnsbe-1.0 dnsbe-1.0.xsd" xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:dnsbe="http://www.dns.be/xml/epp/dnsbe-1.0">
  <command>
    <create>
      <domain:create>
        <domain:name>greatdomain.be</domain:name>
        <domain:registrant>c16</domain:registrant>
        <domain:contact type="billing">c14</domain:contact>
        <domain:contact type="tech">c17</domain:contact>
        <domain:authInfo>
          <domain:pw>not-used</domain:pw>
        </domain:authInfo>
      </domain:create>
    </create>
<clTRID>client-00016</clTRID>
</command>
</epp>

The result of this transaction will be another document for which you can find the description(s) in the EPP schemas:

<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
  <response>
    <result code="1000">
      <msg>Command completed successfully</msg>
    </result>
    <resData>
      <domain:creData>
        <domain:name>test-domain-2.be</domain:name>
        <domain:crDate>2006-10-09T09:45:17.586Z</domain:crDate>
      </domain:creData>
    </resData>
    <trID>
      <clTRID>client-00016</clTRID>
      <svTRID>dnsbe-111</svTRID>
    </trID>
  </response>
</epp>

The following information can be seen in the reply:

<result> Contains the result information. See EPP result code list for more information on the meaning of codes.
<msg> Is the result code in text format.
<domain:name> Is the domain name created (with the trailing ‘.be’)
<domain:crDate> Is the real creation date in UTC time.
<clTRID> Is the transaction ID provided by the registrar in the input command.
<svTRID> Is the server unique transaction ID.

The registration of a domain name with name servers (one with a glue record) and one name server group.

<epp xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd urn:ietf:params:xml:ns:domain-1.0 domain-1.0.xsd http://www.dns.be/xml/epp/dnsbe-1.0 dnsbe-1.0.xsd" xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:dnsbe="http://www.dns.be/xml/epp/dnsbe-1.0">
  <command>
    <create>
      <domain:create>
        <domain:name>greatdomain.be</domain:name>
        <domain:ns>
          <domain:hostAttr>
            <domain:hostName>ns.hostingcompany.be</domain:hostName>
          </domain:hostAttr>
          <domain:hostAttr>
            <domain:hostName>ns.greatdomain.be</domain:hostName>
            <domain:hostAddr>193.168.0.1</domain:hostAddr>
          </domain:hostAttr>
        </domain:ns>
        <domain:registrant>c16</domain:registrant>
        <domain:contact type="billing">c14</domain:contact>
        <domain:contact type="tech">c17</domain:contact>
        <domain:authInfo>
          <domain:pw>not-used</domain:pw>
        </domain:authInfo>
      </domain:create>
    </create>
    <extension>
      <dnsbe:ext>
        <dnsbe:create>
          <dnsbe:domain>
            <dnsbe:nsgroup>mynsgroup1</dnsbe:nsgroup>
          </dnsbe:domain>
        </dnsbe:create>
      </dnsbe:ext>
    </extension>
    <clTRID>clientref-00017</clTRID>
  </command>
</epp>