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

Матеріал з DRS wiki
Перейти до: навігація, пошук
(UPDATE)
 
(не показані 32 проміжні версії цього учасника)
Рядок 19: Рядок 19:
 
Команди приймаються електронною поштою за умови:
 
Команди приймаються електронною поштою за умови:
  
* Відправки реєстратором запиту лише на адресу auto-dbm@drs.ua
+
* Надсилання реєстратором запиту лише на адресу <code>auto-dbm@drs.ua</code>
 
* Тільки з авторизованих email адрес акредитованих реєстраторів.
 
* Тільки з авторизованих email адрес акредитованих реєстраторів.
 
* Ідентифікатор реєстратора, який надіслав заявку, має бути обов'язково зазначений у тексті електронного листа-заявки в полі "mnt-by".
 
* Ідентифікатор реєстратора, який надіслав заявку, має бути обов'язково зазначений у тексті електронного листа-заявки в полі "mnt-by".
 
* Лист має бути в text/plain (utf-8, koi8-r, koi8-u, windows-1251 якщо містить кириличні символи). Усі формати MIME відкидаються.
 
* Лист має бути в text/plain (utf-8, koi8-r, koi8-u, windows-1251 якщо містить кириличні символи). Усі формати MIME відкидаються.
* Неприпустимі вкладення, HTMLформатування та Base-64 або Quoted-Printable перекодування.  
+
* Неприпустимі вкладення, HTML форматування та Base-64 або Quoted-Printable перекодування.  
* Заборонено використання в листі-заявці різних підписів, оскільки автоматична система може
+
* Заборонено використання в листі-заявці різних підписів, оскільки автоматична система може прийняти весь підпис або її частину за фрагмент заявки із синтаксичною помилкою.
прийняти весь підпис або її частину за фрагмент заявки із синтаксичною помилкою.
+
 
* В одному листі має бути не більше однієї заявки.
 
* В одному листі має бути не більше однієї заявки.
  
Рядок 31: Рядок 30:
  
 
== Опис ==
 
== Опис ==
Заявка складається з набору рядків, які у свою чергу складаються з імен полів та їх
+
Заявка складається з набору рядків, які в свою чергу складаються з імен полів та їх значень, розділених символом ':' та пробілом.
значень, розділених символом ':'.  
+
<br>Значення полів має відповідати вимогам відповідного доменного імені.
  
 
Поля можуть бути таких типів:
 
Поля можуть бути таких типів:
 +
 +
<code>domain:</code>
 +
Повне ім'я домену. Не повинно починатися та закінчуватися на символ '-'. ''Обов'язкове поле''.
 +
 +
<code>license:</code>
 +
Номер свідоцтва ТМ для реєстрації доменів .[[UA]].
 +
 +
<code>period:</code>
 +
Період продовження домену, від 0 до 10. В запиті на трансфер використовується значення = 0 для реєстрів із безплатним трансфером та значення = 1 для реєстрів із платним трансфером. Використовується у заявках <code>TRANSFER</code> та <code>RENEW</code>.
 +
 +
<code>auth-code:</code>
 +
Код трансферу домену, використовується лише у заявках <code>TRANSFER</code> та <code>UPDATE</code>.
 +
 +
<code>status:</code>
 +
Статус домену, використовується лише у заявках <code>UPDATE</code>.
 +
Реєстратор може встановлювати такі статуси: "clientUpdateProhibited", "clientDeleteProhibited", "clientTransferProhibited", "clientRenewProhibited" та "clientHold". Зазначене в запиті одне поле "status: ok" — скидає усі попередньо встановлені реєстратором статуси.
 +
 +
<code>registrant-c:</code>
 +
Персональний контакт [[CUNIC]] організації або особи на користь якого зареєстрований домен.
 +
 +
<code>admin-c:</code>
 +
Персональний контакт [[CUNIC]] організації або особи, яка займається питаннями реєстрації.
 +
 +
<code>tech-c:</code>
 +
