RRP - Протокол Регистратор - Реестр
Содержание
1. Введение.
2. Обеспечение безопасности.
2.1. Обеспечение безопасности хранимых данных.
3. Модель подключения.
4. Описание Протокола.
4.1. Формат запроса.
4.2. Формат ответа.
4.3. Команды, поддерживаемые Протоколом.
4.3.1. Открытие пользовательской сессии.
4.3.2. Завершение пользовательской сессии.
4.3.3. Проверка доступности доменного имени.
4.3.3.1 Проверка доступности доменного имени (краткая форма).
4.3.4. Регистрация (делегирование) доменного имени.
4.3.5. Изменение записи о доменном имени.
4.3.5.1. Изменение списка серверов имён.
4.3.5.2. Изменение прочих данных.
4.3.6. Продление срока делегирования доменного имени.
4.3.7. Прекращение делегирования доменного имени.
4.3.8. Переделегирование доменного имени другому Регистранту.
4.3.9. Разрешение или запрет перевода доменного имени.
4.3.10. Запрос перевода доменного имени от другого Регистратора.
4.3.11. Создание записи о сервере имён.
4.3.12. Просмотр регистрационной информации о сервере имён.
4.3.13. Переименование сервера имён.
4.3.14. Изменение ip-адреса в записи о сервере имён.
4.3.15. Удаление записи о сервере имён.
4.3.16. Просмотр регистрационной информации о лице.
4.3.17. Поиск заявок, находящихся в очереди.
4.3.18. Отмена удовлетворённой заявки.
4.3.19. Удаление необработанной заявки из очереди.
4.3.20. Получение списка заявок на перевод сопровождаемых доменных имён.
4.3.21. Завершение подключения.
5. Коды ответов сервера.
1. Введение.
Данный документ описывает условия и особенности реализации и
использования Протокола Регистратора - Реестр (RRP), позволяющего Регистраторам
предоставлять услуги по регистрации доменных имён, администрируемых Реестром.
В документе рассмотрены основные характеристики, интерфейс
взаимодействия и особенности реализации Протокола в географическом домене
Украины (.UA). Протокол был разработан регистратором доменов верхнего уровня
компанией Network Solutions, Inc. Детальную спецификацию и информацию о его
реализации у регистраторов доменов верхнего уровня можно найти в RFC 2832.
В документе использованы такие термины для обозначения участников
процесса делегирования доменных имён:
* Регистрант - лицо, которое желает пользоваться и распоряжаться определенным
доменным именем.
* Регистратор - субъект хозяйствования, который предоставляет регистранту
услуги, необходимые для технического обеспечения делегирования и
функционирования доменного имени.
* Администратор (Реестр) - администратор публичного домена, в котором
происходит делегирование. Лицо, исполняющее функции администратора публичного
домена.
* Протокол - Протокол Регистратора Реестра (RRP), реализовнный в географическом
домене Украины (.UA).
Данный документ описывает протокол общения Администратор-Регистратор.
Протокол не предоставляет никаких сервисов Регистрантам.
В примерах "C:" используется для обозначения сообщений, передаваемых
клиентским ПО Регистратора, "S:" - для обозначения сообщений, передаваемых
сервером Администратора.
Администратор хранит и сопровождает информацию о зарегистрированных
доменных именах и ассоциированных с ними серверах имён. Запись о доменном имени
включает в себя имя домена, сервера имён, Регистратора домена, контактные данные
домена, описание домена и его статус. Запись о сервере имён включает в себя его
имя и ip-адрес.
Регистратор может производить следующие действия с использованием RRP:
- проверка доступности доменного имени;
- регистрация (делегирование) доменного имени;
- изменение записи о доменном имени;
- продление срока делегирования доменного имени;
- прекращение делегирования доменного имени;
- переделегирование доменного имени другому Регистранту;
- разрешение или запрет перевода доменного имени;
- запрос перевода доменного имени от другого Регистратора;
- создание записи о сервере имён;
- просмотр регистрационной информации о сервере имён;
- переименование сервера имён;
- изменение ip-адреса в записи о сервере имён;
- удаление записи о сервере имён;
- просмотр регистрационной информации о лице;
- просмотр заявок в очереди;
- отмена удовлетворённой заявки;
- удаление необработанной заявки из очереди;
- получение списка заявок на перевод сопровождаемых доменных имён.
2. Обеспечение безопасности.
RRP позволяет использовать только фундаментальный уровень обеспечения
безопасности клиента по паролю. Дополнительный уровень безопасности достигается
с помощью Secure Socket Layer (SSL). SSL позволяет значительно уменьшить риск
раскрытия конфиденциальной информации Регистратора, такой как идентификатор
Регистратора и его пароль.
SSL поддерживает двухстороннюю аутентификацию клиента и сервера с
использованием подписанных электронных сертификатов.
После установления соединения клиент-сервер, Регистратор должен быть
аутентифицирован с помощью команды "SESSION OPEN". Для аутентификации
Регистратор предоставляет свой идентификатор и пароль к нему.
2.1. Обеспечение безопасности хранимых данных.
Администратор хранит информацию о зарегистрированных доменных именах и
ассоциированных с ними серверах имён.
Только текущий Регистратор зарегистрированного доменного имени имеет
право и возможность обновлять информацию о нём, удалять и продлевать срок его
делегирования. Любой Регистратор может запросить перевод доменного имени и
ассоциированных с ним серверов имён от другого Регистратора к себе. Только
текущий Регистратор доменного имени может получать и принимать решение о
переводе (разрешение либо запрещение перевода доменного имени к другому
Регистратору).
Сервера имён автоматически переводятся Администратором вместе с
переводом доменного имени, с которым они ассоциированны, к новому Регистратору.
В дополнение к этому, сервер имён не может быть удалён из базы данных
Администратора до тех пор, пока он ассоциирован с доменным именем.
2. Модель подключения.
Для использования Протокола RRP Международной Ассоциацией по
Распределению Имён (IANA) выделен TCP-порт 648. RRP сервер при подключении
передаёт приветствие, подтверждающее установление соединения, в следующем
формате:
<название регистра> RRP Server version <версия сервера>
<дата и время ввода сервера в эксплуатацию>
Каждая строка завершается символом перевода каретки на новую строку
(). Дата ввода сервера в эксплуатацию состоит из дня, месяца, даты,
времени (указывается в формате "часы:минуты:секунды"), времнной зоны и года.
Точка (".") в первой позиции строки без последующих символов обозначает
завершение приветствия:
S:UANIC RRP Server version 0.0.2
S:Fri Apr 13 00:00:02 EEST 2007
S:.
4. Описание Протокола.
Типичная сессия RRP состоит из последовательности шагов.
Нижеприведённая схема описывает возможный набор таких шагов. Изначально
сервер ожидает подключения и аутентификации клиента (PRE). Всё подключения
клиента должны быть аутентифицированы.
|
|
v
+-----------------+ Таймаут
| Ожидание |-------------------+
Успешная Аутентификация | Аутентификации | |
+---------| Клиента | Неудачаня Аутенти-|
| | (PRE) |-----+ фикация |
| +-----------------+ | |
| | |
V Успешная V |
+-----------+ Аутентификация +--------------------+ |
| Ожидание |<-----------------| Ожидание Поторной | |
| Команды |----------+ | Аутентификации | |
| (WFC) | Таймаут | | (WFR) | |
+-----------+ | +--------------------+ |
| ^ | | | |
| | | Таймаут| |Неудача |
Запрос V | Ответ | | | |
+-----------+ | V V V
| Выполнение| | +--------------------+
| Команды | +--------->| Отключение |
| (EXE) |-------------------->| (DIS) |
+-----------+ Выход (EXIT) +--------------------+
Если аутентфикация не прошла, сервер ожидает повторной попытки клиента
аутентифицировать себя (WFR). Если аутентификация снова не произошло, сервер
разрывает соединение (DIS). В случае удачной аутентификации, сервер ожидает
запрос от клиента (WFC). После получения запроса сервер выполняет его и
отсылает ответ с результатом (EXE). После этого сервер ожидает следующий запрос
от клиента (WFC). Если клиент отсылает команду "EXIT", сервер закрывает сессию
и разрывает соединение (DIS). Для синхронизации выполнения шагов клиент должен
дождаться ответа от сервера перед отсылкой следующей команды в рамках одного
подключения.
Ниже приведён список таких шагов:
PRE Ожидание подключения и аутентификации клиента
WFR Ожидание поторной аутентификации
WFC Ожидание команды от аутентифицированного клиента
EXE Выполнение команды
DIS Отключение
Шаги WFR и WFC могут завершаться по таймауту. Сервер может отключатся
на данных шагах, если не получает данные от клиента в течении установленного
таймаута. Таймаут устанавливается в зависимости от специфических особенностей
системы и на основе соблюдения мер безопасности.
4.1. Формат запроса.
Запрос, используемый в Протоколе, состоит из имени команды, параметров
команды и разделителя окончания команды. Параметры команды включают в себя
названия параметров и их значения. Очерёдность передачи параметров не является
обязательной:
ИмяКоманды [ПараметрыКоманды] ОкончаниеКоманды
Именем команды определяется тип запроса. Имя команды нечувствительно к
регистру. Имя команды завершается переводом каретки на новую строку:
ИмяКоманды
Параметры команды детализируют запрос. Параметр команды начинается с
имени параметра, за которым следует двоеточие (":"), далее - значение параметра,
и завершается переводом каретки на новую строку:
ПараметрКоманды:ЗначениеПараметра
Разделитель окончания команды указывает на завершение запроса и состоит
из точки (".") в первой позиции строки, завершенной переводом каретки на новую
строку:
.
4.2. Формат ответа.
Ответ, используемый в Протоколе, начинается с трёхзначного цифрового
кода, далее - пробел, текстовое описание ответа, перевод каретки на новую строки
и ноль или более строк с аттрибутами ответа в виде пар "аттрибут:значение".
Ответ завершается точкой (".") в первой позиции строки с переводом каретки на
новую строку:
КодОтвета<пробел>ОписаниеОтвета
[ИмяАттрибута:ЗначениеАттрибута]
.
4.3. Команды, поддерживаемые Протоколом.
Протокол Регистратора Реестра (RRP), реализованный в регистрационной
системе UANIC, поддерживает нижеописанный набор команд.
В описании команд используются следующие условные обозначения:
[...] - опциональный (необязательный) параметр;
*... - неограниченное количество экземпляров;
<цифра>*... - неограниченное количество экземпляров, но минимум <цифра>
например: "1*tech-c" - один и более параметров "tech-c".
4.3.1. Открытие пользовательской сессии.
Команда обеспечивает аутентификацию клиента по паролю и, при удачной
аутентификации, открывает пользовательскую сессию, в рамках которой выполняются
все последующие команды клиента. Все клиенты должны быть аутентифицированы после
подключения.
Синтаксис:
SESSION OPEN
user: Сетевой идентификатор клиента (без суффикса "-UANIC")
password: Пароль пользователя
Вывод:
220 Command completed successfully
Исключения:
530 Authentication failed Неправильные имя пользователя или пароль
531 Authorization failed Пользователь не имеет привилегий для выполнения команды
547 Invalid command sequence Пользовательская сессия уже открыта
Примечания:
Открытая пользовательская сессия может быть автоматически закрыта
сервером, если в ней не производится попытки выполнения команд в течение
установленного свойствами системы интервала времени. Пароль - тот же, что и для
управления записью о лице (nic-handle). Имя пользователя нечувствительно к регистру.
Примеры:
C:SESSION OPEN
C:user: USER
C:password: asdf1
C:.
S:220 Command completed successfully
S:.
4.3.2. Завершение пользовательской сессии.
Команда закрывает открытую пользовательскую сессию.
Синтаксис:
QUIT
Вывод:
220 Command completed successfully. Server closing connection
Примеры:
C:QUIT
C:.
S:220 Command completed successfully. Server closing connection
S:.
4.3.3. Проверка доступности доменного имени.
Команда позволяет проверить, зарегистрировано ли доменное имя. Если
таковое зарегистрировано, выводится регистрационная информация; иначе -
предупреждение.
Синтаксис:
CHECK DOMAIN
domain:
Вывод:
domain: domain_name доменное имя
admin-c: nic_handle сетевой идентификатор регистранта
1*tech-c: nic_handle сетевой идентификатор технического контакта
status: string date статус, дата установки статуса
dom-public: boolean (Y|N) признак публичного домена
license: string номер свидетельства на знак для товаров и услуг
2*nserver: hostname сервер имён
mnt-by: nic_handle сетевой идентификатор регистратора
[remark:] string примечания
changed: nic_handle date сетевой идентификатор автора последних изменений,
дата их внесения
source: 'UANIC'
Исключения:
541 Invalid attribute value Этот публичный домен не обслуживается
547 Invalid command sequence Нет открытой сессии
Примечания:
Процедура проверяет регистрационные данные только для доменных имён в
сопровождаемых публичных доменах. Для получения регистрационной информации по
доменным именам в других публичных доменах необходимо воспользоваться
соответствующей службой whois. Вывод может отличаться от приведенного в
соответствии с регламентом публичного домена. Например, для доменного имени в
публичном домене .COM.UA не выводится поле "license".
Примеры:
1. Проверка регистрационных данных доменного имени в .UA.
C:CHECK DOMAIN
C:domain: sample1.ua
C:.
S:211 Domain name not available
S:domain: sample1.ua
S:admin-c: A-UANIC
S:tech-c: B1-UANIC
S:tech-c: B2-UANIC
S:status: OK-UNTIL 20070901235958
S:dom-public: NO
S:license: 12345
S:nserver: ns1.com.ua
S:nserver: ns2.com.ua
S:mnt-by: C-UANIC
S:changed: D-UANIC 20070101223344
S:source: UANIC
S:.
2. Проверка регистрационных данных незарегистрированного доменного имени.
C:CHECK DOMAIN
C:domain:sample2.ua
C:.
S:210 Domain name available
S:.
4.3.3.1 Проверка доступности доменного имени (краткая форма).
Команда позволяет проверить, зарегистрировано ли доменное имя.
Синтаксис:
CHECK DOM
domain:
Исключения:
541 Invalid attribute value Этот публичный домен не обслуживается
547 Invalid command sequence Нет открытой сессии
Примечания:
Процедура проверяет регистрационные данные только для доменных имTн в
сопровождаемых публичных доменах. Для получения регистрационной информации по
доменным именам в других публичных доменах необходимо воспользоваться
соответствующей службой whois.
Примеры:
1. Проверка регистрационных данных доменного имени в .UA.
C:CHECK DOM
C:domain: sample1.ua
C:.
S:211 Domain name not available
S:.
2. Проверка регистрационных данных незарегистрированного доменного имени.
C:CHECK DOMAIN
C:domain:sample2.ua
C:.
S:210 Domain name available
S:.
4.3.4. Регистрация (делегирование) доменного имени.
Команда используется для регистрации (делегирования) доменного имени. В
зависимости от свойств публичного домена, в котором запрашивается делегирование,
процедура завершается либо созданием записи о доменном имени, либо размещением
заявки в очереди администратора публичного домена.
Синтаксис:
ADD DOMAIN
domain:
admin-c:
1*tech-c:
2*nserver:
[license:]
[remark:]
Вывод:
В зависимости от свойств публичного домена, в котором запрашивается
делегирование доменного имени, эта процедура в результате успешной обработки
может вывести доменный объект или заявку на делегирование, поставленную в
очередь администратора публичного домена. В результате неуспешной обработки
процедура выведет код и описание возникшей ошибки.
domain: Делегированное доменное имя
status: 'OK-UNTIL' date Дата окончания срока делегирования
или
app_id: string Идентифкатор поставленной в очередь заявки
status: 'QUEUED' Дата, до которой заявка может находиться в очереди
accepted: date Дата постановки заявки в очередь
Исключения:
504 Missing required attribute Не указано обязательное значение (меньше, чем требуется)
540 Attribute value is not unique Указаны повторяющиеся значения одного атрибута
541 Invalid attribute value Ошибка в доменном имени, сетевом идентификаторе или сервере имён
554 Domain already registered Доменное имя уже делегировано
Примечания:
Записи с регистрационными данными, на которые осуществляется ссылка в
параметрах этой процедуры, должны быть созданы до её использования. Поставленная
в очередь администратора публичного домена заявка может быть отозвана до
поступления на обработку. Доменное имя делегируется на один период делегирования
(год). Если необходимо делегировать доменное имя на несколько периодов
делегирования, то после выполнения этой операции следует воспользоваться
процедурой продления срока делегироавния доменного имени (RENEW).
Примеры:
1. Успешное делегирование в .COM.UA
C:ADD DOMAIN
C:domain: sample1.com.ua
C:admin-c: A-UANIC
C:tech-c: B-UANIC
C:tech-c: A-UANIC
C:nserver: ns1.com.ua
C:nserver: ns2.com.ua
C:remark: example
C:.
S:domain: sample1.com.ua
S:status: OK-UNTIL 20070701235013
S:200 Command completed successfully
S:.
2. Постановка заявки в очередь администратора .UA
C:ADD DOMAIN
C:domain: sample2.ua
C:admin-c: A-UANIC
C:tech-c: B-UANIC
C:nserver: ns1.com.ua
C:nserver: ns2.com.ua
C:license: 12345
C:remark: example
C:.
S:app_id: 123123
S:accepted: 20070628221010
S:status: QUEUED
S:200 Command completed successfully
S:.
4.3.5. Изменение записи о доменном имени.
Для изменения записи о доменном имени используется две самостоятельные
команды:
MODTECH - для изменения списка авторитативных серверов имён домена;
MODDESC - для изменения других данных домена.
Данные операции доступны только текущему регистратору доменного имени, запись о
котором изменяется.
4.3.5.1. Изменение списка серверов имён.
Команда позволяет удалить, заменить либо добавить сервера имён в запись
о доменном имени.
Синтаксис:
MODTECH
domain:
1*nserver: ('-' [|'%'])|(['+'] )
"hostname" - имя сервера имён
"-" - удаление записи
"+"" - добавление записи
Вывод:
domain: Доменное имя
status: Статус записи о доменном имени
2*nserver: hostname сервера имён
changed: Сетевой идентификатор автора последних изменений и дата их внесения
Исключения:
504 Missing required attribute Указано меньше, чем надо, серверов имён
531 Authorization failed Нельзя менять доменное имя, которое не сопровождается
540 Attribute value is not unique Указаны повторяющиеся значения одного атрибута
541 Invalid attribute value Такое доменное имя не зарегистрировано
Указанный сервер имён не зарегистрирован
552 Domain status does not allow for operation Внесение изменений запрещено
Примечания:
Записи с регистрационными данными, на которые осуществляется ссылка в
параметрах этой команды, должны быть созданы до её использования. Если для
записи с hostname сервера имён не указана операция, то считается, что эту запись
нужно добавить в список используемых доменным именем серверов имён. Если в
списке используемых в записи о доменном имени серверов имён уже имеется запись о
сервере имён, добавление которого заказывается, то возникает исключительная ситуация.
Если выполняется команда удаления сервер имён из списка используемых
в записи о доменном имени серверов имён, а такой сервер имён в списке
используемых в записи о доменном имени отсутствует, то исключительная ситуация
не возникает. Если требуется удалить все ссылки на записи о серверах имён,
используемые в записи о доменном имени, то после операции "-" вместо hostname
сервера имён можно использовать символ маски "%".
Примеры:
1. Изменение списка серверов имён
C:MODTECH
C:domain: sample1.com.ua
C:nserver: -%
C:nserver: ns1.com.ua
C:nserver: ns2.com.ua
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:status: OK-UNTIL 20060227142838
S:nserver: ns1.com.ua
S:nserver: ns2.com.ua
S:changed: B-UANIC 20050202091936
S:.
2. Добавление одного и удаление другого сервера имён
C:MODTECH
C:domain: sample1.com.ua
C:nserver: -ns2.com.ua
C:nserver: +ns4.com.ua
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:status: OK-UNTIL 20060227142838
S:nserver: ns1.com.ua
S:nserver: ns4.com.ua
S:changed: B-UANIC 20050202091956
S:.
4.3.5.2. Изменение прочих данных.
Команда используется для изменения примечания, технических контактов
и номера свидетельства о регистрации знака на товары и услуги, если это
предусмотрено правилами публичного домена, в котором делегирован текущий домен.
Синтаксис:
MODDESC
domain:
[1*tech-c: ('-' [|'%'])|(['+'] )]
[remark: (['+'] string)|(['-'] ['%'])]
[license: ('-' [|'%'])|(['+'] )]
"-" - удаление записи
"+"" - добавление записи
domain_name - доменное имя, в запись о котором требуется внести изменения
tech-c - сетевой идентификатор технического контакта
remark - примечание
license - номер свидетельства (ТМ)
Вывод:
domain: Доменное имя, в запись о котором внесены изменения
status: Статус записи о доменном имени, дата статуса
tech-c: Сетевой идентификатор технического контакта
remark: Примечание
license: Номер свидетельства (ТМ)
changed: Сетевой идентификатор автора последних изменений, дата их
проведения
Исключения:
503 Invalid attribute name
504 Missing required attribute
531 Authorization failed
549 Command failed Внесение изменений противоречит Правилам
541 Invalid attribute value
552 Domain status does not allow for operation
Примечания:
Записи с регистрационными данными, на которые осуществляется ссылка в
параметрах этой команды, должны быть созданы до её использования. Изменения
вносятся только в те поля доменного объекта, имена которых указаны как
параметры команды. Если имя поля не указано среди параметров, команда оставляет
текущие значения этого поля в записи о доменном имени. Номер свидетельства
можно изменить только в том случае, если соответствующий документ
зарегистрирован.
Примеры:
1. Изменить список технических контактов в записи о доменном имени.
C:MODDESC
C:domain: sample1.com.ua
C:tech-c: -%
C:tech-c: A-UANIC
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:status: OK-UNTIL 20060301011256
S:tech-c: A-UANIC
S:remark: example
S:changed: B-UANIC 20070312143854
S:.
2. Удалить примечание в записи о доменном имени.
C:MODDESC
C:domain: sample1.com.ua
C:remark:
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:status: OK-UNTIL 20070301011256
S:tech-c: A-UANIC
S:remark:
S:changed: B-UANIC 20070312143855
S:.
3. Изменить список технических контактов, удалить примечание.
C:MODDESC
C:domain: sample1.com.ua
C:tech-c: -%
C:tech-c: A-UANIC
C:remark:
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:status: OK-UNTIL 20060301011256
S:tech-c: A-UANIC
S:remark:
S:changed: B-UANIC 20050312143854
S:.
4.3.6. Продление срока делегирования доменного имени.
Команда позволяет продлить срок делегирования уже существующего
доменного имени.
Синтаксис:
RENEW
domain:
until:
domain_name - доменное имя, срок делегирования которого требуется продлить.
until - год, до которого требуется продлить делегирование.
Вывод:
app_id: application ID
domain: domain_name доменное имя, срок делегирования которого продлён
status: 'OK-UNTIL' date новая дата окончания срока делегирования
Исключения:
503 Invalid attribute name
504 Missing required attribute
531 Authorization failed
541 Invalid attribute value
549 Command failed
555 Domain already renewed
Примечания:
В результате успешного выполнения этой команы срок делегирования
доменного имени продлевается на один год. Значение параметра until указывает
максимальный желательный год окончания делегирования. ВНИМАНИЕ: если в
параметре until указан год, для делегирования до которого требуется создать
две заявки, делегирование будет продлено только на один год. Например, срок
делегирования заканчивается в 2007 году, значение параметра until равно 2009.
В результате успешного выполнения команды срок делегирования будет продлён до
2008 года - будет создана только одна(!) заявка на продление.
Примеры:
1. Продление срока делегирования.
C:RENEW
C:domain: sample1.com.ua
C:until: 2007
C:.
S:200 Command completed successfully
S:app_id: 123123
S:domain: sample1.com.ua
S:status: OK-UNTIL 20070101011232
S:.
2. Неудачная попытка продления срока делегирования в .UA
C:RENEW
C:domain: sample2.ua
C:until: 2006
C:.
S:549 Command failed
S:Не надан_ ПАПЕРОВ_ коп_⌡ необх_дних документ_в
S:.
4.3.7. Прекращение делегирования доменного имени.
Команда предназначена для прекращения делегирования существующего
домена.
Синтаксис:
DEL DOMAIN
domain:
domain_name - доменное имя, делегирование которого требуется прекратить.
Вывод:
200 Command completed successfully
domain: wit-test13.com.ua
status: CANCELLED 20070620151853
domain: domain_name Доменное имя, делегирование которого прекращено
status: 'CANCELLED' date дата прекращения делегирования
Исключения:
504 Missing required attribute
531 Authorization failed
541 Invalid attribute value
Примеры:
1. Отмена делегирования в .COM.UA.
C:DEL DOMAIN
C:domain: sample.com.ua
C:.
S:200 Command completed successfully
S:domain: sample.com.ua
S:status: CANCELLED 20050212012323
S:.
4.3.8. Переделегирование доменного имени другому Регистранту.
Команда предусмотрена для передачи прав (переделегирования) доменного
имени другому Регистранту.
Синтаксис:
REDELEGATE
domain:
admin-c: Сетевой идентификатор нового регистранта доменного имени
Вывод:
app_id: string
status: 'DEFERRED'
accepted: date
или
domain: domain_name переделегированное доменное имя
status: string date статус записи о переделегированном доменном имени
admin-c: nic_handle сетевой идентификатор нового регистранта доменного имени
Исключения:
504 Missing required attribute
531 Authorization failed
541 Invalid attribute value
542 Invalid old value for an attribute
Примечания:
Записи с регистрационными данными, на которые осуществляется ссылка в
параметрах этой процедуры, должны быть созданы до её использования. Если на
момент выполнения процедуры согласие текущего регистранта на перевод этого
доменного имени не зарегистрировано, то создаётся заявка и её обработка
откладывается; иначе - вносятся запрошенные изменения.
Примеры:
1. Переделегирование домена с зарегистрированным ранее согласием текущего регистранта.
C:REDELEGATE
C:domain: sample1.com.ua
C:admin-c: C-UANIC
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:admin-c: C-UANIC
S:status: OK-UNTIL 20080201235839
S:.
2. Инициализация переделегирования (при отсутствии зарегистрированного
согласия текущего регистранта домена).
C:REDELEGATE
C:domain: sample2.com.ua
C:admin-c: C-UANIC
C:.
S:200 Command completed successfully
S:app_id: 121212
S:accepted:200503144638
S:status: DEFERRED
S:Не отримано ПАПЕРОВО⌠ коп_⌡ згоди ре≤странта на переделегування
S:.
4.3.9. Разрешение или запрет перевода доменного имени.
Команда предназначена для удовлетворения либо отмены запроса на перевод
доменного имени к другому Регистратору.
Синтаксис:
TRANSFER
app_id:
approve: (['Y']|'N')
app_id - идентификатор заявки на перевод доменного имени
approve - разрешить (Y) или запретить (N) перевод доменного имени
Вывод:
domain: domain_name Доменное имя, переведенное на обслуживание
другому регистратору
mnt-by: nic_handle Сетевой идентифкатор нового регистратора
changed: nic_handle date Сетевой идентификатор автора последних изменений
и дата их внесения
Примечания:
Доменное имя может быть переведено на сопровождение другому
регистратору
Исключения:
503 Invalid attribute name
504 Missing required attribute
507 Invalid command format
531 Authorization failed
537 Transfer reply already registered
541 Invalid attribute value
Примеры:
1. Разрешить перевод доменного имени.
C:TRANSFER
C:app_id: 121212
C:approve: Y
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:mnt-by: D-UANIC
S:changed: B-UANIC 20050223130017
S:.
2. Запретить перевод доменного имени.
C:TRANSFER
C:app_id: 121221
C:approve: N
C:.
S:200 Command completed successfully
S:domain: sample2.com.ua
S:mnt-by: A-UANIC
S:changed: A-UANIC 20040615173806
S:.
4.3.10. Запрос перевода доменного имени от другого Регистратора.
Команда используется для создания запроса на перевод доменного имени на
обслуживание от другого Регистратора.
Синтаксис:
REQUEST
domain:
domain - доменное имя, сопровождаемое другим регистратором,
запрос на сопровождение которого оформляется.
Вывод:
app_id: string Идентификатор заявки
operation: 'REQUEST'
domain: domain_name Доменное имя
status: 'SUSPENDED'
accepted: date Дата постановки заявки в очередь
reason: 'APPROVE_WAIT'
Исключения:
541 Invalid attribute value
534 Domain name has not been flagged for transfer - можно запросить на
сопровождение только несопровождаемое доменное имя
536 Domain already flagged for transfer
Примеры:
C:REQUEST
C:domain: sample3.com.ua
C:.
S:processed: warning
S:app_id: 121212
S:operation: REQUEST
S:domain:sample3.com.ua
S:status: SUSPENDED
S:accepted:200503144638
S:reason: APPROVE_WAIT
S:.
4.3.11. Создание записи о сервере имён.
Команда позволяет создать запись о сервере имён.
Синтаксис:
ADD NS
nameserver:
ip-address: ip-адрес сервера имён
Вывод:
NS_OBJECT
Исключения:
503 Invalid attribute name
504 Missing required attribute
507 Invalid command format
531 Authorization failed
540 Attribute value is not unique
541 Invalid attribute value
Примечания:
Регистратор может добавить запись о сервере имён с именем хоста,
принадлежащим сопровождаемому публичному домену, только если он сопровождает
охватывающее доменное имя. Например, он не сможет добавить запись о сервере
имён a.b.com.ua, если не сопровождает доменное имя b.com.ua (или если доменное
имя b.com.ua не зарегистрировано).
Примеры:
1. Регистрация сервера имён.
C:ADD NS
C:nameserver: ns1.sample.com.ua
C:ip-address: 1.2.3.4
C:.
S:200 Command completed successfully
S:nameserver: NS1.SAMPLE.COM.UA
S:ip-address: 1.2.3.4
S:.
4.3.12. Просмотр регистрационной информации о сервере имён.
Команда предназначена для вывода информации о зарегистрированном сервере
имён.
Синтаксис:
CHECK NS
nameserver:
hostname - имя сервера имён, регистрационная информация о котором
запрашивается
Вывод:
hostname: domain_name имя сервера имён
ip-address: ip_address ip-адрес сервера имён
source: 'UANIC'
Исключения:
503 Invalid attribute name
Примеры:
1. Просмотр регистрационной информации о сервере имён.
C:CHECK NS
C:nameserver: ns1.com.ua
C:.
S:213 Name server not available
S:nameserver: NS1.COM.UA
S:ip-address: 1.2.3.4
S:.
2. Попытка просмотра информации о незарегистрированном сервере имён.
C:CHECK NS
C:nameserver: ns1.com.uf
C:.
S:212 Name server available
S:.
4.3.13. Переименование сервера имён.
Команда даёт возможность изменить имя уже зарегистрированно сервера имён.
Синтаксис:
RENAME NS
nameserver: Текущее имя сервера имён
rename: Новое имя сервера имён
Вывод:
nameserver:
ip-address:
Исключения:
531 Authorization failed
540 Attribute value is not unique
541 Invalid attribute value
Примечания:
Если сервер имён принадлежит сопровождаемому публичному домену, то
регистратор может вносить в него изменения только в случае, если он
сопровождает охватывающе доменное имя. Например, он не сможет изменить запись о
сервере имён a.b.com.ua, если не сопровождает доменное имя b.com.ua.
4.3.14. Изменение ip-адреса в записи о сервере имён.
Команда даёт возможность изменить ip-адрес в записи об уже
зарегистрированно сервере имён.
Синтаксис:
MOD NS
nameserver:
ip-address: ip-адрес сервера имён
Вывод:
NS_OBJECT
Исключения:
531 Authorization failed
541 Invalid attribute value
Примечания:
Если сервер имён принадлежит сопровождаемому публичному домену, то
регистратор может вносить в него изменения только в случае, если он сопровождает
охватывающе доменное имя. Например, он не сможет изменить запись о сервере имён
a.b.com.ua, если не сопровождает доменное имя b.com.ua.
4.3.15. Удаление записи о сервере имён.
Команда используется для удаления существующей записи о сервере имён.
Синтаксис:
DEL NS
nameserver: Имя сервера имён
Исключения:
531 Authorization failed
532 Domain names linked with name server
541 Invalid attribute value
Примечания:
Если обнаруживается, что сервер имён используется в какой-либо записи о
доменном имени, команда завершается ошибкой. Регистратор должен выполнить
команду по изменению технической информации в записи о доменном имени
(MODTECH), исключив сервер имён из списка серверов имён; затем - вернуться к
выполнению этой команды.
Примеры:
1. Удаление записи о сервере имён.
C:DEL NS
C:nameserver: ns1.com.ua
C:.
S:200 Command completed successfully
S:.
2. Неудачная попытка удаления записи о сервере имён.
C:DEL NS
C:nameserver: ns2.com.ua
C:.
S:532 Domain names linked with name server
S:.
4.3.16. Просмотр регистрационной информации о лице.
Команда выводит информацию о регистрационных данных (nic-handle)
зарегистрированного лица.
Синтаксис:
CHECK PERSON
nic-hdl: Сетевой идентификатор записи о лице
Вывод:
nic-hdl: nic_handle сетевой идентификатор
(person: string фамилия, имя, отчество частного лица
|organization:) string наименование организации
address: string номер квартиры (офиса), улица, номер дома
address: string населённый пункт, район, область
address: string почтовый индекс, страна
*[phone:] string номер телефона (для organization - 1*phone)
*[fax:] string номер факса
e-mail: email адрес электронной почты
*[remark:] string примечание
changed: nic_handle date сетевой идентификатор автора последних изменений
записи о лице и дата этих изменений
source: 'UANIC'
Исключения:
541 Invalid attribute value
Примеры:
1. Просмотр регистрационной информации о лице.
C:CHECK PERSON
C:nic-hdl: AA-UANIC
C:.
S:215 UANIC not available
S:nic-hdl: AA-UANIC
S:person: Vasiliy Pupkin
S:address: ap.33, vul.Kashtanova, 1-A
S:address: s. Puzyrki, Obukhivskyj r-n, Kyivska obl.
S:address: 12345, UKRAINE
S:phone: 12-12-12
S:fax: 12-12-13
S:e-mail: vasya@pupkin.ua
S:remark: example
S:changed: UARR-UANIC 20041212035011
S:source: UANIC
S:.
2. Попытка просмотра информации о незарегистрированном лице.
C:CHECK PERSON
C:nic_handle: BB-UANIC
C:.
S:214 UANIC available
S:.
4.3.17. Поиск заявок, находящихся в очереди.
Команда позволяет просмотреть заявки Регистратора, находящиеся в
очереди администратора публичного домена. Можно получить список всех заявок
в сокращённой форме или просмотреть детальную информацию о заявке по номеру
или доменному имени.
Синтаксис:
CHECK APP
(
domain: ( FQDN | % ) доменное имя или весь список
|
app_id: номер заявки
)
Вывод:
1-й вариант:
app_id: номер заявки
operation: тип запрошенной операции
domain: FQDN доменное имя
2-й вариант:
app_id: string Идентификатор заявки
operation: string Операция, затребованная заявкой
domain: domain_name Доменное имя
status: string Статус заявки
accepted: date Дата постановки заявки в очередь
admin-c: nic_handle Сетевой идентификатор Регистранта
1*tech-c: nic_handle Сетевой идентифкатор технического контакта
2*nserver: domain_name hostname сервера имён
reason: string Причина, по которой заявка не обработана
Исключения:
531 Authorization failed
541 Invalid attribute value
Примечания:
В зависимости от операции, затребованной заявкой, и публичного домена,
которому принадлежит доменное имя, вывод команды может отличаться. Например, для
заявки с операцией REQUEST нет необходимости в большинстве полей. Если
подразумевается возврат нескольких заявок (при запросе по имени), они
разделяются друг от друга пустой строкой (без точки). Просмотр/поиск уже
обработанных заявок не реализован.
Примеры:
1. Просмотр заявки по её идентификатору.
C:CHECK APP
C:app_id: 12345
C:.
S:200 Command completed successfully
S:app_id: 12345
S:operation: REQUEST
S:domain: sample1.ua
S:accepted: 20050301215348
S:status: DEFERRED
S:reason: Не отримано згоди поточного ре≤стратора
S:.
2. Попытка просмотра заявки, отсутствующей в очереди.
C:CHECK APP
C:domain: sample.com.ua
C:.
S:200 Command completed successfully
S:.
3. Просмотр всех заявок.
C:CHECK APP
C:domain: %
C:.
S:200 Command completed successfully
S:app_id: 123
S:operation: CHANGE ADMIN-C
S:domain: BAT-MAN.KIEV.UA
S:
S:app_id: 234
S:operation: REQUEST
S:domain: ANGIOL.KIEV.UA
S:.
4.3.18. Отмена удовлетворённой заявки.
Команда позволяет отменить удовлетворённую заявку на продление срока
делегирования. В результате выполнения команды запись о доменном имени будет
возвращена в то состояние, в котром она находилась непосредственно перед
удовлетворением отменяемой заявки.
Синтаксис:
CANCEL APP
app_id: Идентификатор удовлетворённой заявки
Вывод:
DOMAIN_OBJECT
Исключения:
531 Authorization failed
541 Invalid attribute value
Примечания:
Заявка не может быть отменена, если выполняется одно из условий: после
неё была удовлетворена заявка на то же доменное имя; установленный для
публичного домена срок, в течение которого можно отменять заявки, прошёл;
заявка была удовлетворена в отличном от текущего отчётном периоде. Номер
отменяемой заявки регистратор получает из источника, зависящего от способа
размещения заявки: отчёт разбора письма; ответ RRP-сервера или http-страница.
Вывод команды в части доменного объекта зависит от публичного домена.
Примеры:
1. Отмена заявки на продление срока делегирования.
C:CANCEL APP
C:app_id: 123123
C:.
S:200 Command completed successfully
S:domain: sample1.com.ua
S:status: OK-UNTIL 20080301000000
...
S:changed: A-UANIC 20070628135628
S:.
4.3.19. Удаление необработанной заявки из очереди.
Команда предоставляет возможность удалить ещё необработанную заявку из
очереди администратора публичного домена.
Синтаксис:
DEL APP
app_id: Идентификатор заявки
Исключения:
531 Authorization failed
541 Invalid attribute value
Примеры:
1. Удаление заявки из очереди.
C:DEL APP
C:app_id: 123123
C:.
S:200 Command completed successfully
S:.
4.3.20. Получение списка заявок на перевод сопровождаемых доменных имён.
Команда позволяет получить список заявок на перевод сопровождаемых
доменных имён к другому Регистратору.
Синтаксис:
LISTREQS
Вывод:
*[
app_id: string Идентификатор заявки на перевод
domain: domain_name Доменное имя, перевод которого запрашивается
status: string date Статус записи о доменном имени и дата статуса
admin-c: nic_handle Сетевой идентификатор регистранта запрашиваемого
доменного имени
mnt-by: nic_handle Сетевой идентификатор регистратора, запросившего
перевод доменного имени
accepted: date Дата размещения запроса на перевод
]
Примечания:
Выводимые заявки разделяются пустой строкой (без точки).
Примеры:
1. Просмотр запросов на перевод доменного имени.
C:LISTREQS
C:.
S:200 Command completed successfully
S:app_id: 121212
S:domain: sample1.com.ua
S:status: OK-UNTIL 20080212234536
S:admin-c: A-UANIC
S:mnt-by: D-UANIC
S:accepted: 20070422103451
S:
S:app_id: 121221
S:domain: sample2.com.ua
S:status: HOLD-SINCE 20070323201221
S:admin-c: A-UANIC
S:mnt-by: C-UANIC
S:accepted: 20070428091853
S:.
4.3.21. Завершение подключения.
Команда завершает соединение с сервером.
Синтаксис:
QUIT
Пример:
C:QUIT
C:.
S:220 Command completed successfully. Server closing connection
S:.
5. Коды ответов сервера.
Сеанс связи между клиентом и сервером представляет собой последовательный
обмен сообщениями. Каждая команда, запрашиваемая клиентом, должна быть
обработана сервером, который должен вернуть код ответа для определения
успешности выполнения команды или ошибочных условий. Успешность выполнения
означает, что команда выполнена безошибочно. Ошибочность выполнения означает,
что система не может выполнить команду в том виде, как она подана. Сбой может
быть вызван ошибками синтаксиса, сематики, данных или системы. В этом разделе
перечислены все коды ответов сервера RRP.
200 Command completed successfully
Ответ об успешном завершении для большинства команд RRP.
210 Domain name available
Ответ об успешном завершении команды CHECK DOMAIN для незарегистрированного
доменного имени.
211 Domain name not available
Ответ об успешном завершении команды CHECK DOMAIN для зарегистрированного
доменного имени.
212 Name server available
Ответ об успешном завершении команды CHECK NS для незарегистрированного сервера
имён.
213 Name server not available
Ответ об успешном завершении команды CHECK NS для зарегистрированного сервера
имён.
214 UANIC available
Ответ об успешном завершении команды CHECK PERSON для незарегистрированной
записи о лице.
215 UANIC not available
Ответ об успешном завершении команды CHECK PERSON для зарегистрированной
записи о лице.
220 Command completed successfully. Server closing connection
Ответ об успешном завершении команды QUIT.
420 Command failed due to server error. Server closing connection
Временная ошибка сервера привела к неудачному завершению команды RRP и
завершению сеанса. Для продолжения работы требуется установить новый сеанс.
421 Command failed due to server error. Client should try again
Временная ошибка сервера привела к неудачному завершению команды RRP.
Следующая попытка выполнить команду может завершиться успешно.
500 Invalid command name
Указанная команда не была распознана как команда RRP, поддерживаемая сервером.
503 Invalid attribute name
Указанный параметр не был распознан как поддерживаемый параметр команды RRP.
504 Missing required attribute
Не был указан обязательный параметр команды RRP.
507 Invalid command format
Допущена ошибка в структуре или синтаксисе команды RRP.
520 Server closing connection. Client should try opening new connection
Сервер завершил сеанс и оборвал соединение по таймауту.
521 Too many sessions open. Server closing connection
Достигнуто предельное значение соединений.
530 Authentication failed
Указаны неправильные имя пользователя и (или) пароль.
531 Authorization failed
Пользователь не имеет полномочий на выполнение команды с указанными значениями
параметров.
532 Domain names linked with name server
Сервер имён указан в записях о доменных именах, поэтому его нельзя удалить.
Сначала нужно внести изменения в записи о доменных именах, устранив ссылку на
этот сервер имён.
533 Domain name has active name servers
Доменное имя используется активными серверами имён, поэтому его нельзя удалить.
Сначала нужно внести изменения в звписи о доменных именах, устранив ссылки на
сервера имён, являющиеся дочерними по отношению к удаляемому доменному имени.
534 Domain name has not been flagged for transfer
Регистратор пытается запросить перевод сопровождаемого им же доменного имени
или перевести доменное имя, запрос на которое не поступал.
535 Restricted IP address
IANA запрещает использование некоторых диапазонов IP адресов для нормального
использования. Регистратор пытается использовать IP адрес из такого диапазона.
536 Domain already flagged for transfer
Регистратор пытается запросить перевод доменного имени, запрос на перевод
которого уже зарегистрирован.
540 Attribute value is not unique
Указанное значени атрибута не явлется уникальным в пределах регистрационной
системы. Например, регистратор пытается делегировать уже делегированное
доменное имя, зарегистрировать уже зарегистрированные сервер имён или запись о
лице. Также такая ошибка возникает при попытке зарегистрировать доменное имя
с несколькими одинаковыми значениями однотипных атрибутов, например, серверов
имён или технических контактов.
541 Invalid attribute value
Указанное значение атрибута не допустимо в контексте команды. Например,
регистратор запрашивает отмену несуществующей заявки
542 Invalid old value for an attribute
Регистратор пытается переделегировать доменное имя текущему же регистранту.
547 Invalid command sequence
Попытка выполнить команду, отличную от SESSION OPEN, при неустановленном
сеансе.
549 Command failed
В результате выполнения команды нарушаются правила публичного домена. Этот код
ответа сопровождается детальным сообщением.
552 Domain status does not allow for operation
Попытка внести изменения в запись о доменном имени со статусом HOLD-SINCE.
Сначала необходимо выполнить RENEW.
554 Domain already registered
Доменное имя уже делегировано.
555 Domain already renewed
Делегирование доменного имени продлено до указанного срока и выполняется
попытка продления.
In net UA