SMTP

Матеріал з DRS wiki
Перейти до: навігація, пошук
Smtp.png


Опис Характеристика
EMAIL auto-dbm@drs.ua
Формат text/plain

SMTP (Simple Mail Transfer Protocol) – це протокол взаємодії реєстру доменної зони та реєстраторів доменів по email. SMTP DRS дозволяє здійснювати реєстрацію, зміну, продовження, трансфер та відновлення доменів.

Вимоги

Команди приймаються електронною поштою за умови:

  • Відправки реєстратором запиту лише на адресу auto-dbm@drs.ua
  • Тільки з авторизованих email адрес акредитованих реєстраторів.
  • Ідентифікатор реєстратора, який надіслав заявку, має бути обов'язково зазначений у тексті електронного листа-заявки в полі "mnt-by".
  • Лист має бути в text/plain (utf-8, koi8-r, koi8-u, windows-1251 якщо містить кириличні символи). Усі формати MIME відкидаються.
  • Неприпустимі вкладення, HTMLформатування та Base-64 або Quoted-Printable перекодування.
  • Заборонено використання в листі-заявці різних підписів, оскільки автоматична система може

прийняти весь підпис або її частину за фрагмент заявки із синтаксичною помилкою.

  • В одному листі має бути не більше однієї заявки.

Команди, які не відповідають вищезазначеним вимогам, можуть бути не розпізнані системою як заявки та бути проігноровані.

Опис

Заявка складається з набору рядків, які у свою чергу складаються з імен полів та їх значень, розділених символом ':' та пробілом. Значення полів має відповідати вимогам відповідного доменного імені.

Поля можуть бути таких типів:

domain: Повне ім'я домену. Не повинно починатися та закінчуватися на символ '-'. Обов'язкове поле.

license: Номер свідоцтва ТМ для реєстрації доменів .UA.

period: Період продовження домену, від 0 до 10. В запиті на трансфер використовується значення = 0 для реєстрів із безкоштовним трансфером та значення = 1 для реєстрів із платним трансфером. Використовується у заявках TRANSFER та RENEW.

auth-code: Код трансферу домену, використовується лише у заявках TRANSFER та UPDATE.

status: Статус домену, використовується лише у заявках UPDATE. Реєстратор може встановлювати такі статуси: "clientUpdateProhibited", "clientDeleteProhibited", "clientTransferProhibited", "clientRenewProhibited" та "clientHold". Зазначене в запиті одне поле "status: ok" — скидає усі попередньовстановлені реєстратором статуси.

registrant-c: Персональний контакт CUNIC організації або особи на користь якого зареєстрований домен.

admin-c: Персональний контакт CUNIC організації або особи, яка займається питаннями реєстрації.

tech-c: Персональний контакт CUNIC організації або особи, відповідальної за технічну роботу домену (експлуатація nameserver'ів, ліквідація аварійних ситуацій та ін.)

billing-c: Персональний контакт CUNIC організації або особи, яка займається питаннями оплати реєстрації.

nserver: Ім'я сервера, який обслуговуватиме домен. Має бути як мінімум два nserver, що вказують на фізично різні сервера імен. IP-адреса nameserver'а обов'язкова у випадку, якщо його ім'я — у зоні, що делегується (наприклад, ns.www.biz.ua для домену www.biz.ua). А якщо ні, то зазначення ​​IP помилкою не вважається, але ігнорується. Формат: Повне ім'я сервера, за необхідності через пропуск IP адреси nameserver'a.

mnt-by: Ідентифікатор реєстратора (mnt-cunic). Обов'язкове поле.

source: Вказує джерело інформації про домен. На DRS — завжди CUNIC. Обов'язкове поле. Маркер кінця заявки

Увага! При використанні заявки UPDATE необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад - "tech-c"), це означатиме його видалення. Виняток – вісутність поля статусу — "status: ok". У заявках інших типів вказувати поля крім необхідних для її обробки не обов'язково, вказані ж будуть проігноровані.

Типи команд

З об'єктом domain можна виконувати наступні операції:

