Rozszerzenie NASK EPP

2.2

Rozszerzenie NASK EPP Rozszerzenie NASK EPP ..................................................................... 1 Wstęp ........................................................................................... 1 Statusy ......................................................................................... 1 Operacje na domenach ................................................................... 1 Operacje na kontaktach .................................................................. 4 Opcje ........................................................................................... 8 Raporty ...................................................................................... 14 Historia zmian ................................................................................ 23

Wstęp Celem niniejszego dokumentu jest skrócony opis rozszerzeń wprowadzonych do protokołu EPP (Extensible Provisioning Protocol) przez NASK. Obowiązująca wersja EPP jest w pełni opisana w dokumentach IETF:  Extensible Provisioning Protocol (draft-ietf-provreg-epp-07.txt)  Extensible Provisioning Protocol Contact Mapping (draft-ietf-provregepp-contact-05.txt)  Extensible Provisioning Protocol Domain Name Mapping (draft-ietfprovreg-epp-domain-05.txt)  Extensible Provisioning Protocol Host Mapping (draft-ietf-provreg-epphost-05.txt)

Statusy  

clientRenewProhibited – ustawiony zapobiega automatycznemu odnowieniu domeny po upływie okresu utrzymywania domeny clientTransferProhibited – użycie niedozwolone dla domen

Operacje na domenach 1. a. opcjonalny element zawierający uzasadnienie prawa Registranta do nazwy domeny, b. opcjonalny element , którego podanie oznacza żądanie zarezerwowania domeny, c. opcjonalny element , którego podanie oznacza żądanie stworzenia testów domeny (usługa Domain Name Tasting). Przykład komendy z elementem : example.pl 1 ns1.example.pl ns1.example2.pl nsk1234 nsk5678 2fooBAR nice name ABC-12345

Przykład komendy z elementem : example.pl ns1.example.pl ns1.example2.pl nsk1234 nsk5678 2fooBAR nice name ABC-12345

2.

© NASK 2011

Strona 2

Rozszerzenie NASK EPP

2.2

a. opcjonalny element , którego podanie w zleceniu transferu powoduje powtórne wysłanie prośby o potwierdzenie transferu przez registranta. Przykład komendy : example.pl 1 2fooBAR ABC-12345

3. a. opcjonalny element , którego podanie oznacza, iż domena będąca w stanie BLOCKED może być odnowiona. Przykład komendy : example.pl 2009-10-26 1

© NASK 2011

Strona 3

Rozszerzenie NASK EPP

2.2

ABC-12345

b. opcjonalny element , którego podanie umożliwy przesunięcie daty wygaśniecia domeny. Przykład komendy z ustawionym elementem : example.pl 2012-09-15 2012-09-25 ABC-12345

Operacje na kontaktach 1. a. element zawierający informację, czy kontakt reprezentuje osobę fizyczną, b. element zawierający zgodę albo zakaz kontaktu na publikację danych osobowych w przypadku osoby fizycznej. Przykład komendy : sh8013

© NASK 2011

Strona 4

Rozszerzenie NASK EPP

2.2

John Doe ACME 123 Example Dr. Suite 100 Dulles VA 20166-6503 US +1.7035555555 +1.7035555556 [email protected] secret 1 1 ABC-12345

2. a. opcjonalny element zawierający zgodę albo zakaz kontaktu na publikację danych osobowych w przypadku osoby fizycznej. Przykład komendy : nsk0001 124 Example Dr. Suite 200 Dulles VA 20166-6503

© NASK 2011

Strona 5

Rozszerzenie NASK EPP

2.2

US +1.7034444444 1 ABC-12345

3. a. opcjonalny atrybut roid w elemencie , który zawiera identyfikator w systemie (Repository Object IDentifier) domeny, dla której kontakt o identyfikatorze jest registrantem, jeśli jej informacje autoryzujące zostały podane w elemencie . Przykład komendy : 666666 2fooBAR ABC-12345

4. (odpowiedź na komendę ) a. element zawierający informację, czy reprezentuje osobę fizyczną,

© NASK 2011

kontakt

Strona 6

Rozszerzenie NASK EPP

2.2

b. element zawierający zgodę albo zakaz kontaktu na publikację danych osobowych w przypadku osoby fizycznej. Przykład odpowiedzi na : Command completed successfully nsk002 27200-NASK John Doe Organizacja Street 23/22 City 01-012 PL +48.1234567890 +48.1234567890 [email protected] nask nask 2006-11-01T17:59:48.0Z 0118595200 true false ABC-12345 JA7422406634

