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 організації або особи, відповідальної за технічну роботу домену (експлуатація nameservers, ліквідація аварійних ситуацій та ін.)

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, які знаходяться у статусі pendingDelete.

DELETE

Subject:
delete ***.com.ua

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

Відповіді

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

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

OK:0203 — заявка успішно прийнята в чергу і ще не завершена

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

ERROR:0098 — заявка відхилена та завершена

Після коду може бути зазначена причина скасування запиту.

Наприклад: ERROR:0098 Low account balance or any billing error — повідомляє про брак коштів на балансі для здійснення платної операції.
Або в доменах .PP.UA може бути відхилена заявка з результатом ERROR:0098 Invalid phone number in registrant contact — що вказує на некоректність номера телефона реєстранта, на який відправляється sms.