CREATE – реєстрація нового об'єкта UPDATE – зміна властивостей об 'єкта RENEW – збільшення часу життя об'єкта TRANSFER – зміна обслуговуючого реєстратора об'єкта RESTORE – відновлення об'єкта DELETE – видалення об'єкта з бази DRS

Нижче наведено приклади правильно оформлених заявок (за "Subject:" слідує тема електронного листа, що відповідає заявці, а після "Message body:" — сам зміст запиту).

CREATE

"Subject:" create ***.biz.ua

"Message body:" domain: ***.biz.ua registrant-c: ***-CUNIC admin-c: ***-CUNIC tech-c: ***-CUNIC billing-c: ***-CUNIC nserver: ns1.***.com nserver: ns2.***.com mnt-by: ***-MNT-CUNIC source: CUNIC

"Subject:" create ***.ua

"Message body:" domain: ***.ua license: 12345 registrant-c: ***-CUNIC admin-c: ***-CUNIC tech-c: ***-CUNIC nserver: ns1.***.ua 62.149.0.157 nserver: ns1.***.com mnt-by: ***-MNT-CUNIC source: CUNIC

"Subject:" create ***.com.ua

"Message body:" domain: ***.com.ua registrant-c: ***-CUNIC admin-c: ***-CUNIC tech-c: ***-CUNIC nserver: ns1.***.ua 62.149.0.157 nserver: ns1.***.com mnt-by: ***-MNT-CUNIC source: CUNIC

UPDATE

Увага! При використанні заявки UPDATE необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад - "tech-c"), це означатиме його видалення. Виняток – вісутність поля статусу чи коду трансферу.

"Subject:" update ***.biz.ua

"Message body:" domain: ***.biz.ua registrant-c: ***-CUNIC admin-c: ***-CUNIC tech-c: ***-CUNIC billing-c: ***-CUNIC nserver: ns3.***.biz.ua 62.149.0.157 nserver: ns4.***.com mnt-by: ***-MNT-CUNIC source: CUNIC

"Subject:" update ***.com.ua

"Message body:" domain: ***.com.ua auth-code: код трансферу status: ok registrant-c: ***-CUNIC admin-c: ***-CUNIC tech-c: ***-CUNIC nserver: ns3.***.com nserver: ns4.***.com mnt-by: ***-MNT-CUNIC source: CUNIC

RENEW

Subject: renew ***.co.ua

Message body: domain: ***.co.ua mnt-by: ***-MNT-CUNIC source: CUNIC

Вісутність поля "period" означає продовження длмену на 1 рік.

TRANSFER

Subject: transfer ***.co.ua

Message body: domain: ***.co.ua period: 0 auth-code: код трансфера mnt-by: ***-MNT-CUNIC source: CUNIC

Subject: transfer ***.com.ua

Message body: domain: ***.com.ua period: 1 auth-code: код трансфера mnt-by: ***-MNT-CUNIC source: CUNIC

Subject: transfer ***.com

Message body: domain: ***.com auth-code: код трансфера mnt-by: ***-MNT-CUNIC source: CUNIC

Вісутність поля "period" означає що в заявці буде використане значення за замовчуванням: 0 для реєстрів із безкоштовним трансфером та значення 1 для реєстрів із платним трансфером.

RESTORE

Subject: restore ***.biz.ua

Message body: domain: ***.biz.ua mnt-by: ***-MNT-CUNIC source: CUNIC

Відновлення доменів командою RESTORE наразі доступне для доменів .BIZ.UA, .CO.UA та .PP.UA.

DELETE

Заявка DELETE видаляє лише запис з бази DRS і не видаляє домен з реєстру.

Subject: delete ***.com.ua

Message body: domain: ***.com.ua mnt-by: ***-MNT-CUNIC source: CUNIC

Відповіді

Система автоматично відповідає на листи надіслані на електрону пошту auto-dbm@drs.ua. Відповідь містить статус обробки, номер заявки та цитату отриманного оригіналу.

0200

INFO:0300 вказує на номер заявки назначений системою автоматично.

0200

OK:0200 заявка успішно виконана

2400