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

Матеріал з DRS wiki
Перейти до: навігація, пошук
(→‎Відповіді)
Рядок 32: Рядок 32:
 
== Опис ==
 
== Опис ==
 
Заявка складається з набору рядків, які у свою чергу складаються з імен полів та їх
 
Заявка складається з набору рядків, які у свою чергу складаються з імен полів та їх
−
значень, розділених символом ':'.  
+
значень, розділених символом ':' та пробілом.
 +
Значення полів має відповідати вимогам відповідного доменного імені.
  
 
Поля можуть бути таких типів:
 
Поля можуть бути таких типів:
 +
 +
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". У заявках інших типів вказувати поля крім необхідних для її обробки не обов'язково, вказані ж будуть проігноровані.
  
 
== Типи команд ==
 
== Типи команд ==
Рядок 44: Рядок 86:
 
TRANSFER – зміна обслуговуючого реєстратора об'єкта
 
TRANSFER – зміна обслуговуючого реєстратора об'єкта
 
RESTORE – відновлення об'єкта
 
RESTORE – відновлення об'єкта
−
DELETE – видалення об'єкта
+
DELETE – видалення об'єкта з бази DRS
 +
 
 +
Нижче наведено приклади правильно оформлених заявок (за "Subject:" слідує тема електронного листа, що відповідає заявці, а після "Message body:" — сам зміст запиту).
  
 
=== CREATE ===  
 
=== 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 ===
−
Результат
+
Увага! При використанні заявки 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
 +
 
 +
Відновлення доменів командою <code>RESTORE<code> наразі доступне для доменів .[[BIZ.UA]], .[[CO.UA]] та .[[PP.UA]].
 +
 
 +
=== DELETE ===
 +
Заявка <code>DELETE</code> видаляє лише запис з бази DRS і не видаляє домен з реєстру.
 +
 
 +
<code>Subject:
 +
delete ***.com.ua
 +
 
 +
Message body:
 +
domain: ***.com.ua
 +
mnt-by: ***-MNT-CUNIC
 +
source: CUNIC
 +
</code>
  
 
== Відповіді ==
 
== Відповіді ==
−
Для отримання повідомлень та результатів
+
Система автоматично відповідає на листи надіслані на електрону пошту auto-dbm@drs.ua.
 +
Відповідь містить статус обробки, номер заявки та цитату отриманного оригіналу.
 +
 
 +
==== 0200 ====
 +
<code>INFO:0300</code> вказує на номер заявки назначений системою автоматично.
 +
 
 +
==== 0200 ====
 +
<code>OK:0200</code> заявка успішно виконана
  
−
==== 1000 ====
 
−
успішно
 
 
==== 2400 ====
 
==== 2400 ====
 +
<code></code>

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

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<code> наразі доступне для доменів .BIZ.UA, .CO.UA та .PP.UA.

DELETE

Заявка <code>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

Отримано з https://wiki.drs.ua/index.php?title=SMTP&oldid=1379