3 Nameserver Registrieren, Abfragen und Ändern eines Nameserver(Host)-Handles

Transkript

1 1. Allgemeines Über die SGAP-Schnittstelle lassen sich folgende Anträge stellen: 1 Person(Contact)-Handle Registrieren, Abfragen und Ändern eines Contact-Handles. 2 Domain-Name Registrieren, Abfragen, Ändern und Löschen einer Domain 3 Nameserver Registrieren, Abfragen und Ändern eines Nameserver(Host)-Handles 2. Ablauf der Verarbeitung Alle Clientanträge befolgen folgendes Format: resellerid/password\r\n suffix command\r\n Das Trennzeichen zwischen der resellerid und dem password ist das Slash Zeichen (ASCII 47). Das Trennzeichen zwischen dem suffix und dem SGAP-Command ist das Pipe Zeichen(ASCII 124). Jede Zeile wird durch Carriage Return, New Line abgeschlossen. Es gibt drei mögliche Antworten des SGAP-Servers: 1. Der Antrag wurde erfolgreich bearbeitet, der SGAP-Server meldet zurück: OK[H GLOBE]\r\n In Klammern steht entweder das soeben neu angelegte Handle oder die entsprechenden Daten zu einem Contact oder Domain-Object oder Command completed successfully 2. Bei der Bearbeitung ist ein Fehler aufgetreten, der SGAP-Server meldet zurück: ERR[Fehlermeldung]\r\n 3. Bei den Domains, die nicht in Echtzeit bearbeitet werden, meldet der SGAP-Server: PENDING[CONTACT-12345]\r\n Die Antwort des SGAP-Servers wird ebenfalls mit Carriage Return/New Line abgeschlossen.

2 Über die SGAP-Schnittstelle lassen sich viele verschiedenen TLD Domains verwalten. Anhand des suffixes wird unterschieden, auf welche TLD sich der entsprechende Befehl bezieht. In der folgenden Tabelle sind die TLDs und der entsprechende suffix dargestellt: TLD.com.net.org.info.biz.cc.at.co.at.or.at.ch.li.de suffix com org info biz cc at switch speed Der SGAP-Server kann pro Verbindung nur einen Antrag bearbeiten.

3 Client SGAP- Server Socket connection to port Connection established SGAP-Server Greeting Authorization Send command to SGAP-Server com CHECK mydomain.com\r\n SGAP-Server response OK[+]\r\n Connection terminated Beispiele: Für alle Beispiele in diesem Handbuch gilt: mit blauer Schrift sind die Antworten des SGAP- Server gekennzeichnet, mit schwarzer Schrift sind die Clientanfragen an den Server dargestellt. 3. Transaktionen 3.1 Person-Transaktionen CONTACT Mit diesem Befehl wird ein neues Person(Contact) Handle angelegt. Das Handle wird später bei der Registrierung einer neuen Domain benötigt.

4 CONTACT firstname;lastname;organization;street;city;state;pc;country;voice;fax; Bemerkungen zu den einzelnen Feldern: <firstname> Vorname der Contact-Person, Pflichtfeld. <lastname> Nachname der Contact-Person, Pflichtfeld. <organization> Firmenname, das Feld ist optional. <street> Adresse der Contact-Person, Pflichtfeld. <city> Stadt, Pflichtfeld. <state> Bundesland, optionales Feld. <pc> ZIP (Postalcode), Pflichtfeld <country> Land, Pflichtfeld. Das Landeskennzeichen ist der 2-stellige ISO-Landescode (ISO 3166) z.b. AT, DE, etc. <voice> Telefonnummer der Contact-Person, Pflichtfeld. Format: +zz.xxxxxxxxxx zz = Ländervorwahl xx = Telefonnummer z.b und *NICHT* und *NICHT* <fax> Faxnummer der Contact-Person, optionales Feld. Format ( siehe <voice> ) < > adresse der Contact-Person, Pflichtfeld. Erfolgreiches Anlegen eines neuen Handles:

5 SGAP2 V1.00 Server ready at: :49: (Build: Dec :47:28) info CONTACT Max;Pichler;-;Salesianergasse 3/11A;Wien;Wien;1030;AT; ;- OK[H GLOBE] NIcht vollständige Angaben: SGAP2 V1.00 Server ready at: :47: (Build: Dec :47:28) info CONTACT Max;Pichler;-;Salesianergasse 3/11A;Wien;Wien;1030;AT; ;\r\n ERR[fax number missing!] Falsche Angaben (ungültige Telefonnummer): SGAP2 V1.00 Server ready at: :44: (Build: Dec :47:28) info CONTACT Max;Pichler;-;Salesianergasse 3/11A;Wien;Wien;1030;AT; ;- ERR[2005 Parameter value syntax error] Handle anlegen bei einer.at,.co.at oder.or.at Domain: SGAP2 V1.00 Server ready at: :03: (Build: Dec :47:28) at CONTACT Max;Pichler;-;Salesianergasse 3/11A;Wien;Wien;1030;AT; ;- PENDING[CONTACT-48116] Handle anlegen bei einer.ch oder.li Domain: SGAP2 V1.00 Server ready at: :06: (Build: Dec :47:28) switch CONTACT Max;Pichler;-;Salesianergasse 3/11A;Wien;Wien;1030;AT; ;- PENDING[CONTACT-367] INFO Mit diesem Befehl werden die Daten zu einem Handle-Object abgefragt. INFO handleid; Bemerkungen zu den einzelnen Feldern: <handleid> Dies ist das Handle, das der Befehl CONTACT zurückgeliefert hat, z.b. H GLOBE Pflichtfeld.

