Описание формата пакета обмена с центром регистрации (стр. 1 )

Описание формата пакета обмена с центром регистрации

Общие сведения

Данный документ описывает документооборот и структуру транспортного сообщения, формируемого и передаваемого различными программными средствами со стороны партнеров, непосредственно абонента, либо центра регистрации.

Осуществление документооборота происходит через проведение транзакций – передачи от одного участника документооборота другому фиксированного набора документов, в согласованном формате, вместе с подписями под этими документами, сделанными от имени определенных участников документооборота.

Термины и определения

Абонент– абонент системы.

Агент – партнер, через которого осуществляется подключение абонентов.

Офис регистрации – центр обработки данных по подключению абонентов.

Пакет – набор логически связанных документов (в том числе и служебных), заверенных электронно-цифровой подписью, а также сопутствующая набору документов информация (файл-описатель, командный файл), объединенные в один архивный файл.

Осуществление документооборота

Документооборот состоит из нескольких основных неделимых этапов передачи информации между субъектами (транзакций). В рамках каждой транзакции формируется один транспортный пакет документов, представляющий из себя одинархивированный файл. Транспортный пакет содержит информацию, позволяющую провести контроль его целостности. В случае повреждения пакета при пересылке, пакет не будет обработан принимающим субъектом, а будет сгенерировано сообщение об ошибке. Документы в транспортном пакете, в том числе и служебные документы, передаются подписанными ЭЦП и в зашифрованном виде, а файл – описатель в открытом виде с ЭЦП, если в описании конкретного документооборота не оговорен иной вариант.

Участники документооборота

Информационное взаимодействие по обмену электронными документами с применением электронно-цифровой подписи, идущее по определенным правилам, называется документооборотом.

В ходе документооборота осуществляется взаимодействие между следующими типами участников документооборота:

Abonent – организация или физическое лицо, которое подключается к системе (идентифицируется глобальным уникальным идентификатором).

Agent – организация партнера, через которую осуществляется подключение абонента.

RegOffice – центр обработки данных, который осуществляет регистрацию абонентов в системе.

Типы содержимого

xml – данные в формате XML; p10 – документ в формате PKCS10; unknown – произвольные (бинарные) данные

Форматтранспортного сообщения (пакета)

В рамках каждой транзакции всех типов документооборота все файлы необходимых документов и их подписей пересылаются объединенными в один файл. Такой файл называется пакетом. При регистрации представляется с наименованием «regRequest» и расширением. zip.

На рисунке ниже приведена схема внутреннего устройства пакета.

Пакет представляет собой zip-архив, содержащий:

файл «packetDescription. xml» с описанием содержимого пакета в формате xml; архивные файлы с содержимым передаваемых документов: при регистрации, создаётся архивный файл (регистрационный пакет) с документом reqRequest; файлы с содержимым передаваемых подписей под каждым документом (по требованию).

Файлы с содержимым документов и подписей именуются с использованием универсальных уникальных идентификаторов по формату «<UUID>.bin».

Описание содержимого пакета

Файл с описанием содержимого пакета представляет собой xml-документ.

Корневой узел packet документа содержит следующие обязательные атрибуты:

version – версия формата описания пакета, в настоящем документе описана версия 2.0 формата; type – тип осуществляемого документооборота в соответствии с определенным списком типов документооборотов; id – универсальный уникальный идентификатор документооборота; date –дата и время формирования пакета; transaction – тип транзакции

Внутри узла пакет содержатся немножественные узлы sender(отправитель), recipient (получатель) со следующими обязательными атрибутами:

id– идентификатор участника документооборота; type – тип участника документооборота в соответствии с определенным списком типов участников.

В элементе sender описывается отправитель пакета. В элементе recipientописывается получатель пакета.

Дополнительно внутри узла packet в одном или нескольких дочерних узлах document перечисляются документы, передаваемые в этом пакете.

Узел документ имеет следующие обязательные атрибуты:

id – универсальный уникальный идентификатор документа; type – тип документа, передаваемого в составе Пакета; contentType – тип содержимого документа в соответствии с определенным списком типов содержимого; compressed – значение true или false, в зависимости от того, сжато или нет содержимое документа в пакете (сжатие документа выполняется перед шифрованием). encrypted – значение true или false, в зависимости от того, зашифровано или нет содержимое документа в пакете.

Содержимое всех подписей под документами в документообороте не шифруется.

