ICANN | Proposed TLD Sponsorship Agreement: Attachment 15 (.coop)

  ICANN Logo

Proposed TLD Sponsorship Agreement: Attachment 15 (.coop)

Posted: 5 November 2001


Public Whois Specification

This Attachment is subject to change by agreement of Sponsor and ICANN during the design process as well as during the IETF standards process. However, the following provides the target architecture and initial functionality. In addition, Sponsor agrees to implement changes to this Attachment specified by ICANN to conform to the IETF provreg working group's protocol specification no later than 135 days after the IETF specification is adopted as a Proposed Standard [RFC 2026, section 4.1.1].

Poptel Whois

The Poptel Whois service is intended as a lookup service for registries, registrars, registrants, as well as for other individuals and businesses that wish to query details for .coop domain names stored in the registry. The Whois system has been designed to be lightweight and delegate more functions to the client so as to provide extreme robustness, availability and performance. This has been done through the use of three load balanced clone servers with network redundancy using a modified RWhois server for simplicity and scalability.

For the initial implementation, RWhois has been chosen due to the benefits of using its own database, named MKDB (Mark Kosters' Database). It is a fairly simple database whose purpose is to scale up well to larger databases. RWhois documentation recently reports that there are 1.9 million records in the RWhois root. The database is designed to be simple to understand and can be manipulated by hand if required. Sponsor has the discretion to migrate to a different database, provided the at least the same functionality is provided.

Additionally, provision for detection of abusive usage (e.g. excessive numbers of queries from one source) has been taken into account. It is not policy to place restrictions on Whois queries, however, Poptel reserves the right to activate abuse countermeasures if necessary. Since the Poptel Whois server is the authoritative source of domain information for .coop only, the service will only contain .coop domains.

Access to the physical systems and data is strictly controlled and managed by Poptel.

Registrars will be able to provide a front-end web interface to the standard Whois service. In addition Poptel will provide a front-end web interface to allow convenient user access to the Whois service via any system with a standard web browser.

Whois Data Management

This draws on the contents of the registry databases. It dynamically generates or deletes Whois records. These are periodically uploaded to the publicly visible Whois Servers.

Whois service features summary

  • Standard protocol accessible over TCP on port 43
  • Consistent format (fields and formatting) for all registrars
  • Near real-time updates, and the ability to change update time easily if required.
  • Extensible field capability
  • Servers return a single response per .coop domain name unless required to hold connection via holdconnection directive
  • Whois service expandable through use of directives
  • Load balanced for high availability, high load
  • Network redundancy for high availability, high load
  • Multiple servers for zero down time maintenance

Whois service data elements

These include:

  • The name of the domain name registered
  • The IP addresses of the primary Name Server and secondary Name Server(s) of the .coop domain name registered
  • The corresponding names of those Name Servers
  • The identity of the registrar
  • The original creation date
  • Date of last modification
  • Contact information for the registrant, administrative, technical, and billing contacts

Whois Queries

The Whois service will work with any RFC 954 compliant Whois client and is designed to be as simple as possible.

For all Whois queries, the client provides a character string for which information is desired and, optionally, directives and object types to control the limit of the search. If neither directives nor object types are specified, the Whois service searches for the character string in the Name fields of the Domain object. Object type controls are available to limit the search to just data in the specified object. Directives controls are available to limit the search or specify partial or full summary output. The "-directive" directives can be used by the client to get information about the directives that the server supports. The response contains the name and description of each specified directive and may be expanded in the future with additional attributes.

Object Type Controls List

Domain: Search only by domain objects. The input string is searched in the Name field.

Contact: Search only contact objects. The input string is searched in the ID field.

Nameserver: Search only nameserver objects. The input string is searched in the nameserver name field and the IP address field.

Registrar: Search only registrar objects. The input string is searched in the Name field.

By default, if no object type control is specified, then the Name field of the Domain object is searched.

Currently Supported Directives

directive:class
description:get meta-information for the class(es)

directive:directive
description:get server allowable directives

directive:display
description:sets/displays the display types

directive:forward
description:server forward boolean

directive:holdconnect
description:hold the connection boolean

directive:limit
description:displays and sets record hit limit

directive:security
description:identify the authentication method

directive:notify
description:tell server of bad referral or data change

directive:quit
description:quit connection

directive:register
description:add/mod/delete record in server

directive:schema
description:get the schema of an object

directive:soa
description:ask server's authority area

directive:status
description:server's status

directive:xfer
description:transfer data from the server

directive:X-date
description:an example of an extended directive

directive:X-pgp
description:The PGP key server gateway

Queries can be made as either an "exact search" or as a "partial search", both of which are insensitive to the case of input string.

An exact search specifies the full string to search for in the database field. An exact match between the input string and the field value is required. For example "poptel.coop" will only match with "poptel.coop".

A partial search specifies the start of the string to search for in the database field. Every record with a search field that starts with the input string will be considered a match.

To initiate partial searches the asterisk wildcard is used "*". For example "pop*" will match with "poptel.coop" as well as "popdot.coop". The Wild card query can be used in the front and/or end of the search string. By default, if multiple matches are found for a query, then full details of all matching results are presented.

The Poptel Whois service also offers boolean operator queries, this consists of simpler combined using the "and" and "or" operators.

Client/Server Session for Query

  • The client connects to the server
  • The server returns the Poptel banner
  • The client sends one or more directives to the server
  • The server returns the response to each directive
  • The client finally sends a query to the server
  • The server returns the query results

The server closes the connection, unless the client has directed not to close the connection.

Whois Output Fields

This section describes the output fields provided for each type of object.

Domain Record: A Whois query that results in domain information will return the following fields from the Domain object and the associated data from host and contact objects. This set of data is also referred to as the Domain Record.

Domain ID
Domain Name
Sponsoring Registrar
Domain Status
Registrant, Administrative, Technical and Billing Contact Information including
  Contact ID
  Contact Name
  Contact Organization
  Contact Address (3 Street Fields), City, State/Province, Country
  Contact Postal Code
  Contact Phone, Fax, E-mail
Names of nameservers associated with this domain
Created by Registrar
Last Updated by Registrar
Last Transferred Date
Additional fields (Registrar specified)
Domain Registration Date
Domain Expiration Date
Domain Last Updated Date

Nameserver Record:

Nameserver ID
Nameserver name
Currently Associated (true/false)
Nameserver status
IP addresses associated
Sponsoring Registrar
Created by Registrar
Last Updated by Registrar
Last Transferred Date
Additional fields (Registrar specified)

Contact Record:

A Whois query that results in contact information will return the following. This set of information is referred to as the Contact Record.

Contact ID
Contact Name
Contact Organization
Contact Address (3 Street Fields), City, State/Province, Country
Contact Postal Code
Contact Phone, Fax, E-mail
Currently Associated
Contact Status
ENS Identity
Sponsoring Registrar
Created Registrar
Contact Registration Date
Contact Last Updated Date
Last Transferred Date

Registrar Record:

A Whois query that results in Registrar information will return the following. This set of information is referred to as the Registrar Record.

Registrar ID (conforming to IANA registrar-id registry)
Registrar Name
Registrar Status
Registrar Address (3 Street Fields), City, State/Province, Country
Registrar Postal Code
Registrar Phone, Fax, E-mail
Registrar Administrative Contact(s)
Registrar Technical Contact(s)
Registrar Billing Contact(s)

Sample Whois Output

This section provides sample output from the Whois server for each type of Registry Object: Domain, Contact, Nameserver, and Registrar. The output is structured as key/value pairs, which simplifies machine-readability. In the Input section, the quoted string represents the string actually passed by the client to the server in the request packet.

Domain Record:

Input:

whois "domain test.coop"

Output:

Domain ID: 400032
Domain Name: TEST.COOP
Sponsoring Registrar: SAMPLE
Domain Status: ACTIVE
Registrant ID: CNT-1002
Registrant Name: A .TEST
Registrant Organization: TEST COMPANY COOP.
Registrant Address1: ADDRESS1a
Registrant Address2: ADDRESS1b
Registrant Address3: ADDRESS1c
Registrant City: ADDRESS2
Registrant State/Province: ADDRESS3
Registrant Country: ADDRESS4
Registrant Postal Code: ADDRESS5
Registrant Phone Number: +0000 0000 0000
Registrant Facsimile Number: +0000 0000 0000
Registrant Email: A.TEST@TEST.COOP
Admin ID: CNT-1003
Admin Name: A .TEST
Admin Organization: TEST COMPANY COOP.
Admin Address1: ADDRESS1a
Admin Address2: ADDRESS1b
Admin Address3: ADDRESS1c
Admin City: ADDRESS2
Admin State/Province: ADDRESS3
Admin Country: ADDRESS4
Admin Postal Code: ADDRESS5
Admin Phone Number: +0000 0000 0000
Admin Facsimile Number: +1 202 533-2970
Admin Email: A.TEST@TEST.COOP
Tech ID: CNT-1004
Tech Name: A.TEST
Tech Organization: TEST COMPANY COOP.
Tech Address1: ADDRESS1a
Tech Address2: ADDRESS1b
Tech Address3: ADDRESS1c
Tech City: ADDRESS2
Tech State/County: ADDRESS3
Tech Country: ADDRESS4
Tech Postal Code: ADDRESS5
Tech Phone Number: +0000 0000 0000
Tech Facsimile Number: +0000 0000 0000
Tech Email: A.TEST@TEST.COOP
Billing ID: CNT-1005
Billing Name: A .TEST
Billing Organization: TEST COMPANY COOP.
Billing Address1: ADDRESS1a
Billing Address2: ADDRESS1b
Billing Address3: ADDRESS1c
Billing City: ADDRESS2
Billing State/Province: ADDRESS3
Billing Country: ADDRESS4
Billing Postal Code: ADDRESS5
Billing Phone Number: +0000 0000 0000
Billing Facsimile Number: +0000 0000 0000
Billing Email: A.TEST@TEST.COOP
Name Server: DNS0.NIC.COOP
Name Server: DNS1.NIC.COOP
Created By: REG-42
Last Updated By: REG-43
Last Transferred By: REG-44
Created On: May 5, 2001
Expires On: May 5, 2003
Updated On: May 5, 2001

Contact Record:

Input:

whois "contact CNT-1002"

Output:

Contact ID: CNT-1002
Name: A.TEST
Organization: TEST COMPANY COOP.
Address: ADDRESS1
City: ADDRESS2
County/Province: ADDRESS3
Country: ADDRESS4
Postal Code: ADDRESS5
Phone Number: +0000 0000 0000
Facsimile Number: +0000 0000 0000
E-mail: A.TEST@TEST.COOP
Currently Associated (true/false): T
Contact Status: ACTIVE
ENS Identity: COOP-0010
Sponsoring Registrar: REG-42
Created On: MAY 5, 2001
Updated On: MAY 5, 2001
Transferred On: July 25, 2001

Nameserver Record:

Input:

whois "nameserver DNS0.NIC.COOP"
or
whois "nameserver 10.10.10.10"

Output:

Nameserver ID: 400032
Nameserver name: DNS0.NIC.COOP
Currently Associated (true/false):T
Nameserver Status: ACTIVE
IP Addresses Associated: 10.10.10.10
Sponsoring Registrar: REG-42
Created By Registrar: REG-43
Last Updated By Registrar: May 5, 2001
Last Transferred Date: May 5, 2001
Additional fields (Registrar specified)

Registrar Record:

Input:

whois "registrar SAMPLE"

Output:

Registrar ID: REG-42
Registrar Name: SAMPLE
Registrar Status: ACTIVE
Registrar Address 1: ADDRESS1
Registrar City: ADDRESS2
Registrar State/County: ADDRESS3
Registrar Country: ADDRESS4
Registrar Postal Code: ADDRESS5
Registrar Phone: +0000 0000 0000
Registrar Fax: +0000 0000 0000
Registrar E-mail: AN-OTHER-TEST@REG.COOP
Admin Contact: CNT-1010
Admin Contact:CNT-1011
Tech Contact: CNT-1012
Tech Contact: CNT-1013
Billing Contact: CNT-1014

Prior draft:

30 October 2001


Comments concerning the layout, construction and functionality of this site
should be sent to webmaster@icann.org.

Page Updated 11-Nov-2001
(c) 2001  The Internet Corporation for Assigned Names and Numbers. All rights reserved.