6 Abfrage eines gültigen Handles: SGAP2 V1.00 Server ready at: :53: (Build: Dec :47:28) info INFO H GLOBE\r\n OK[ID:H Salesianergasse 3/11A;Town:Wien;ZIP:1030;State:Wien;Country:AT;Telephone: ;Fax:;] Falsches Handle angeben: SGAP2 V1.00 Server ready at: :51: (Build: Dec :47:28) info INFO blabla\r\n ERR[2303 Object does not exist] CHANGE Der Befehl dient der Änderung der Daten eines Person-Handles. CHANGE handleid;firstname;lastname;organization;street;city;state;pc;country;voice;fax; Bemerkungen zu den einzelnen Feldern: Allgemeines: Für alle Argumente gilt: ist eine Änderung der Daten vorzunehmen, so bitte den neuen Wert eintragen (neue Adresse, Telefonnummer etc.). Falls das entsprechende Feld gleich bleibt, bitte Bindestrich ('-') angeben. <handleid> Die Handle-Kennzeichnung, Pflichtfeld. <firstname> Neuer Name der Person <lastname> Neuer Nachname der Person <organization> Neuer Firmenname <street> Neue Anschrift der Contact-Person.

7 <city> Stadt, in der die Person wohhaft ist. <state> neues Bundesland <pc> neue ZIP (postalcode) <country> neues Land, im ISO-Code (siehe <voice> Format beim CONTACT Befehl). <voice> Neue Telefonnummer der Contact-Person. <fax> Neue Faxnummer der Contact-Person. < > Neue adresse der Contact-Person. Im folgenden Beispiel wird eine Änderung der Kontakt-Adresse vorgenommen: SGAP2 V1.00 Server ready at: :40: (Build: Dec :47:28) info CHANGE H GLOBE;-;-;-;Gymnasiumstrasse 17/4B;-;-;1190;-;-;-;-;\r\n OK[Command completed successfully!] 3.2 Domain-Transaktionen CHECK Der Befehl dient zur Abfrage des Status eines Domainnames, d.h. ob der Domainname frei oder bereits vergeben ist. CHECK domainname; Domain ist bereits vergeben: SGAP2 V1.00 Server ready at: :53: (Build: Dec :47:28) com CHECK ibm.com\r\n OK[+]

8 Domain ist noch frei: SGAP2 V1.00 Server ready at: :56: (Build: Dec :47:28) com CHECK asdfesssssergasfd.com\r\n OK[-] CREATE Mit diesem Befehl wird eine neue Domain registiert. CREATE domainname;dnses;period;registrant;tech;billing;admin Bemerkungen zu den einzelnen Feldern: <domainname> Der gewünschte, zu registrierende Domainname, Pflichtfeld. <dnses> Mindestens zwei Nameserver, die für diese Domain zuständig sind, getrennt durch Komma (',') z.b. dns1.myname.com,dns2.myname.com <period> Registrierungsdauer <registrant> Handle des Domaininhabers <tech> Handle des Tech-Contacts <billing> Handle des Rechnungsempfängers <admin> Handle des Domain-Admins Erfolgreiche Neuregistrierung: SGAP2 V1.00 Server ready at: :12: (Build: Dec :47:28) info CREATE levski.info;dns1.globedom.com,dns2.globedom.com;2;h GLOBE;H GLOBE;H GLOBE;H GLOBE;\r\n OK[Command completed successfully!]

9 Falsche Angaben: SGAP2 V1.00 Server ready at: :20: (Build: Dec :47:28) info CREATE levski.info;dns1.globedom.com,dns2.globedom.com;2;h146de;h GLOBE;H GLOBE;H GLOBE;\r\n ERR[2303 Object does not exist] Domain wurde bereits registriert: SGAP2 V1.00 Server ready at: :12: (Build: Dec :47:28) info CREATE levski.info;dns1.globedom.com,dns2.globedom.com;2;h GLOBE;H GLOBE;H GLOBE;H GLOBE;\r\n ERR[2302 Object exists] DINFO Dient zur Abfrage der Daten zu einem bestimmten Domainnamen. DINFO domainname SGAP2 V1.00 Server ready at: :21: (Build: Dec :47:28) info DINFO levski-forever.info\r\n OK[ID:D LRMS;Name:levski-forever.info;Status:'ok' ;Registrant:C LRMS;Admin:C LRMS;Tech:C LRMS;Billing:C LRMS;DNS0:dns1.globedom.com;DNS1:dns2.globedom.com;Created: T08:07:23.0Z;Expiry: T08:07:23.0Z;] CDOMAIN Dieser Befehl dient der Änderung der Daten zu einem Domainnamen. CDOMAIN domainname;dnses;period;registrant;tech;billing;admin; Bemerkungen zu den einzelnen Feldern: <domainname> <dnses>

