Відмінності між версіями «SMTP»
Admin (обговорення • внесок) (→RESTORE) |
Admin (обговорення • внесок) |
||
| Рядок 91: | Рядок 91: | ||
=== CREATE === | === CREATE === | ||
| − | + | ''Subject:'' | |
create ***.biz.ua | create ***.biz.ua | ||
| − | + | ''Message body:'' | |
domain: ***.biz.ua | domain: ***.biz.ua | ||
registrant-c: ***-CUNIC | registrant-c: ***-CUNIC | ||
| Рядок 105: | Рядок 105: | ||
source: CUNIC | source: CUNIC | ||
| − | + | ''Subject:'' | |
create ***.ua | create ***.ua | ||
| − | + | ''Message body:'' | |
domain: ***.ua | domain: ***.ua | ||
license: 12345 | license: 12345 | ||
| Рядок 119: | Рядок 119: | ||
source: CUNIC | source: CUNIC | ||
| − | + | ''Subject:'' | |
create ***.com.ua | create ***.com.ua | ||
| − | + | ''Message body:'' | |
domain: ***.com.ua | domain: ***.com.ua | ||
registrant-c: ***-CUNIC | registrant-c: ***-CUNIC | ||
| Рядок 135: | Рядок 135: | ||
Увага! При використанні заявки UPDATE необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад - "tech-c"), це означатиме його видалення. Виняток – вісутність поля статусу чи коду трансферу. | Увага! При використанні заявки UPDATE необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад - "tech-c"), це означатиме його видалення. Виняток – вісутність поля статусу чи коду трансферу. | ||
| − | + | ''Subject:'' | |
update ***.biz.ua | update ***.biz.ua | ||
| − | + | ''Message body:'' | |
domain: ***.biz.ua | domain: ***.biz.ua | ||
registrant-c: ***-CUNIC | registrant-c: ***-CUNIC | ||
| Рядок 149: | Рядок 149: | ||
source: CUNIC | source: CUNIC | ||
| − | + | ''Subject:'' | |
update ***.com.ua | update ***.com.ua | ||
| − | + | ''Message body:'' | |
domain: ***.com.ua | domain: ***.com.ua | ||
auth-code: код трансферу | auth-code: код трансферу | ||
| Рядок 166: | Рядок 166: | ||
=== RENEW === | === RENEW === | ||
| − | Subject: | + | ''Subject:'' |
renew ***.co.ua | renew ***.co.ua | ||
| − | Message body: | + | ''Message body:'' |
domain: ***.co.ua | domain: ***.co.ua | ||
mnt-by: ***-MNT-CUNIC | mnt-by: ***-MNT-CUNIC | ||
| Рядок 178: | Рядок 178: | ||
=== TRANSFER === | === TRANSFER === | ||
| − | Subject: | + | ''Subject:'' |
transfer ***.co.ua | transfer ***.co.ua | ||
| − | Message body: | + | ''Message body:'' |
domain: ***.co.ua | domain: ***.co.ua | ||
period: 0 | period: 0 | ||
| Рядок 188: | Рядок 188: | ||
source: CUNIC | source: CUNIC | ||
| − | Subject: | + | ''Subject:'' |
transfer ***.com.ua | transfer ***.com.ua | ||
| − | Message body: | + | ''Message body:'' |
domain: ***.com.ua | domain: ***.com.ua | ||
period: 1 | period: 1 | ||
| Рядок 198: | Рядок 198: | ||
source: CUNIC | source: CUNIC | ||
| − | Subject: | + | ''Subject:'' |
transfer ***.com | transfer ***.com | ||
| − | Message body: | + | ''Message body:'' |
domain: ***.com | domain: ***.com | ||
auth-code: код трансфера | auth-code: код трансфера | ||
| Рядок 211: | Рядок 211: | ||
=== RESTORE === | === RESTORE === | ||
| − | Subject: | + | ''Subject:'' |
restore ***.biz.ua | restore ***.biz.ua | ||
| − | Message body: | + | ''Message body:'' |
domain: ***.biz.ua | domain: ***.biz.ua | ||
mnt-by: ***-MNT-CUNIC | mnt-by: ***-MNT-CUNIC | ||
| Рядок 224: | Рядок 224: | ||
Заявка <code>DELETE</code> видаляє лише запис з бази DRS і не видаляє домен з реєстру. | Заявка <code>DELETE</code> видаляє лише запис з бази DRS і не видаляє домен з реєстру. | ||
| − | <code>Subject: | + | <code> |
| + | ''Subject:'' | ||
delete ***.com.ua | delete ***.com.ua | ||
| − | Message body: | + | ''Message body:'' |
domain: ***.com.ua | domain: ***.com.ua | ||
mnt-by: ***-MNT-CUNIC | mnt-by: ***-MNT-CUNIC | ||
Версія за 16:35, 28 жовтня 2022
| Опис | Характеристика |
|---|---|
| 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
