Відмінності між версіями «EPP»

Матеріал з DRS wiki
Перейти до: навігація, пошук
Рядок 1: Рядок 1:
<br/>
+
[[Файл:Epp.png|center]]
  
'''EPP''' (Extensible Provisioning Protocol, RFC-5730) — это протокол взаимодействия Регистра доменной зоны и Регистраторов доменов.
 
EPP-сервер DRS позволяет осуществлять регистрацию, изменение, продление и трансфер доменов (RFC-5731), а также регистрацию и изменение контактов CUNIC (RFC-5733).
 
  
 +
{| align="left" class="wikitable" width="35%" style="float:right; margin-left:2em"
 +
|-
 +
! style="background:#AFD6FF;" | Документація
 +
! style="background:#AFD6FF;" | Посилання
 +
|-
 +
|'''Extensible Provisioning Protocol (EPP)'''
 +
|[https://tools.ietf.org/html/rfc5730 RFC-5730]
 +
|-
 +
|'''EPP Domain Name Mapping'''
 +
|[https://tools.ietf.org/html/rfc5731 RFC-5731]
 +
|-
 +
|'''EPP Contact Mapping'''
 +
|[https://tools.ietf.org/html/rfc5733 RFC-5733]
 +
|-
 +
|'''EPP Transport over TCP'''
 +
|[https://tools.ietf.org/html/rfc5734 RFC-5734]
 +
|}
  
=== Меню 3 ===
+
'''EPP''' (Extensible Provisioning Protocol, RFC-5730) – це протокол взаємодії Реєстру доменної зони та Реєстраторів доменів. EPP-сервер DRS дозволяє здійснювати реєстрацію, зміну, продовження та трансфер доменів ([https://tools.ietf.org/html/rfc5731 RFC-5731]), а також реєстрацію та зміну контактів CUNIC ([https://tools.ietf.org/html/rfc5733 RFC-5733]).
[[EPP|ссылка на эту страницу]]
+
  
Лимит на кол-во одновременных сессий = 3
+
Обмін даними між клієнтськими та серверними програмами описаний у документі [https://tools.ietf.org/html/rfc5734 RFC-5734] і подається у вигляді пакетів даних. Кожен пакет даних складається з 4 байт, що містять довжину всього пакета (довжина тіла пакета + 4) та даних команди.
  
Разрешенных IP до 5 шт
+
=== Початок та кінець сесії ===
 +
Сесія ініціалізується командою <login>, ця команда завжди виконується при підключенні до сервера перед виконанням будь-яких операцій із доменами та контактами.
  
Доступ к EPP интерфейсу DRS для аккредитованных регистраторов*:
+
Для завершення сесії перед відключенням від сервера необхідно виконати команду <logout>, яка повинна виконуватися завжди перед відключенням від сервера, щоб уникнути перевищення ліміту одночасно відкритих сесій.
  
HOST: epp.uadns.com
+
=== Контакти доменів ===
PORT: 700
+
У доменного імені, як правило, має бути 4 типи контактів: контакт власника домену (registrant), адміністративний (admin), технічний контакт (tech), фінансовий контакт (billing). Це стосується всіх міжнародних доменів та доменів biz.ua, co.ua, pp.ua. Всі інші домени використовують лише два типи контактів – admin та tech.
LOGIN: *ВАШ*-mnt-cunic
+
PASSWORD: https://drs.ua/rus/my/epp/preferences.html
+
  
* Пожалуйста, для доступа к системе по протоколу EPP отправьте нам список ваших IP-адресов, с которых вы будете выполнять соединение.
+
Кожен тип контакту несе у собі функціональне навантаження — особа, зазначене у тому чи іншому типі контактів виконує суворо певні функції. Регістрант - це власник, адміністратор займається питаннями управління доменом, дає різні підтвердження при виконанні операцій над доменами. Відповідно фінансовий та технічний контакти виконують фінансові та технічні функції.
  
=== Объекты ===
+
=== Основні типи команд ===
 +
Над кожним об'єктом можна виконувати п'ять команд:
  
==== Домены ====
+
CREATE - реєстрація нового об'єкта
 +
UPDATE – зміна властивостей об'єкта
 +
RENEW - збільшення часу життя об'єкта
 +
TRANSFER - Зміна обслуговуючого реєстратора об'єкта
 +
DELETE – видалення об'єкта
 +
Результат виконання команди
 +
Кожна з відправлених на сервер команд може вимагати для виконання різну кількість часу, але за стандартом сервер зобов'язаний відповісти клієнту в строго певний проміжок часу, інакше команда не буде вважатися прийнятою. Тому результат виконання може бути "миттєвий" або "відкладений"
  
==== Контакты ====
+
=== Черга повідомлень ===
 +
Результат обробки відкладених команд рано чи пізно стане відомим, тому для оповіщення реєстратора використовується особиста черга повідомлень реєстратора. Також EPP сервер DRS надсилає кожному з реєстраторів різні повідомлення, наприклад, про термін дії домену.
  
=== Команды ===
+
Для отримання повідомлень та результатів відкладених команд використовуйте команду <poll> і не забувайте відзначати повідомлення як прочитані.
  
==== Домены ====
+
=== Повідомлення drs:notify ===
===== check =====
+
Це повідомлення використовується для сповіщення реєстратора про події. Тип події вказується в елементі drs:type
===== info =====
+
  
==== Контакты ====
+
domainActivated — домен pp.ua активований кодом з sms
===== check =====
+
domainHeld — домен не був продовжений та заблокований згідно з терміном дії
===== info =====
+
domainPendingToDelete — домен перейшов у стадію видалення (для доменів, які використовують термінацію за схемою випадкового видалення протягом 5 діб)
 +
domainDeleted — домен видалений з бази даних DRS для проксованих доменів
 +
domainCancelled — домен biz.ua, co.ua, pp.ua видалено
  
... <ref> тут сноска </ref>:
+
Наприклад:
 +
<syntaxhighlight lang="xml" enclose="pre">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<drs:notify xmlns:drs="http://drs.ua/epp/drs-1.0" xsi:schemaLocation="drs-1.0.xsd">
 +
<drs:type>domainPendingToDelete</drs:type>
 +
<drs:object>test.pp.ua</drs:object>
 +
<drs:message>Domain test.pp.ua has been pending to delete</drs:message>
 +
</drs:notify>
 +
</syntaxhighlight>
  
== Примечания ==
+
=== Приклади XML ===
 +
Ми не будемо зайвий раз дублювати інформацію, першоджерело завжди краще за будь-який підручник, тому приклади XML коду і докладний опис ми рекомендуємо брати безпосередньо з документів RFC-5730, RFC-5731, RFC-5732, RFC-5733
  
<font color=red>Обратите внимание!</font> ...
+
=== Вирішення проблем ===
 
+
Якщо Ви вивчили документи RFC напам'ять, все зробили правильно, але з якоїсь причини відчуваєте труднощі - будь ласка, повідомте якомога більше даних нам за адресою support@drs.ua і ми обов'язково постараємося допомогти Вам визначити проблему та позбутися її.
<references/>
+

Версія за 17:47, 19 жовтня 2022

Epp.png


Документація Посилання
Extensible Provisioning Protocol (EPP) RFC-5730
EPP Domain Name Mapping RFC-5731
EPP Contact Mapping RFC-5733
EPP Transport over TCP RFC-5734

EPP (Extensible Provisioning Protocol, RFC-5730) – це протокол взаємодії Реєстру доменної зони та Реєстраторів доменів. EPP-сервер DRS дозволяє здійснювати реєстрацію, зміну, продовження та трансфер доменів (RFC-5731), а також реєстрацію та зміну контактів CUNIC (RFC-5733).

Обмін даними між клієнтськими та серверними програмами описаний у документі RFC-5734 і подається у вигляді пакетів даних. Кожен пакет даних складається з 4 байт, що містять довжину всього пакета (довжина тіла пакета + 4) та даних команди.

Початок та кінець сесії

Сесія ініціалізується командою <login>, ця команда завжди виконується при підключенні до сервера перед виконанням будь-яких операцій із доменами та контактами.

Для завершення сесії перед відключенням від сервера необхідно виконати команду <logout>, яка повинна виконуватися завжди перед відключенням від сервера, щоб уникнути перевищення ліміту одночасно відкритих сесій.

Контакти доменів

У доменного імені, як правило, має бути 4 типи контактів: контакт власника домену (registrant), адміністративний (admin), технічний контакт (tech), фінансовий контакт (billing). Це стосується всіх міжнародних доменів та доменів biz.ua, co.ua, pp.ua. Всі інші домени використовують лише два типи контактів – admin та tech.

Кожен тип контакту несе у собі функціональне навантаження — особа, зазначене у тому чи іншому типі контактів виконує суворо певні функції. Регістрант - це власник, адміністратор займається питаннями управління доменом, дає різні підтвердження при виконанні операцій над доменами. Відповідно фінансовий та технічний контакти виконують фінансові та технічні функції.

Основні типи команд

Над кожним об'єктом можна виконувати п'ять команд:

CREATE - реєстрація нового об'єкта UPDATE – зміна властивостей об'єкта RENEW - збільшення часу життя об'єкта TRANSFER - Зміна обслуговуючого реєстратора об'єкта DELETE – видалення об'єкта Результат виконання команди Кожна з відправлених на сервер команд може вимагати для виконання різну кількість часу, але за стандартом сервер зобов'язаний відповісти клієнту в строго певний проміжок часу, інакше команда не буде вважатися прийнятою. Тому результат виконання може бути "миттєвий" або "відкладений"

Черга повідомлень

Результат обробки відкладених команд рано чи пізно стане відомим, тому для оповіщення реєстратора використовується особиста черга повідомлень реєстратора. Також EPP сервер DRS надсилає кожному з реєстраторів різні повідомлення, наприклад, про термін дії домену.

Для отримання повідомлень та результатів відкладених команд використовуйте команду <poll> і не забувайте відзначати повідомлення як прочитані.

Повідомлення drs:notify

Це повідомлення використовується для сповіщення реєстратора про події. Тип події вказується в елементі drs:type

domainActivated — домен pp.ua активований кодом з sms domainHeld — домен не був продовжений та заблокований згідно з терміном дії domainPendingToDelete — домен перейшов у стадію видалення (для доменів, які використовують термінацію за схемою випадкового видалення протягом 5 діб) domainDeleted — домен видалений з бази даних DRS для проксованих доменів domainCancelled — домен biz.ua, co.ua, pp.ua видалено

Наприклад:

<?xml version="1.0" encoding="UTF-8"?>
<drs:notify xmlns:drs="http://drs.ua/epp/drs-1.0" xsi:schemaLocation="drs-1.0.xsd">
	<drs:type>domainPendingToDelete</drs:type>
	<drs:object>test.pp.ua</drs:object>
	<drs:message>Domain test.pp.ua has been pending to delete</drs:message>
</drs:notify>

Приклади XML

Ми не будемо зайвий раз дублювати інформацію, першоджерело завжди краще за будь-який підручник, тому приклади XML коду і докладний опис ми рекомендуємо брати безпосередньо з документів RFC-5730, RFC-5731, RFC-5732, RFC-5733

Вирішення проблем

Якщо Ви вивчили документи RFC напам'ять, все зробили правильно, але з якоїсь причини відчуваєте труднощі - будь ласка, повідомте якомога більше даних нам за адресою support@drs.ua і ми обов'язково постараємося допомогти Вам визначити проблему та позбутися її.