Call To Action

In a bid to create more awareness around COVID-19 Government has called on all .za domain name holders that have an associated website to create a landing page with a visible link to www.sacoronavirus.co.za. For more details see section 5.1.4 of Regulation No. 43164 published on 26 March 2020.

ZA Logging In/Out

Table of Contents

1. Login Command

2. Possible Responses
  2.1. 1000: Access Granted
  2.2. 2501: Incorrect Credentials
  2.3. 2307: Accessing Services That Are Unavailable
  2.4. 2202: Already Authenticated

3. Logging Out
  3.1. 1500: Logout Successful

4. Changing Password On Login

 

Logging In

 

Notes

1. The <login> element specifies that a login command is being attempted.

2. Within the <login> element, various child elements must be included.

3. The <clID> must be populated. The <clID> element references the registrar's ID that was given as part of the Live Credentials.

4. The <pw> element must be populated with the registrar's password.

5. The <version> element refers to the version of the XML schema to be used. co.za will inform registrars of schema version changes if the schema version is increased.

6. The <lang> element specifies the language to be used. For most registrars this will be en indicating English.

7. The <svcs> element will include which services the registrar wants to access. In the <objURI> element, the service can be specified. Available services will be made available to registrars.

8. The <clTRID> element must be populated with a unique identifier. The length of the identifier must be a minimum of 3 characters and a maximum of 64 characters. For every login, the <clTRID> must be populated with a new identifier to avoid idempotentcy.

 

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <command>
    <login>
       <clID>testrar1</clID>
      <pw>password</pw>
      <options>
        <version>1.0</version>
        <lang>en</lang>
      </options>
      <svcs>
        <objURI>urn:ietf:params:xml:ns:domain-1.0</objURI>
        <objURI>urn:ietf:params:xml:ns:contact-1.0</objURI>
      </svcs>
    </login>
    <clTRID>RAR-LOGIN-0000001</clTRID>
  </command>
</epp>

 

Possible Responses

This section identifies the possible responses from the server when attempting to log in.

 

1000: Access Granted

A response code of 1000 means that the command was sent through successfully and that access has been granted to the system.

 

<epp:epp xmlns:epp="urn:ietf:params:xml:ns:epp-1.0">
  <epp:response>
    <epp:result code="1000">
     <epp:msg>Access granted</epp:msg>
    </epp:result>
    <epp:trID>
     <epp:svTRID>ZACR-EPP-12A8A9FDBF6-17928</epp:svTRID>
    </epp:trID>
  </epp:response>
</epp:epp>


2501: Incorrect Credentials

A response code of 2501 means that the provided credentials were incorrect. To rectify this please review the provided information in the <cLID> and <pw> elements.

<epp:epp xmlns:epp="urn:ietf:params:xml:ns:epp-1.0">
  <epp:response>
    <epp:result code="2501">
      <epp:msg>Login failure: Incorrect username or password</epp:msg>
    </epp:result>
    <epp:trID>
      <epp:svTRID>ZACR-EPP-12A9F46835C-C4787</epp:svTRID>
    </epp:trID>
  </epp:response>
</epp:epp>
 
2307: Accessing Services That Are Unavailable

 A result code of 2307 means that services that are not available to the registrar on the server were trying to be accessed. To rectify this, review the available services  within the <svcs>/<objURI> element. All available services on the server may be obtained through an EPP Hello Command.

<epp:epp xmlns:epp="urn:ietf:params:xml:ns:epp-1.0">
  <epp:response>
    <epp:result code="2307">
      <epp:msg>The following requested services are unavailable:
[urn:ietf:params:xml:ns:host-1.0]</epp:msg>
    </epp:result>
    <epp:trID>
      <epp:svTRID>ZACR-EPP-12AA42728B2-72106</epp:svTRID>
    </epp:trID>
  </epp:response>
</epp:epp>

 


2202: Already Authenticated
 A result code of 2002 means that there is already a session running and that a Login is not required. To rectify this, either Logout after each command or run commands within the session without attemting a login.
 
 
<epp:epp xmlns:epp="urn:ietf:params:xml:ns:epp-1.0">
  <epp:response>
    <epp:result code="2002">
      <epp:msg>Already authenticated</epp:msg>
    </epp:result>
    <epp:trID>
      <epp:svTRID>ZACR-EPP-138FB3D8E5A-41032</epp:svTRID>
    </epp:trID>
  </epp:response>
</epp:epp>

 


Logging Out

 

Command

 

To log out of the system, an EPP Logout command has to be issued to the server. To achieve this, the <logout/> element has to be included within the <command> element. The <logout/> element does not require any further information.

The final required element is the <clTRID> element. Within this element, a unique string must be specified. The string must be a minimum of 3 characters and a maximum of 64.

 

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <command>
    <logout/>
    <clTRID>RAR-LOGOUT-0000001</clTRID>
  </command>
</epp>

 

1500: Logout Successful

 

If the request was sent through correctly, the server will respond with a result code of 1500. This means the logout was successful.


<epp:epp xmlns:epp="urn:ietf:params:xml:ns:epp-1.0">
  <epp:response>
    <epp:result code="1500">
      <epp:msg>Command completed successfully; ending session</epp:msg>
    </epp:result>
    <epp:trID>
      <epp:svTRID>ZACR-EPP-12A8AA85E2B-1C8CF</epp:svTRID>
    </epp:trID>
  </epp:response>
</epp:epp>
 

Changing Pasword on login

The login password may be changed through the login command by including the <newPW> as outlined below. If a successful login is performed, the new password will be applied at the end of the current session.

NOTE: The length of the password may not be longer than 16 ASCII characters.


<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <command>
    <login>
       <clID>RegistrarID</clID>
      <pw>password</pw>
          <newPW>NEW_PASSWORD</newPW>
      <options>
        <version>1.0</version>
        <lang>en</lang>
      </options>
      <svcs>
        <objURI>urn:ietf:params:xml:ns:domain-1.0</objURI>
        <objURI>urn:ietf:params:xml:ns:contact-1.0</objURI>
      </svcs>
    </login>
    <clTRID>RAR-LOGIN-0000001</clTRID>
  </command>
</epp>

 

Last update: 07-07-2014 01:13:39

Technical Support

All issues and questions relating to the co.za EPP Registry Registrar System must be raised in the Contact/Support pages through the Registrar Portal. This is to ensure that our support department tracks and addresses all issues. Log in to the Registrar Portal and submit a support request online.

 

Registrar Noticeboard

Click here for the latest status updates.

日日摸夜夜添夜夜添无码_最新亚洲中文字幕一区在线_尹人香蕉视频在线观看