© NASK 2011

Strona 7

Rozszerzenie NASK EPP

2.2

5. a. opcjonalny atrybut roid w elemencie , który zawiera identyfikator w systemie (Repository Object IDentifier) domeny, dla której kontakt o identyfikatorze jest registrantem, jeśli jej informacje autoryzujące zostały podane w elemencie , b. opcjonalny element , którego podanie w zleceniu transferu powoduje powtórne wysłanie prośby o potwierdzenie transferu przez ten kontakt. Przykład komendy : sh8013 2fooBAR ABC-12345

Opcje Opcja na rejestrację nazwy domeny zapewnia możliwość rejestracji tej nazwy domeny, gdy będzie ona wolna do rejestracji (np. zakończy się jej okres utrzymywania bez uprzedniego przedłużenia lub zostanie usunięta). W takiej sytuacji domena zostanie automatycznie zarezerwowana dla uprawnionego registrara oraz registranta opcji. Do obsługi opcji dostarczono podzbiór komend wymienionych w Extensible Provisioning Protocol (draft-ietf-provreg-epp-07.txt), który opisano poniżej. 1. a. jeden lub więcej elementów zawierających nazwę opcji. Przykład komendy : przyklad.pl przyklad1.pl przyklad2.pl ABC-12345

2. (odpowiedź na komendę ) Dla każdego podanego w komendzie elementu odpowiedź zawiera odpowiadający mu element zawierający: a. element zawierający nawę domeny oraz atrybut avail, który określa, czy utworzenie opcji dla danej nazwy domeny w momencie wykonania komendy było możliwe dla zalogowanego registrara (wartość 1 lub true oznacza, że utworzenie jest możliwe, wartość 0 lub false oznacza, że utworzenie jest niemożliwe), b. opcjonalny element , występujący, gdy atrybut avail elementu ma wartość 0 lub false, który zawiera numer dodatkowego kodu diagnostycznego opisującego powód, z którego zalogowany registrar nie może utworzyć opcji dla podanej nazwy domeny. Przykład odpowiedzi na : Command completed successfully przyklad.pl 4002 przyklad1.pl przyklad2.pl 4012

© NASK 2011

Strona 9

Rozszerzenie NASK EPP

2.2

ABC-12345 JA5241324046

3. a. element zawierający nazwę domeny, dla której ma zostać utworzona opcja, b. element zawierający okres, na jaki ma zostać utworzony future, który zawiera atrybut unit o wartości y lub m, określający w jakich jednostkach (odpowiednio: rok lub miesiąc) została podana wartość elementu , c. element zawierający identyfikator kontaktu registranta opcji, d. element zawierający informacje autoryzujące opcji. Przykład komendy : przyklad.pl 3 nsk001 3fooBAR ABC-12345

4. (odpowiedź na komendę ) a. element zawierający nazwę domeny, dla której utworzono opcję, b. element zawierający datę utworzenia opcji, c. element zawierający datę końca okresu utrzymywania opcji. Przykład odpowiedzi na :

© NASK 2011

Strona 10

Rozszerzenie NASK EPP

2.2

Command completed successfully przyklad.pl 2007-11-02T09:01:24.0Z ABC-12345 JA1012361471

5. a. element zawierający nazwę opcji, b. opcjonalny element zawierający informacje autoryzujące opcji lub kontaktu i. opcjonalny atrybut roid, który zawiera identyfikator w systemie (Repository Object IDentifier) kontaktu powiązanego z opcją o nazwie jako registrant, jeśli jego informacje autoryzujące zostały podane w elemencie . Przykład komendy : przyklad.pl 3fooBAR ABC-12345

6. (odpowiedź na komendę ) a. element zawierający nazwę opcji, b. element zawierający identyfikator opcji w systemie (Repository Object IDentifier), c. element zawierający identyfikator kontaktu registranta opcji, d. element zawierający identyfikator uprawnionego registrara opcji, © NASK 2011

Strona 11

Rozszerzenie NASK EPP

2.2

