The APNIC Whois Database Introduction and Usage

whois.apnic.net whois.ripe.netwhois.arin.net Server Unix Client ‘X’ Client Command Prompt / Web Interface Windows Client HTTP/CGIClient WHOIS Queries & responses DB Intro Database - architecture

Object types OBJECT PURPOSE personcontact persons rolecontact groups/roles inetnumIPv4 addresses inet6numIPv6 addresses aut-numAutonomous System number domainreverse domains routeprefixes being announced mntner(maintainer) data protection Etc. etc. DB Intro

Object templates whois -t person: [mandatory] [single] [primary/look-up key] address: [mandatory] [multiple] [ ] country: [optional] [single] [ ] phone: [mandatory] [multiple] [ ] fax-no: [optional] [multiple] [ ] [mandatory] [multiple] [look-up key] nic-hdl: [mandatory] [single] [primary/look-up key] remarks: [optional] [multiple] [ ] notify: [optional] [multiple] [inverse key] mnt-by: [mandatory] [multiple] [inverse key] changed: [mandatory] [multiple] [ ] source: [mandatory] [single] [ ] % whois -h whois.apnic.net -t person To obtain template structure*, use : DB Intro *Recognised by the RIPE whois client/server

Person object example –Person objects contain contact information person: address:address: country: phone: fax-no: nic-hdl: mnt-by: changed: source: Attributes Values Ky Xander ExampleNet Service Provider 2 Pandora St Boxville Wallis and Futuna Islands WF KX17-AP MAINT-WF-EX APNIC DB Intro

Inetnum object example –Contain IP address allocations / assignments inetnum: netname: descr: country: admin-c: tech-c: mnt-by: mnt-lower: changed: status: source: CCNEP-NP-AP Communication & Communicate Nepal Ltd VSAT Service Provider, Kathmandu NP AS75 -AP AS75-AP APNIC-HM MAINT-NP-ARUN ALLOCATED PORTABLE APNIC Attributes Values DB Intro

Inter-related objects inetnum: – … admin-c: KX17-AP tech-c: ZU3-AP … mnt-by: MAINT-WF-EX … IPv4 addresses person: … nic-hdl: ZU3-AP … Contact info person: … nic-hdl: KX17-AP … Contact info mntner: MAINT-WF-EX… Data protection DB Intro

Basic database queries Unix –whois –h whois.apnic.net Web interface – Look-up keys –usually the object name –Check template for look-up keys DB Intro

% whois % whois zu3-ap % whois “zane ulrich” DB Intro person: Zane Ulrich address: ExampleNet Service Provider address: 2 Pandora St Boxville address: Wallis and Futuna Islands country: WF phone: fax-no: nic-hdl: ZU3-AP mnt-by: MAINT-WF-EX changed: source: APNIC Database query - UNIX

Database query - web Query the APNIC Whois Database 2.Search options (flags) 1.Type in search key 3. ‘Search Whois’ DB Intro

Database query - inetnum Note Incomplete addresses padded with “.0” Address without prefix interpreted as “/32” % whois % whois SINGNET-SG % whois /19 inetnum: netname: SINGNET-SG descr: Singapore Telecommunications Ltd descr: 31, Exeter Road, #02-00, Podium Block descr: Comcentre, 0923 country: SG admin-c: CWL3-AP tech-c: CWL3-AP mnt-by: APNIC-HM changed: source: APNIC DB Intro

Advanced database queries –Flags used for inetnum queries None find exact match - l find one level less specific matches - L find all Less specific matches - m find first level more specific matches - M find all More specific matches - x find exact match - d enables use of flags for reverse domains - r turn off recursive lookups DB query

inetnum: – /20 inetnum: – /8 Database query - inetnum /25 inetnum: whois -L /20 whois /20 whois –m /20 inetnum: /26 inetnum: /24 More specific  (= smaller blocks) Less specific  (= bigger block) DB query

Whois domain object domain: in-addr.arpa descr: in-addr.arpa zone for in-addr.arpa admin-c: DNS3-AP tech-c: DNS3-AP zone-c: DNS3-AP nserver: ns.telstra.net nserver: rs.arin.net nserver: ns.myapnic.net nserver: svc00.apnic.net nserver: ns.apnic.net mnt-by: MAINT-APNIC-AP mnt-lower: MAINT-DNS-AP changed: source: APNIC

Reverse delegation procedures Complete the documentation On-line form interface –Real time feedback –Gives errors, warnings in zone configuration serial number of zone consistent across nameservers nameservers listed in zone consistent –Uses database ‘domain’ object

Online errors (also via ) Please wait while your request is processed. Parsing and validating your submission … Errors encountered Your update request was unable to be completed due to the following errors. Please correct them and try again. If the error is temporary in nature, correct the error and ‘Reload’ this page (possibly this frame). *ERROR*. SOA on “ns.apnic.net” does not match SOA on “svc00.apnic.net”. All nservers must respond with the same SOA. *ERROR*. NS RR for ns.telstra.net found on svc00.apnic.net but not in supplied template. *ERROR*. NS RR for ns.telstra.net found on ns.apnic.net but not in supplied template. *ERROR*. cross-check of listed NS RR failed.

Request submission error Verifying your authorisation …. Your maintainer uses the ‘CRYPT-PW’ or ‘NONE’ authorisation schema. Attempting to submit your request directly to the database. Update results Connection closed. % Rights restricted by copyright. See Update FAILED: [domain] in-addr-arpa domain: in-addr.arpa descr: in-addr.arpa zone for /16 admin-c: DNS3-AP tech-c: DNS3-AP zone-c: DNS3-AP nserver: ns.apnic.net nserver: svc00.apnic.net mnt-by: MAINT-AP-DNS-DEFAULT changed: source: APNIC *ERROR*: authorisation failed, request forwarded to maintainer Processing completed Update failed Authorisation failed

Successful update Please wait while your request is processed. Parsing and validating your submission … Warnings generated Verifying your authorisation …. Your maintainer uses the ‘CRYPT-PW’ or ‘NONE’ authorisation schema. Attempting to submit your request directly to the database. Update results Connection closed. % Rights restricted by copyright. See Update OK: [domain] in-addr.arpa Processing completed. Update ok!

Questions ?