10 <period> <registrant> <tech> <billing> <admin> Die Felder haben die selbe Bedeutung wie beim CREATE Befehl Im folgenden Beispiel werden die Nameserver der Domain bobi.info geändert. Die restlichen Daten (Domaininhaber, Tech etc.) bleiben gleich. SGAP2 V1.00 Server ready at: :32: (Build: Dec :47:28) info DINFO bobi.info\r\n OK[ID:D LRMS;Name:bobi.info;Status:'ok' ;Registrant:C LRMS;Admin:C LRMS;Tech:C LRMS;Billing:C LRMS;DNS0:ns.internic.at;DNS1:ns2.internic.at;DNS2:dns1.globedom.com;DNS3:dns2.globedo m.com;created: t15:58:28.0z;expiry: t15:58:28.0z;] Die Nameserver dns1.globedom.com und dns2.globedom.com werden durch die neuen ns.internic.at und ns2.internic.at ersetzt: SGAP2 V1.00 Server ready at: :22: (Build: Dec :47:28) info CDOMAIN bobi.info;ns.internic.at,ns2.internic.at;-;-;-;-;-;\r\n OK[Command completed successfully!] Im folgenden Beispiel werden der Tech und der Admin geändert, die restlichen Daten (Nameserver, Domaininhaber und Rechnungsempfänger bleiben gleich): SGAP2 V1.00 Server ready at: :35: (Build: Dec :47:28) info CDOMAIN bobi.info;-;-;-;h globe;-;h globe;\r\n OK[Command completed successfully] DELDOM Löschen einer Domain. DELDOM domainname

11 SGAP2 V1.00 Server ready at: :12: (Build: Dec :47:28) info DELDOM levski.info;\r\n OK[Command completed successfully!] 3.3 Nameserver-Transaktionen CHECKNS CHECKNS hostname; Nameserver bereits registriert: SGAP2 V1.00 Server ready at: :55: (Build: Dec :47:28) com CHECKNS dns1.globedom.com;\r\n OK[+] Nameserver noch nicht registriert: SGAP2 V1.00 Server ready at: :57: (Build: Dec :47:28) com CHECKNS dns99.globedom.com;\r\n OK[-] NEWDNS NEWDNS hostname; SGAP2 V1.00 Server ready at: :01: (Build: Dec :47:28) com NEWDNS dns1.globedom.com;\r\n OK[+]

12 4. Programmierbeispiele 4.1 SGAP mit PERL #!/usr/bin/perl use Socket; $dest = sockaddr_in (20000, inet_aton(' socket(sgap, AF_INET, SOCK_STREAM, getprotobyname('tcp')) or die "Failed to create socket\n"; connect(sgap,$dest ) or die "Failed to connect\n"; select(sgap); $ = 1; select(stdout); $line = <SGAP>; print $line; $login = ""; $command = "biz DINFO sveto.biz\r\n"; print SGAP "$login"; print SGAP "$command"; $line = <SGAP>; $result = substr($line,0,2); if ($result eq "OK") { print "Command completed successfuly!\n\n"; $msg = substr($line,3,index($line,"]")-2); print "$msg\n"; $info = = split(/;/,$info); for(@domaininfo){ if(length($_) > 3){ print "$_\n"; else{ print "Error: $line\n";

13 4.2 SGAP mit C #include <stdio.h> #include <string.h> #include <netdb.h> #include <sys/socket.h> #include <unistd.h> #include <errno.h> int main(void){ int sock; struct sockaddr_in remote; FILE *in,*out; char line[1024]; char command[1024] = "info DINFO bobi.info\r\n"; char login[] = ""; struct hostent *hp; if ( ( sock = socket(af_inet,sock_stream,0 ) ) < 0 ) { printf("socket() failed: %s\n",strerror(errno)); exit(0); hp = gethostbyname(" if ( hp == NULL ) { perror("gethostbyname() failed "); close(sock); exit(0); remote.sin_family = AF_INET; remote.sin_port = htons(20000); remote.sin_addr = *((struct in_addr *)*(hp->h_addr_list)); if ( connect(sock,(struct sockaddr*)&remote, sizeof(remote) ) < 0){ printf("connect() failed: %s\n",strerror(errno)); exit(0); in = fdopen(sock,"r"); if ( in == NULL ) { perror("fdopen() failed "); close(sock); exit(0); out =fdopen(sock,"w"); if ( out == NULL ) { perror("fdopen() failed ");

14 close(sock); fclose(in); exit(0); fgets(line,1024,in); fprintf(out,"%s",login); fprintf(out,"%s",command); fflush(out); while ( fgets(line,1024,in)!= NULL ) { printf("%s\n",line); close(sock); fclose(in); fclose(out); return(0);