e. element zawierający identyfikator registrara, który utworzył opcję, f. element zawierający datę i czas utworzenia opcji w systemie, g. element zawierający datę i czas końca okresu utrzymywania opcji, h. opcjonalny element zawierający identyfikator registrara, który dokonał ostatniej modyfikacji opcji, i. opcjonalny element zawierający datę i czas ostatniej modyfikacji opcji, j. opcjonalny element zawierający datę i czas ostatniego transferu opcji, k. element zawierający informacje autoryzujące opcji, l. element zawierający okres utrzymywania opcji. Przykład odpowiedzi na : Command completed successfully przyklad.pl 311-NASK 000000003 nask nask 2007-11-02T09:01:24.0Z 2010-11-02T09:01:24.0Z 3fooBAR ABC-12345 JA7576662347

7. a. element zawierający nazwę opcji, b. element zawierający następujące elementy: i. opcjonalny element zawierający identyfikator registranta opcji, © NASK 2011

Strona 12

Rozszerzenie NASK EPP ii. opcjonalny element informacje autoryzujące opcji. Przykład komendy :

2.2 zawierający

przyklad.pl nsk001 4fooBAR ABC-12345

8. a. atrybut op o jednej z wartości request, query, approve, reject, cancel, b. element zawierający nazwę opcji, c. opcjonalny element , który nie jest obsługiwany, d. element zawierający informacje autoryzujące opcji lub kontaktu i. opcjonalny atrybut roid, który zawiera identyfikator w systemie (Repository Object IDentifier) kontaktu powiązanego z opcją o nazwie jako registrant, jeśli jego informacje autoryzujące zostały podane w elemencie , e. opcjonalny element (bez wartości). Przykład komendy : przyklad.pl 3fooBAR

© NASK 2011

Strona 13

Rozszerzenie NASK EPP

2.2

ABC-12345

9. (odpowiedź na komendę ) a. element zawierający nazwę opcji, b. element zawierający stan wykonania transferu opcji o jednej z wartości: clientApproved, clientCancelled, pending, serverApproved, serverCancelled, c. element zawierający identyfikator registrara zlecającego transfer opcji, d. element zawierający datę zlecenia transferu, e. element zawierający identyfikator kontaktu registranta opcji, który zatwierdza zlecenie transferu, f. element zawierający datę wygaśnięcia zlecenia transferu opcji, jeśli stan zlecenia transferu to pending albo datę zakończenia przetwarzania zlecenia transferu opcji dla pozostałych stanów zlecenia transferu. Przykład odpowiedzi na : Command completed successfully; action pending przyklad.pl pending nask 2007-11-02T09:31:11.0Z nsk0001 2007-12-02T09:31:11.0Z ABC-12345 JA7504315162

Raporty Komenda raportów zwraca listę obiektów znajdujących się w systemie, należących do danego użytkownika i spełniających zadane warunki. 1. © NASK 2011

Strona 14

Rozszerzenie NASK EPP

2.2

a. jeden z następujących elementów, który określa typ raportu: i. – lista domen, które są w określonym stanie i które wygasną w zadanym terminie, ii. – lista kontaktów należących do zalogowanego registrara lub jeden określony identyfikatorem, iii. – lista hostów należących do zalogowanego registrara lub jeden określony nazwą, iv. – lista opcji, które wygasną w zadanym terminie, v. – lista paymentów dla konta podanego typu, vi. – sumy środków (początkowych, wydanych, bieżących) dla konta podanego typu, b. opcjonalny element określający przesunięcie w zwracanych danych (domyślnie 0), c. opcjonalny element określający ilość zwracanych danych. 2. (odpowiedź na komendę ) a. jeden z następujących elementów, który zawiera listę zwróconych obiektów w zależności od typu raportu, odpowiednio: i. , ii. , iii. , iv. , v. , vi. , b. element zawierający przesunięcie zwracanych obiektów względem wszystkich obiektów spełniających warunki raportu, c. element zawierający maksymalną możliwą liczbę zwróconych obiektów w jednym raporcie, d. element zawierający liczbę obiektów w systemie spełniająca warunki raportu. 3. a. opcjonalny element zawierający jedną z wartości: STATE_REGISTERED, STATE_EXPIRED, STATE_BLOCKED, STATE_RESERVED, STATE_BOOK_BLOCKED, STATE_DELETE_BLOCKED, STATE_TASTED, STATE_TASTED_BLOCKED, określający stan domen (domyślnie STATE_REGISTERED), b. opcjonalny element zawierający datę wygaśnięcia domen; jeśli nie zostanie podany, zwracane są wszystkie domeny zalogowanego registrara, c. opcjonalny element zawierający elementy i. jeden lub więcej elementów zawierających nazwy statusów domeny, © NASK 2011