Кроме того, узел document содержит необязательный дочерний немножественный узел content с атрибутом fileName, значением которого является имя файла (из набора файлов пакета) с содержимым описываемого документа. Узел содержимое может отсутствовать, если в транзакции передается лишь подпись под документом без содержимого документа.

Также внутри узла document в дочерних узлах signature перечисляются подписи, стоящие под документом.

Узел signature имеет следующие обязательные атрибуты:

fileName – имя файла (из набора файлов пакета) с содержимым описываемой подписи;

Файл с описанием содержимого пакета не шифруется.

Файл с описанием содержимого пакета подписывается сертификатом ЭЦП отправителя пакета.

Имя файла пакета

Пакет передается в виде файла с уникальным именем по формату<UUID>.zip

Пример имени файла пакета:

6b896bcfee824fd0bccee9211002757e. zip

Универсальные уникальные идентификаторы

Для идентификации типов документооборота, документов и для генерации имен файлов в пакете используются универсальные уникальные идентификаторы.

Используемые универсальные уникальные идентификаторы должны генерироваться согласно общим принципам формирования UUID, изложенным в открытом документе RFC 4122 (http://www. ietf. org/rfc/rfc4122.txt). Все современные операционные системы имеют встроенные средства или отдельные библиотеки для генерации универсальных уникальных идентификаторов согласно указанному стандарту.

Везде в настоящем протоколе используется представление универсальных уникальных идентификаторов в виде шестнадцатеричного числа из 32 разрядов, записанного в нижнем регистре.

Пример представления универсального уникального идентификатора:

7b7875ba8cbc4158a597b2a1d690eeb7

Объединение и сжатие файлов

Для объединения нескольких файлов в один пакет и для сжатия файлов используется формат zip-архива.

Типы документооборота

Каждый тип документооборота определяет:

набор транзакций, которые осуществляются в рамках этого типа документооборота (пока прорабатываются); типы документов, которые передаются в рамках этого типа документооборота; допустимые типы содержимого передаваемых документов.

Каждая транзакция определяет:

участника документооборота, отправляющего документы; участника документооборота, принимающего документы; типы документов, которые должны быть переданы в рамках этой транзакции; набор подписей, которые должны стоять под передаваемыми документами.

Описание конкретных типов документооборота и соответствующих транзакций приведены ниже.

Для осуществления автоматизированного взаимодействия офиса регистрации с абонентами и агентами предусмотрены следующие типы документооборота:

№ п/п	Наименование документооборота	Типы транзакции	Примечание
2	AbonentRegistration	«Request» «RegResponse»	Основной документооборот по регистрации и подключению абонента.

Примечание: Данный перечень типов документооборота может быть расширен в связи с изменением видов работ.

Документооборот «AbonentRegistration»        

Примечание: Документооборот AbonentRegistration производится между центром обработки данных (RegOffice) и организацией партнера(Agent), либо между центром обработки данных (RegOffice) и непосредственно абонентом(Abonent). В примере используется второй случай.

Наименование элемента. Приводится полное наименование элемента. Сокращенное наименование элемента. Приводится сокращенное наименование элемента. Сокращенные наименования могут записываться буквами и цифрами. Признак типа элемента. Может принимать следующие значения: "С" – сложный элемент (имеющий вложенные), "П" – простой элемент (не имеющий вложенных); А - атрибут. Если для определения элемента используется пользовательский тип данных, наименование типа данных (типового элемента) указывается в графе «Дополнительные сведения». Формат элемента. Формат1 представляется в условных обозначениях, которым соответствуют следующие значения: Т – символьная строка; N – числовое значение (целое или дробное).

Формат символьной строки указывается в виде Т(n-к) или T(=к), где n - минимальное количество знаков в строке, к – максимальное количество знаков, символ ”-” – разделитель, символ ”=” означает фиксированное количество знаков в строке. В случае, если минимальное количество знаков равно 0, формат имеет вид Т(0-к). В случае, если максимальное количество знаков неограниченно, формат имеет вид Т(n-). В случае, если элемент неопределённой длины, формат имеет вид Т

Формат числового значения указывается в виде N(m. к), где m – максимальное количество знаков в числе, включая знак (для отрицательного числа), целую и дробную часть числа без разделяющей десятичной точки, а k – максимальное число знаков дробной части числа. Если число знаков дробной части числа равно 0 (т. е. число целое), то формат числового значения имеет вид N(m).