Персональний контакт [[CUNIC]] організації або особи, відповідальної за технічну роботу домену (експлуатація nameservers, ліквідація аварійних ситуацій та ін.)
 +
 +
<code>billing-c:</code>
 +
Персональний контакт [[CUNIC]] організації або особи, яка займається питаннями оплати реєстрації.
 +
 +
<code>nserver:</code>
 +
Ім'я сервера, який обслуговуватиме домен. Має бути як мінімум два nserver, що вказують на фізично різні сервера імен. IP-адреса nameserver'а обов'язкова у випадку, якщо його ім'я — у зоні, що делегується (наприклад, ns.www.biz.ua для домену www.biz.ua). А якщо ні, то зазначення ​​IP помилкою не вважається, але ігнорується.
 +
''Формат:'' Повне ім'я сервера, за необхідності через пропуск IP адреси nameserver'a.
 +
 +
<code>mnt-by:</code>
 +
Ідентифікатор реєстратора (mnt-cunic). ''Обов'язкове поле''.
 +
 +
<code>source:</code>
 +
Вказує джерело інформації про домен. На DRS — завжди CUNIC. ''Обов'язкове поле''. '''Є маркером кінця заявки'''
 +
 +
 +
''Увага!'' При використанні заявки <code>UPDATE</code> необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад — "tech-c"), це означатиме його видалення. Виняток – відсутність поля статусу — "status: ok". У заявках інших типів вказувати поля крім необхідних для її обробки не обов'язково, вказані ж будуть проігноровані.
  
 
== Типи команд ==
 
== Типи команд ==
 
З об'єктом domain можна виконувати наступні операції:
 
З об'єктом domain можна виконувати наступні операції:
  
CREATE – реєстрація нового об'єкта
+
<code>CREATE</code> – реєстрація нового об'єкта
UPDATE – зміна властивостей об 'єкта
+
<br><code>UPDATE</code> – зміна властивостей об'єкта
RENEW – збільшення часу життя об'єкта
+
<br><code>RENEW</code> – збільшення часу життя об'єкта
TRANSFER – зміна обслуговуючого реєстратора об'єкта
+
<br><code>TRANSFER</code> – зміна реєстратора, що обслуговує об'єкт
RESTORE – відновлення об'єкта
+
<br><code>RESTORE</code> – відновлення об'єкта
DELETE – видалення об'єкта
+
<br><code>DELETE</code> – видалення об'єкта з бази DRS
 +
 
 +
Нижче наведено приклади правильно оформлених заявок (за ''Subject:'' слідує тема електронного листа, що відповідає заявці, а після ''Message body:'' — сам зміст запиту).
  
 
=== CREATE ===  
 
=== CREATE ===  
Кожна з ..
+
<code>''Subject:''
 +
<br>create ***.biz.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.biz.ua
 +
<br>registrant-c: ***-CUNIC
 +
<br>admin-c: ***-CUNIC
 +
<br>tech-c: ***-CUNIC
 +
<br>billing-c: ***-CUNIC
 +
<br>nserver: ns1.***.com
 +
<br>nserver: ns2.***.com
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
---------
 +
''Subject:''
 +
<br>create ***.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.ua
 +
<br>license: 12345
 +
<br>registrant-c: ***-CUNIC
 +
<br>admin-c: ***-CUNIC
 +
<br>tech-c: ***-CUNIC
 +
<br>nserver: ns1.***.ua 62.149.0.157
 +
<br>nserver: ns1.***.com
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
---------
 +
''Subject:''
 +
<br>create ***.com.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.com.ua
 +
<br>registrant-c: ***-CUNIC
 +
<br>admin-c: ***-CUNIC
 +
<br>tech-c: ***-CUNIC
 +
<br>nserver: ns1.***.ua 62.149.0.157
 +
<br>nserver: ns1.***.com
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
</code>
  
 
=== UPDATE ===
 
=== UPDATE ===
Результат
+
Увага! При використанні заявки <code>UPDATE</code> необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад — <code>tech-c</code>), це означатиме його видалення. Виняток – відсутність поля статусу чи коду трансферу.
 +
 
 +
<code>''Subject:''
 +
<br>update ***.biz.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.biz.ua
 +
<br>registrant-c: ***-CUNIC
 +
<br>admin-c: ***-CUNIC
 +
<br>tech-c: ***-CUNIC
 +
<br>billing-c: ***-CUNIC
 +
<br>nserver: ns3.***.biz.ua 62.149.0.157
 +
<br>nserver: ns4.***.com
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
---------
 +
''Subject:''
 +
<br>update ***.com.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.com.ua
 +
<br>auth-code: код трансферу
 +
<br>status: ok
 +
<br>registrant-c: ***-CUNIC
 +
<br>admin-c: ***-CUNIC
 +
<br>tech-c: ***-CUNIC
 +
<br>nserver: ns3.***.com
 +
<br>nserver: ns4.***.com
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
</code>
 +
 
 +
=== RENEW ===
 +
 
 +
<code>''Subject:''
 +
<br>renew ***.co.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.co.ua
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
</code>
 +
 
 +
Відсутність поля <code>period</code> означає продовження домену на 1 рік.
 +
 
 +
=== TRANSFER ===
 +
<code>
 +
''Subject:''
 +
<br>transfer ***.co.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.co.ua
 +
<br>period: 0
 +
<br>auth-code: код трансфера
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
---------
 +
''Subject:''
 +
<br>transfer ***.com.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.com.ua
 +
<br>period: 1
 +
<br>auth-code: код трансфера
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
---------
 +
''Subject:''
 +
<br>transfer ***.com
 +
 
 +
''Message body:''
 +
<br>domain: ***.com
 +
<br>auth-code: код трансфера
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
</code>
 +
 
 +
Відсутність поля <code>"period"</code> означає що в заявці буде використане значення за замовчуванням: 0 для реєстрів із безплатним трансфером та значення 1 для реєстрів із платним трансфером.
 +
 
 +
=== RESTORE ===
 +
 
 +
<code>''Subject:''
 +
<br>restore ***.biz.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.biz.ua
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
</code>
 +
 
 +
Відновлення доменів командою <code>RESTORE</code> наразі також доступне для доменів .[[BIZ.UA]], .[[CO.UA]] та .[[PP.UA]], які знаходяться у статусі <code>pendingDelete</code>.
 +
 
 +
=== DELETE ===
 +
<code>
 +
''Subject:''
 +
<br>delete ***.com.ua
 +
 
 +
''Message body:''
 +
<br>domain: ***.com.ua
 +
<br>mnt-by: ***-MNT-CUNIC
 +
<br>source: CUNIC
 +
</code>
  
 
== Відповіді ==
 
== Відповіді ==
Для отримання повідомлень та результатів
+
Система автоматично відповідає на листи надіслані на електрону пошту <code>auto-dbm@drs.ua</code>.
 +
<br>Відповідь містить статус обробки, номер заявки та цитату отриманого від реєстратора оригіналу.
 +
 
 +
'''<code>INFO:0300</code>''' — вказує на номер заявки назначений системою автоматично
 +
 
 +
'''<code>OK:0203</code>''' — заявка успішно прийнята в чергу і ще не завершена
 +
 
 +
'''<code>OK:0200</code>''' — заявка успішно виконана та завершена
 +
 
 +
'''<code>ERROR:0098</code>''' — заявка відхилена та завершена
 +
 
 +
Після коду може бути зазначена причина скасування запиту.
  
==== 1000 ====
+
''Наприклад'': <code>ERROR:0098</code> ''Low account balance or any billing error'' — повідомляє про брак коштів на балансі для здійснення платної операції.
==== 2400 ====
+
<br>Або в доменах .[[PP.UA]] може бути відхилена заявка з результатом <code>ERROR:0098</code> ''Invalid phone number in registrant contact'' — що вказує на некоректність номера телефона реєстранта, на який відправляється sms.

Поточна версія на 17:09, 7 березня 2024

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.