Strona 15

Rozszerzenie NASK EPP

2.2

ii.

opcjonalny parameter statusesIn decydujący czy wyszukiwane domeny mają zawierać podane statusy (domyślnie true) Przykład komendy : STATE_REGISTERED 2007-05-07T11:23:00.0Z serverHold 0 50

4. a. zero lub więcej elementów i. element zawierający nazwę domeny, ii. element zawierający identyfikator domeny w systemie (Repository Object IDentifier), iii. element zawierający datę wygaśnięcia domeny, iv. element zawierający elementy 1. zero lub więcej elementów zawierających nazwy statusów domeny. Przykład odpowiedzi na : Command completed successfully example1.pl 1234-NASK

© NASK 2011

Strona 16

Rozszerzenie NASK EPP

2.2

2007-0318T23:00:00.0Z serverHold example2.pl 1235-NASK 2007-0419T15:25:31.0Z serverHold 0 50 2 RE2344577834

5. a. opcjonalny element zawierający identyfikator kontaktu; jeśli nie zostanie podany, zwracane są wszystkie kontakty zalogowanego registrara. Przykład komendy : k13 0 50

6. a. zero lub więcej elementów i. element zawierający identyfikator kontaktu, ii. element zawierający identyfikator kontaktu w systemie (Repository Object IDentifier). Przykład odpowiedzi na : Command completed successfully k13 654321-NASK 0 50 1 RE3248667845

7. a. opcjonalny element zawierający nazwę hosta; jeśli nie zostanie podany, zwracane są wszystkie hosty zalogowanego registrara. Przykład komendy : ns1.temp.pl 0 50

8. a. zero lub więcej elementów i. element zawierający nazwę hosta, ii. element zawierający identyfikator hosta w systemie (Repository Object IDentifier). Przykład odpowiedzi na : © NASK 2011

Strona 18

Rozszerzenie NASK EPP

2.2

Command completed successfully ns1.temp.pl 632381-NASK 0 50 1 RE4578967890

9. a. opcjonalny element zawierający datę wygaśnięcia opcji; jeśli nie zostanie podany, zwracane są wszystkie opcje zalogowanego registrara. Przykład komendy : 2007-04-23T15:22:34.0Z 0 50

10.

a. zero lub więcej elementów i. element zawierający nazwę opcji,

© NASK 2011

Strona 19

Rozszerzenie NASK EPP

2.2

ii.

element zawierający identyfikator opcji w systemie (Repository Object IDentifier), iii. element zawierający datę wygaśnięcia opcji. Przykład odpowiedzi na : Command completed successfully ns1.temp.pl 632381-NASK 2007-0419T15:25:31.0Z 0 50 1 RE2321966675

11.

a. wymagany element zawierający typ konta, dla którego wyświetlane są paymenty. Przykład komendy : domain 0 50

© NASK 2011

Strona 20

Rozszerzenie NASK EPP

2.2



12.

a. zero lub więcej elementów i. element zawierający identyfikator paymentu w systemie (Repository Object IDentifier), ii. element zawierający datę utworzenia, iii. element zawierający wartość brutto, iv. element zawierający procent VAT, v. element zawierający wartość VAT, vi. element zawierający środki początkowe, vii. element zawierający środki bieżące. Przykład odpowiedzi na : Komenda wykonana poprawnie 14-NASK 2009-0617T08:08:40.0Z 1220.0 22 220.0 1000.0 1000.0 0 50 1 RE7632747544

13.

a. wymagany element zawierający typ konta, dla którego wyświetlane są sumy środków (początkowych, wydanych i bieżących). Przykład komendy : domain 0 50

14.

a. element i. element zawierający sumę środków bieżących. Przykład odpowiedzi na : Komenda wykonana poprawnie 803.86 0 50 1 RE7632747544

© NASK 2011

Strona 22

Rozszerzenie NASK EPP

15.

2.2

Historia zmian

Wersja Obowiązuje Wersja Obowiązuje dokumentu od Registry od 2.0 16-114.5.10 16-112011 2011 2.1 09-084.5.11 18-042012 2012 2.2 09-084.5.12 08-082012 2012

© NASK 2011

Lista zmian Dodany opis rozszerzenia Poprawiony przykład dla Aktualizacja przykładu odpowiedzi dla komendy

Strona 23