Відмінності між версіями «SMTP»
Admin (обговорення • внесок) |
Admin (обговорення • внесок) (→UPDATE) |
||
(не показані 32 проміжні версії цього учасника) | |||
Рядок 19: | Рядок 19: | ||
Команди приймаються електронною поштою за умови: | Команди приймаються електронною поштою за умови: | ||
− | * | + | * Надсилання реєстратором запиту лише на адресу <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 перекодування. |
− | * Заборонено використання в листі-заявці різних підписів, оскільки автоматична система може | + | * Заборонено використання в листі-заявці різних підписів, оскільки автоматична система може прийняти весь підпис або її частину за фрагмент заявки із синтаксичною помилкою. |
− | прийняти весь підпис або її частину за фрагмент заявки із синтаксичною помилкою. | + | |
* В одному листі має бути не більше однієї заявки. | * В одному листі має бути не більше однієї заявки. | ||
Рядок 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>''' — заявка відхилена та завершена | ||
+ | |||
+ | Після коду може бути зазначена причина скасування запиту. | ||
− | + | ''Наприклад'': <code>ERROR:0098</code> ''Low account balance or any billing error'' — повідомляє про брак коштів на балансі для здійснення платної операції. | |
− | + | <br>Або в доменах .[[PP.UA]] може бути відхилена заявка з результатом <code>ERROR:0098</code> ''Invalid phone number in registrant contact'' — що вказує на некоректність номера телефона реєстранта, на який відправляється sms. |
Поточна версія на 17:09, 7 березня 2024
Опис | Характеристика |
---|---|
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.