Спецификация сервиса СЭДО

от 09.12.2025 · разделов 147

О документе

Утверждён	Заместитель начальника Департамента сопровождения ведомственных информационных систем, П.В. Клинковская

Что изменилось

Версия 2.3 · 09.12.2025
Добавлен атрибут soap:fault
Версия 2.2 · 12.08.2025
Добавлен «Справочник состояния запроса»
Версия 2.1 · 29.07.2025
1. Для типа взаимодействия «МО» изменено наименование типа с «ogrn» на «ogrnmo», данное поле сделано универсальным в нем можно передавать либо ОГРН (13 цифр), либо ОГРНИП (15 цифр);
2. Обновлены примеры запросов и ответов в методах
3. Дополнен список кодов с ошибками

Ранние версии: ещё 1

Версия 2.0 · 07.08.2024
Сформирована новая версия спецификации при переходе на Единую цифровую платформу СФР

1.1 Назначение регламента

Документ регламентирует структуру и формат данных, необходимых для осуществления взаимодействия между участниками информационного взаимодействия и системой электронного документооборота (далее СЭДО).

Документ регламентирует обмен данными в электронном виде.

1.2 Стороны обмена

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

Система ЕИИС «СОЦСТРАХ»

Информационные системы медицинской организации (ИС МО), страхователя (АИС страхователя), получателя услуг (Личный кабинет Получателя услуг).

Сервис информационного взаимодействия

Сервис СЭДО реализует следующие функции:

Операция получения количества сообщений абонентом;

Операция получения количества сообщений оператором;

Операция запроса исходящего сообщения;

Операция отправки входящего сообщения.

Для осуществления данных функций в сервисе реализованы соответствующие методы.

GetCntMessage (операция получения количества сообщений абонентом);

GetCntMessageOрerator (операция получения количества сообщений оператором);

GetMessage (операция запроса сообщения);

PutMessage (операция отправки сообщения).

Путем вызова данных методов участники информационного взаимодействия отправляют и получают сведения от Фонда социального страхования.

Обмен сообщениями должен осуществляться в кодировке UTF-8.

При заполнении запроса необходимо руководствоваться следующим правилом:

Дата и Время c таймзоной указывается в формат типа данных Timestamp with local time zone, а именно YYYY-MM-DDThh:mm:ss(+|-)HH:MI.

Ниже приведено WSDL описание сервиса.

Возможна модификация структуры сообщения и xsd-схемы.

В случае непредусмотренной ошибки на сервере веб-сервис выдает ответ в стандартном поле Fault схемы http://www.w3.org/2003/05/soap-envelope/ SOAP-сообщения.

<wsdl:definitions xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:sedo="http://www.fss.ru/integration/types/sedo/v01" xmlns:fs="http://www.fss.ru/integration/ws/fault/v01" xmlns:com="http://www.fss.ru/integration/ws/common/sedo/v01" xmlns="http://www.fss.ru/integration/ws/gateway/sedo/v01" name="SedoGateway" targetNamespace="http://www.fss.ru/integration/ws/gateway/sedo/v01">

<wsdl:import location="https://sedo-gateway.uat.ecp/api/soap/SedoGateway?wsdl=Faults.wsdl" namespace="http://www.fss.ru/integration/ws/fault/v01"> </wsdl:import>

<wsdl:import location="https://sedo-gateway.uat.ecp/api/soap/SedoGateway?wsdl=SedoCommon.wsdl" namespace="http://www.fss.ru/integration/ws/common/sedo/v01"> </wsdl:import>

<wsdl:types>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:sedo="http://www.fss.ru/integration/types/sedo/v01" xmlns:fs="http://www.fss.ru/integration/ws/fault/v01" xmlns:com="http://www.fss.ru/integration/ws/common/sedo/v01" xmlns="http://www.fss.ru/integration/ws/gateway/sedo/v01">

<xs:import namespace="http://www.fss.ru/integration/types/sedo/v01" schemaLocation="https://sedo-gateway.uat.ecp/api/soap/SedoGateway?xsd=../xsd/fss/v01/sedo/Sedo.xsd"/>

</xs:schema>

</wsdl:types>

<wsdl:message name="PutMessageParam">

<wsdl:part element="sedo:putMessageRequest" name="param"> </wsdl:part>

</wsdl:message>

<wsdl:portType name="SedoGateway">

<wsdl:operation name="PutMessage">

<wsdl:documentation>

<xs:annotation>

<xs:documentation>Отправить сообщение в СФР. Операция с отложенной обработкой запроса</xs:documentation>

</xs:annotation>

</wsdl:documentation>

<wsdl:input message="PutMessageParam" name="param"> </wsdl:input>

<wsdl:output message="com:UuidResponse" name="result"> </wsdl:output>

<wsdl:fault message="fs:DecryptException" name="decryptException"> </wsdl:fault>

<wsdl:fault message="fs:InternalException" name="internalException"> </wsdl:fault>

<wsdl:fault message="fs:DigitalSignException" name="digitalSignException"> </wsdl:fault>

</wsdl:operation>

<wsdl:operation name="GetMessage">

<wsdl:documentation>

<xs:annotation>

<xs:documentation>Получить сообщение в СФР. Операция с моментальной обработкой запроса</xs:documentation>

</xs:annotation>

</wsdl:documentation>

<wsdl:input message="com:GetMessageParam" name="param"> </wsdl:input>

<wsdl:output message="com:GetMessageResponse" name="result"> </wsdl:output>

<wsdl:fault message="fs:DecryptException" name="decryptException"> </wsdl:fault>

<wsdl:fault message="fs:InternalException" name="internalException"> </wsdl:fault>

<wsdl:fault message="fs:DigitalSignException" name="digitalSignException"> </wsdl:fault>

</wsdl:operation>

<wsdl:operation name="GetCountMessages">

<wsdl:documentation>

<xs:annotation>

<xs:documentation>Получить количество сообщений. Операция с моментальной обработкой запроса</xs:documentation>

</xs:annotation>

</wsdl:documentation>

<wsdl:input message="com:GetCountMessagesParam" name="param"> </wsdl:input>

<wsdl:output message="com:GetCountMessagesResponse" name="result"> </wsdl:output>

<wsdl:fault message="fs:DecryptException" name="decryptException"> </wsdl:fault>

<wsdl:fault message="fs:InternalException" name="internalException"> </wsdl:fault>

<wsdl:fault message="fs:DigitalSignException" name="digitalSignException"> </wsdl:fault>

</wsdl:operation>

<wsdl:operation name="GetCountMessagesOperator">

<wsdl:documentation>

<xs:annotation>

<xs:documentation>Получить количество сообщений (для оператора). Операция с моментальной обработкой запроса</xs:documentation>

</xs:annotation>

</wsdl:documentation>

<wsdl:input message="com:GetCountMessagesOperatorParam" name="param"> </wsdl:input>

<wsdl:output message="com:GetCountMessagesResponse" name="result"> </wsdl:output>

<wsdl:fault message="fs:DecryptException" name="decryptException"> </wsdl:fault>

<wsdl:fault message="fs:InternalException" name="internalException"> </wsdl:fault>

<wsdl:fault message="fs:DigitalSignException" name="digitalSignException"> </wsdl:fault>

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="SedoGatewayBinding" type="SedoGateway">

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="PutMessage">

<wsdl:documentation>

<xs:annotation>

<xs:documentation>Отправить сообщение в СФР. Операция с отложенной обработкой запроса</xs:documentation>

</xs:annotation>

</wsdl:documentation>

<soap:operation soapAction="http://www.fss.ru/integration/ws/gateway/sedo/PutMessage/v01" style="document"/>

<wsdl:input name="param">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="result">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="decryptException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="internalException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="digitalSignException">

<soap:body use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="GetMessage">

<wsdl:documentation>

<xs:annotation>

<xs:documentation>Получить сообщение в СФР. Операция с моментальной обработкой запроса.</xs:documentation>

</xs:annotation>

</wsdl:documentation>

<soap:operation soapAction="http://www.fss.ru/integration/ws/gateway/sedo/GetMessage/v01" style="document"/>

<wsdl:input name="param">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="result">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="decryptException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="internalException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="digitalSignException">

<soap:body use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="GetCountMessages">

<wsdl:documentation>

<xs:annotation>

<xs:documentation>Получить количество сообщений. Операция с моментальной обработкой запроса</xs:documentation>

</xs:annotation>

</wsdl:documentation>

<soap:operation soapAction="http://www.fss.ru/integration/ws/gateway/sedo/GetCountMessages/v01" style="document"/>

<wsdl:input name="param">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="result">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="decryptException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="internalException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="digitalSignException">

<soap:body use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="GetCountMessagesOperator">

<wsdl:documentation>

<xs:annotation>

</xs:annotation>

</wsdl:documentation>

<soap:operation soapAction="http://www.fss.ru/integration/ws/gateway/sedo/GetCountMessagesOperator/v01" style="document"/>

<wsdl:input name="param">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="result">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="decryptException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="internalException">

<soap:body use="literal"/>

</wsdl:fault>

<wsdl:fault name="digitalSignException">

<soap:body use="literal"/>

</wsdl:fault>

</wsdl:operation>

</wsdl:binding>

<wsdl:service name="SedoGateway">

<wsdl:port binding="SedoGatewayBinding" name="SedoGatewayPort">

<soap:address location="https://sedo-gateway.uat.ecp/api/soap/SedoGateway"/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

3.1 Используемые стандарты и алгоритмы

Реализация механизма обеспечения юридической значимости сообщений, которыми обмениваются участники информационного взаимодействия и СФР, основано на следующих стандартах:

OASIS Web Service Security: SOAP Message Security 1.1

Стандарт описывает расширения для информационного обмена посредством протокола SOAP, применение которых позволяет обеспечить целостность передаваемых сообщений.

Электронно-цифровая подпись накладывается по стандарту XMLDSig, в соответствии OASIS Web Service Security: SOAP Message Security 1.1;

Для каноникализации используется метод C14N;

Для вычисления хэш-данных используется алгоритм ГОСТ Р 34.11-2012;

Для вычисления электронно-цифровой подписи используется алгоритм ГОСТ Р 34.10-2012.

3.2 Порядок взаимодействия

Для обеспечения юридически значимого документооборота необходимо использовать следующую ЭП (один из вариантов):

ЭП юридического лица;

ЭП юридического лица, выданная физическому лицу для следующих операций:

Операция запроса сообщения;

Операция отправки сообщения.

ЭП СФР подписывается любое ответное сообщение от сервиса СЭДО в результате информационного взаимодействия.

На стороне Системы производится проверка ЭП, наложенной на пакет направляемых сведений, для следующих операций:

Операция запроса сообщения;

Операция отправки сообщения.

3.3 Структура подписанного сообщения

Каркас сообщения определен стандартом SOAP и представляет собой следующий XML-документ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Header>

</soapenv:Header>

<soapenv:Body>

</soapenv:Body>

</soapenv:Envelope>

При этом, блок Header – содержит служебную информацию, в то время как блок Body – смысловые данные сообщения.

При наложении подписи в соответствии со стандартом OASIS Web Service Security: SOAP Message Security 1.1 внутри блока Header формируется структура данных, предназначенная для передачи информации об ЭП и uuid МЧД:

<wsse:Security soapenv:actor=""

xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">

<wsse:BinarySecurityToken

EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary"

ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3"

wsu:Id="">

</wsse:BinarySecurityToken>

(или <SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-512"/>

в зависимости от длины ключа сертификата, используемого пользователем)

</Transforms>

(или <DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-512"/>

в зависимости от длины ключа сертификата, используемого пользователем)

</Reference>

</SignedInfo>

<wsse:SecurityTokenReference>

<wsse:Reference URI=""/>

</wsse:SecurityTokenReference>

</KeyInfo>

<ns6:authorities

xmlns:ns6="urn:ru:fss:integration:types:signature:v01"

xmlns:ns7="http://www.fss.ru/integration/types/common/v01"

xmlns:ns8="urn:ru:fss:integration:types:mchd:v01">

<ns6:authority>

<ns8:powerOfAttorneyLink>

<ns8:uuid>...</ns8:uuid>

</ns8:powerOfAttorneyLink>

</ns6:authority>

</ns6:authorities>

</Object>

</Signature>

</wsse:Security>

Блок Security, принадлежащий пространству имен http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd, содержит в себе информацию, необходимую для проверки целостности сообщения и его отправителя. Одним из параметров блока является «actor», который должен быть заполнен http://fss.ru/recipient/[ИД абонента]. В ответном сообщении блок «actor» будет заполнен http://sedo.fss.ru/actor/fss/ca/[ОГРН ЦА СФР].

Блок Security состоит из следующих элементов:

BinarySecurityToken – содержит публичный сертификат пользователя в формате X509v3. Блок BinarySecurityToken имеет атрибут Id, принадлежащий пространству имен http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd, который должен быть проинициализирован уникальным значением в рамках SOAP-сообщения, по формату, аналогичному атрибуту actor;

Signature – содержит информацию об электронной подписи сообщения и состоит из следующих подблоков:

SignedInfo – содержит информацию о методе каноникализации, алгоритме хэширования, алгоритме генерации ЭЦП и ссылку на подписываемый блок данных;

Ссылка на подписываемые данные представлена блоком Reference, Содержит атрибут URI, значение которого должно соответствовать значению атрибута Id подписываемого блока данных. Значение URI должно быть по формату OGRN_[ОГРН абонента]. В ответном сообщении URI будет заполнено по формату OGRN_[ОГРН ЦА СФР].

Внутри блока Reference должны быть определены 2 элемента:

DigestMethod – определяющий алгоритм вычисления хэш суммы;

DigestValue – вычисленное значение хэш суммы от подписываемых данных.

SignatureValue – содержит рассчитанное значение ЭП;

KeyInfo – содержит ссылку на сертификат пользователя, который содержится в BinarySecurityToken и с помощью которого была рассчитана ЭП;

Object – стандартный элемент Object (см. https://www.w3.org/TR/xmldsig-core1/#sec-Object ), блок для встраивания машиночитаемой доверенности (МЧД). Используется элемент {urn:ru:fss:integration:types:signature:v01}authorities. Структура элемента {urn:ru:fss:integration:types:signature:v01}authorities позволяет указывать связи между подписанными блоками и МЧД в которых присутствуют полномочия для подписания связанного блока данных. Встраиваться может как весь документ машиночитаемой доверенности, так и ссылка на него.

Внутри блока Object определены:

Authority - блок МЧД;

powerOfAttorneyLink – ссылка на МЧД;

Uuid – идентификатор МЧД.

3.4 Порядок формирования электронной подписи

В сообщение добавляются объявления префиксов пространств имен. Префиксы можно определять по мере необходимости.

<soapenv:Envelope

xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"

xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"

xmlns:ds="http://www.w3.org/2000/09/xmldsig#">

.....

</soapenv:Envelope>

Проставляется атрибут wsu:Id=" " подписываемому элементу сообщения в блоке Body. В примере ниже подписывается весь блок Body.

<soapenv:Envelope>

<soapenv:Body wsu:Id="OGRN_0000000000013">

</soapenv:Body>

</soapenv:Envelope>

Происходит подготовка структуры для сохранения результатов.

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope ...>

<soapenv:Header>

<wsse:Security s:actor="http://fss.ru/recipient/0000000010">

<wsse:BinarySecurityToken />

<ds:Signature>

<ds:SignedInfo>

<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#" />

(или <SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-512"/>

в зависимости от длины ключа сертификата, используемого пользователем)

</ds:SignedInfo>

<ds:SignatureValue>...</ds:SignatureValue>

<ds:KeyInfo />

<ns6:authorities

xmlns:ns6="urn:ru:fss:integration:types:signature:v01"

xmlns:ns7="http://www.fss.ru/integration/types/common/v01"

xmlns:ns8="urn:ru:fss:integration:types:mchd:v01">

<ns6:authority>

<ns8:powerOfAttorneyLink>

<ns8:uuid>ddb98810-44c9-4441-918d-62e093cafa59</ns8:uuid>

</ns8:powerOfAttorneyLink>

</ns6:authority>

</ns6:authorities>

</Object>

</ds:Signature>

</wsse:Security>

</soapenv:Header>

<soapenv:Body wsu:Id="OGRN_0000000000013">

.......

</soapenv:Body>

</soapenv:Envelope>

В <wsse:BinarySecurityToken/> добавляются атрибуты форматов, сам сертификат и атрибут wsu:Id.

Формат сертификата должен соответствовать спецификации X.509 и быть представленным в формате Base64.

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope ...>

<soapenv:Header>

<wsse:Security soapenv:actor="http://fss.ru/recipient/0000000010">

<wsse:BinarySecurityToken

EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary"

ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3"

wsu:Id="http://fss.ru/recipient/0000000010">MIIDjjCCAz2... </wsse:BinarySecurityToken>

<ds:Signature>

<ds:SignedInfo>

.........

</ds:SignedInfo>

.........

</ds:Signature>

</wsse:Security>

</soapenv:Header>

.......

</soapenv:Envelope>

Добавляется ссылка на токен в раздел <ds:KeyInfo>.

Значение атрибута URI элемента wsse:Reference должно соответствовать значению атрибута wsu:Id элемента wsse:BinarySecurityToken с лидирующим знаком '#'.

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope ...>

<soapenv:Header>

<wsse:Security soapenv:actor="......">

<wsse:BinarySecurityToken ... wsu:Id="http://fss.ru/recipient/0000000010">... </wsse:BinarySecurityToken>

<ds:Signature>

<ds:SignedInfo>

.........

</ds:SignedInfo>

<ds:SignatureValue>.....</ds:SignatureValue>

<ds:KeyInfo>

<wsse:SecurityTokenReference>

<wsse:Reference URI="#http://fss.ru/recipient/0000000010" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3" />

</wsse:SecurityTokenReference>

</ds:KeyInfo>

</ds:Signature>

</wsse:Security>

</soapenv:Header>

.......

</soapenv:Envelope>

Добавляется ссылка на данные для подписи и параметры каноникализации.

Значение атрибута URI элемента ds:Reference должно соответствовать значению атрибута wsu:Id у подписываемого блока данных в элементе soapenv:Body с лидирующим знаком '#'.

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope ...>

<soapenv:Header>

<wsse:Security soapenv:actor="......">

<wsse:BinarySecurityToken ...>....</wsse:BinarySecurityToken>

<ds:Signature>

<ds:SignedInfo>

<ds:CanonicalizationMethod ... />

<ds:SignatureMethod ... />

<ds:Reference URI="#OGRN_0000000000013">

<ds:Transforms>

<ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#" />

</ds:Transforms>

<ds:DigestMethod

Algorithm="http://www.w3.org/2001/04/xmldsig-more#gostr3411" />

(или <DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-512"/> в зависимости от длины ключа сертификата, используемого пользователем)

<ds:DigestValue />

</ds:Reference>

.........

</ds:SignedInfo>

<ds:SignatureValue>.....</ds:SignatureValue>

<ds:KeyInfo>.........</ds:KeyInfo>

</ds:Signature>

</wsse:Security>

</soapenv:Header>

<soapenv:Body wsu:Id="OGRN_0000000000013">

.......

</soapenv:Body>

</soapenv:Envelope>

К подписываемому элементу и его потомкам, включая атрибуты, применяется каноникализация http://www.w3.org/2001/10/xml-exc-c14n#, на основе результата рассчитывается хэш по алгоритму ГОСТ Р 34.11-2012 и заносится в <ds:DigestValue> в формате Base64.

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope ...>

<soapenv:Header>

<wsse:Security soapenv:actor="......">

<wsse:BinarySecurityToken ...>....</wsse:BinarySecurityToken>

<ds:Signature>

<ds:SignedInfo>

<ds:CanonicalizationMethod ... />

<ds:SignatureMethod ... />

<ds:Reference URI="#OGRN_0000000000013">

<ds:Transforms>

<ds:Transform ... />

</ds:Transforms>

<ds:DigestMethod.... />

<ds:DigestValue>d7Q3878nvrGVpOI.....</ds:DigestValue>

</ds:Reference>

</ds:SignedInfo>

........

</ds:Signature>

</wsse:Security>

</soapenv:Header>

<soapenv:Body wsu:Id="OGRN_0000000000013">

.......

</soapenv:Body>

</soapenv:Envelope>

К элементу <ds:SignedInfo> и его потомкам, включая атрибуты, применяется каноникализация http://www.w3.org/2001/10/xml-exc-c14n#, на основе результата рассчитывается электронная подпись по алгоритму ГОСТ Р 34.10-2012 и заносится в <ds:SignatureValue> в формате Base64.

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope ...>

<soapenv:Header>

<wsse:Security soapenv:actor="......">

<wsse:BinarySecurityToken ...>....</wsse:BinarySecurityToken>

<ds:Signature>

<ds:SignedInfo>.........</ds:SignedInfo>

<ds:SignatureValue>ooXepzAw89CBIsbZ+g2oNFh.....</ds:SignatureValue>

<ds:KeyInfo>.........</ds:KeyInfo>

</ds:Signature>

</wsse:Security>

</soapenv:Header>

<soapenv:Body wsu:Id="OGRN_0000000000013">

.......

</soapenv:Body>

</soapenv:Envelope>

Шифрование данных

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

XML Encryption Syntax and Processing (W3C);

Спецификация, описывающая процедуру шифрования данных в формате XML, а так же итоговую структуру данных, в которую сохраняется зашифрованный документ.

Шифрование сессионного ключа и данных происходит по алгоритму ГОСТ Р 34.10-2001.

Требования шифрования применяются к следующим операциям:

Операция запроса сообщения;

Операция отправки сообщения.

При взаимодействии с СЭДО сообщения должны быть зашифрованы по указанным стандартам и алгоритмам. СЭДО принимает на вход зашифрованные сообщения, содержащее внутри себя смысловые сообщения с учетом обеспечения юридической значимости.

Таким образом, система при приеме таких сообщения сначала их дешифрует, а затем уже над расшифрованным компонентом производится проверка блока ЭП.

При отдаче сообщений данных методов из СЭДО они так же проходят двухэтапную обработку: сначала на них накладывается ЭП СФР, а затем они шифруются.

4.1 Порядок шифрования сообщения:

Создание случайного сессионного ключа.

При работе с ключами на алгоритме ГОСТ Р 34.10-2012 следует инициализировать генератор параметрами шифрования TK26Z (предоставляется провайдером).

Алгоритм шифрования GOST28147.

Шифрование сессионного ключа.

Создание шифратора для шифрования ключа. Применяется алгоритм трансформации "urn:ietf:params:xml:ns:cpxmlsec:algorithms:transport-gost2001". Создаётся эфемерный ключ, который согласуется с открытым ключом получателя, и формируется ключ согласования (на котором будет зашифрован сессионный ключ);

Создание блока KeyInfo с сертификатом;

Шифрование сессионного ключа происходит с помощью указанного асимметричного ключа (ГОСТ Р 34.10-2001). Сессионный ключ используется для шифрования данных и в свою очередь так же шифруется.

CALG_DH_EL_EPHEM - идентификатор алгоритма обмена ключей по Диффи-Хеллману на базе закрытого ключа эфемерной пары. Открытый ключ получается по ГОСТ Р 34.10-2001.

CALG_DH_GR3410_12_256_EPHEM - идентификатор алгоритма обмена ключей по Диффи-Хеллману на базе закрытого ключа эфемерной пары. Открытый ключ получается по ГОСТ Р 34.10-2012 (256 бит).

CALG_DH_GR3410_12_512_EPHEM - идентификатор алгоритма обмена ключей по Диффи-Хеллману на базе закрытого ключа эфемерной пары. Открытый ключ получается по ГОСТ Р 34.10-2012 (512 бит).

Шифрование документа.

Создание шифратора в режиме шифрования. Применяется алгоритм

"urn:ietf:params:xml:ns:cpxmlsec:algorithms:gost28147". Возможные параметры шифратора GostJCE/CBC/ISO10126Padding;

Добавление зашифрованного сессионного ключа, полученного ранее (добавление блока KeyInfo;

Шифрование документа на сессионном ключе.

4.2 Структура зашифрованного сообщения

Каркас сообщения определен стандартом SOAP и представляет собой следующий XML-документ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Header>

</soapenv:Header>

<soapenv:Body>

</soapenv:Body>

</soapenv:Envelope>

В блоке <soapenv:Header> исходного шифруемого сообщения необходимо добавить блок <X509Certificate>, содержащий публичный ключ сертификата отправителя. Структура сообщения для шифрования после этого будет выглядеть следующим образом:

<?xml version="1.0" encoding="UTF-8"?>

<soapenv:Envelope ...>

<soapenv:Header>

<wsse:Security soapenv:actor="......">

<wsse:BinarySecurityToken ...>....</wsse:BinarySecurityToken>

<ds:Signature>

<ds:SignedInfo>

<ds:CanonicalizationMethod ... />

<ds:SignatureMethod ... />

<ds:Reference URI="#OGRN_0000000000013">

<ds:Transforms>

<ds:Transform ... />

</ds:Transforms>

<ds:DigestMethod.... />

<ds:DigestValue>d7Q3878nvrGVpOI.....</ds:DigestValue>

</ds:Reference>

</ds:SignedInfo>

........

</ds:Signature>

</wsse:Security>

<X509Certificate">...</X509Certificate>

</soapenv:Header>

<soapenv:Body wsu:Id="OGRN_0000000000013">

.......

</soapenv:Body>

</soapenv:Envelope>

Для передачи зашифрованного сообщения в сервис СЭДО, необходимо, чтобы оно соответствовало структуре SOAP-сообщения, для этого зашифрованное сообщение помещаем внутрь блока Body нового сообщения SOAP. При этом в соответствии со спецификацией XML Encryption Syntax and Processing (W3C) внутри блока Body формируется следующая структура данных:

<xenc:EncryptedData xmlns:xenc="http://www.w3.org/2001/04/xmlenc#"

Type="http://www.w3.org/2001/04/xmlenc#Content" xmlns:ds="http://www.w3.org/2000/09/xmldsig#"

xmlns:sch="http://gost34.ibs.ru/WrapperService/Schema"

xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"

xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

<xenc:EncryptionMethod

Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gost28147" />

<ds:KeyInfo>

<xenc:EncryptedKey xmlns:xenc="http://www.w3.org/2001/04/xmlenc#">

<xenc:EncryptionMethod

Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:transport-gost2001" />

<ds:KeyInfo>

<ds:X509Data>

<ds:X509Certificate>…

</ds:X509Certificate>

</ds:X509Data>

</ds:KeyInfo>

<xenc:CipherData>

<xenc:CipherValue>..xenc:CipherValue>

</xenc:CipherData>

</xenc:EncryptedKey>

</ds:KeyInfo>

<xenc:CipherData>

<xenc:CipherValue>...xenc:CipherValue>

</xenc:CipherData>

</xenc:EncryptedData>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

EncryptionMethod – в качестве параметра содержит определение алгоритма шифрования;

KeyInfo – содержит информацию о секретном ключе, сгенерированном для данного информационного взаимодействия (CipherValue);

X509Certificate – публичный сертификат СФР, на котором были зашифрованы данные при направлении запросов в Фонд, или публичный сертификат пользователя, на котором были зашифрованы данные при формировании ответа в системе СФР на запрос пользователю;

CipherData – зашифрованное сообщение.

5.1.1 Описание метода

Метод предназначен для получения количества сообщений абонентом.

Время периодичности отправки запросов установлено в 15 секунд (возможны изменения). При отправке запроса в ответе добавлен http заголовок «access-control-max-age» указывающий информацию об установленном времени периодичности запросов, отображает значение времени в миллисекундах (пример: «access-control-max-age: 15000»).

Входное сообщение-запрос, направляемое абонентом, имеет следующий атрибутивный состав:

Диаграмма

Пространство имен

http://www.fss.ru/integration/types/sedo/v01

Тип

GetCntMessageRequest

Свойства

content	complex

Дочерние элементы

systemInfo interactionType recipientId org mo ins messageDate messageFrom messageTo

Аннотация

Для абонентов. Родительский элемент запроса для получения списка исходящих сообщений

Схема

Показать схему XSD

<xsd:element name="getCntMessageRequest" type="GetCntMessageRequest">
  <xsd:annotation>
    <xsd:documentation>Для абонентов. Родительский элемент запроса для получения списка исходящих сообщений
            </xsd:documentation>
  </xsd:annotation>
</xsd:element>

Дополнительное описание элементов:

systemInfo - информация о взаимодействующей по протоколу системе. Атрибутивный состав элемента представлен в Приложении А настоящего документа.

interactionType - тип взаимодействия (МО, страхователь, организация). Указывается значение из справочника типов взаимодействий (п.5.1).

recipientID - идентификатор абонента (регистрационный номер страхователя (ФСС/СФР), ОГРН МО). Значение зависит от указанного типа взаимодействия в теге interactionType. Таблица соответствий указана в п.5.3. Описание типа указано в Приложении А настоящего документа.

ogrnmo – универсально поле для заполнения либо ОГРН, либо ОГРНИП, используется только для типа взаимодействия «1-МО».

org – реквизиты абонента для взаимодействия по типу «Организация» (для типов сообщений 200-205 (МЧД), а так же иностранных представительств).

mo – реквизиты абонента для взаимодействия по типу «Медицинская организация». Поле «mo» не заполняется, в случае заполнения поля «recipientID».

ins - реквизиты абонента для взаимодействия по типу «Страхователь». Поле «ins» не заполняется, в случае заполнения поля «recipientID».

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

messageFrom – время формирования сообщения. В ответ возвращаются актуальные и архивные сообщения, сформированные с этого времени. Для передачи необходимо заполнить тег messageDate и messageTo.

messageTo - время формирования сообщения. В ответ возвращаются актуальные и архивные сообщения, сформированные до этого времени. Для передачи необходимо заполнить тег messageDate и messageFrom.

Выходное сообщение-ответ, направляемое СФР, имеет следующий атрибутивный состав:

Диаграмма

Пространство имен

http://www.fss.ru/integration/types/sedo/v01

Тип

MessageListResponseType

Свойства

content	complex

Дочерние элементы

result errorList

Аннотация

Родительский элемент ответа.

Схема

Показать схему XSD

<xsd:element name="messageListResponse" type="MessageListResponseType">
  <xsd:annotation>
    <xsd:documentation>
                Родительский элемент ответа.
            </xsd:documentation>
  </xsd:annotation>
</xsd:element>

Дополнительное описание элементов:

result - список исходящих сообщений. Атрибутивный состав элемента представлен в Приложении А настоящего документам.

errorList - сообщения об ошибках. Атрибутивный состав элемента представлен в Приложении А настоящего документа.

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

messageDate – дата и время создания сообщения.

5.1.2 Пример запроса

Возможна модификация структуры сообщения и xsd-схемы.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v01="http://www.fss.ru/integration/types/sedo/v01">

<soapenv:Header/>

<soapenv:Body>

<v01:getCntMessageRequest>

</systemInfo>

</v01:getCntMessageRequest>

</soapenv:Body>

</soapenv:Envelope>

5.1.3 Пример ответа

Возможна модификация структуры сообщения и xsd-схемы.

<soap:Envelope xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

<soap:Header>

<wsse:Security soap:actor="http://sedo.fss.ru/actor/fss/ca/1027739443236">

<ds:Signature>

<ds:SignedInfo>

<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>

<ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>

<ds:Reference URI="#OGRN_1027739443236">

<ds:Transforms>

<ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>

</ds:Transforms>

<ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>

<ds:DigestValue>ycCvNgAPXvkJkUV4JlSoXExET5u/3iRUkLGDRtubIQ4=</ds:DigestValue>

</ds:Reference>

</ds:SignedInfo>

<ds:SignatureValue>ywwYX4NUs6BdQ2ykWYDeL3O5ecsPFD8o0VYDcTDBK4FT2YAnKZobAJ8WYUnG93YNBH0m7npU/FMXFOX1cQuuCA==</ds:SignatureValue>

<ds:KeyInfo>

<wsse:SecurityTokenReference>

<wsse:Reference URI="#http://sedo.fss.ru/actor/fss/ca/1027739443236"/>

</wsse:SecurityTokenReference>

</ds:KeyInfo>

</ds:Signature>

MB8GA1UECQwY0KjQsNCx0L7Qu9C+0LLQutCwLCDQtC40MQswCQYDVQQGEwJSVTEV

MBMGA1UECAwM0JzQvtGB0LrQstCwMRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxDzAN

BgNVBAoMBtCh0KTQoDEYMBYGBSqFA2QBEg0xMDQ3Nzk3MDE5ODMwMRUwEwYFKoUD

ZAQSCjc3MTA1Njg3NjAxGTAXBgNVBAMMENCj0KYg0KHQpNCgIDIwMjQwHhcNMjUw

MzIxMDc0NzAwWhcNMjgwMzIxMDc0NzAwWjCB3jEiMCAGCSqGSIb3DQEJARYTbm8t

cmVwbHlAYmZ0Y29tLmNvbTEpMCcGA1UECQwg0JrRgNCw0YHQvdCw0Y8g0L/Qu9C+

0YnQsNC00YwsIDExCzAJBgNVBAYTAlJVMRUwEwYDVQQIDAzQnNC+0YHQutCy0LAx

FTATBgNVBAcMDNCc0L7RgdC60LLQsDEPMA0GA1UECgwG0JHQpNCiMRgwFgYFKoUD

ZAESDTExNDU0MTQzNDU3NDYxFTATBgUqhQNkBBIKODY3MDQ3NDI0MDEQMA4GA1UE

AwwHdWF0LWVjcDBmMB8GCCqFAwcBAQEBMBMGByqFAwICJAAGCCqFAwcBAQICA0MA

BECzSN8RbWwUODIiyxMF1THO/pqiDtjo6IsLNwTZBbKt5L7H1Kxem/bSKRHV/P+E

yWAhYRmHCVLVuQMl/Y4z3wN/gQkAMjk4RTAwMDGjggNUMIIDUDArBgNVHRAEJDAi

gA8yMDI1MDMyMTA2MTgzOFqBDzIwMjYwMzIxMDYxODM4WjAdBgNVHQ4EFgQULtXz

H+/cDqKokhmH+z3ur97XxPkwDgYDVR0PAQH/BAQDAgP4MB0GA1UdJQQWMBQGCCsG

AQUFBwMCBggrBgEFBQcDATAdBgUqhQNkbwQUDBJWaVBOZXQgUEtJIFNlcnZpY2Uw

DAYFKoUDZHIEAwIBATCCAQIGBSqFA2RwBIH4MIH1DELQodCa0JfQmCAiVmlQTmV0

IENTUCA0LjIiICAo0LLQsNGA0LjQsNC90YIg0LjRgdC/0L7Qu9C90LXQvdC40Y8g

MikMWNCf0YDQvtCz0YDQsNC80LzQvdGL0Lkg0LrQvtC80L/Qu9C10LrRgSBWaVBO

ZXQg0KPQtNC+0YHRgtC+0LLQtdGA0Y/RjtGJ0LjQuSDRhtC10L3RgtGAIDQMJtCh

0KQvMTI0LTM0MzMg0L7RgiA2INC40Y7Qu9GPIDIwMTgg0LMuDC3QodCkLzExOC0z

NTEwINC+0YIgMjUg0L7QutGC0Y/QsdGA0Y8gMjAxOCDQsy4wDAYDVR0TAQH/BAIw

ADBBBggrBgEFBQcBAQQ1MDMwMQYIKwYBBQUHMAKGJWh0dHA6Ly9jYS5wZnJmLnJ1

L3VjcGZyL3Vjc2ZyMjAyNC5jZXIwNgYDVR0fBC8wLTAroCmgJ4YlaHR0cDovL2Nh

LnBmcmYucnUvdWNwZnIvdWNzZnIyMDI0LmNybDCB9wYDVR0jBIHvMIHsgBTxa//P

kzCGNq9CBSuk8dC8kI0UVaGBwaSBvjCBuzEhMB8GA1UECQwY0KjQsNCx0L7Qu9C+

0LLQutCwLCDQtC40MQswCQYDVQQGEwJSVTEVMBMGA1UECAwM0JzQvtGB0LrQstCw

MRUwEwYDVQQHDAzQnNC+0YHQutCy0LAxDzANBgNVBAoMBtCh0KTQoDEYMBYGBSqF

A2QBEg0xMDQ3Nzk3MDE5ODMwMRUwEwYFKoUDZAQSCjc3MTA1Njg3NjAxGTAXBgNV

BAMMENCj0KYg0KHQpNCgIDIwMjSCEAHafnT5NhwwAATiKCmOAAEwHQYDVR0gBBYw

FDAIBgYqhQNkcQEwCAYGKoUDZHECMAoGCCqFAwcBAQMCA0EAJaD9yerCxtp+7Wlx

qFB+bKZdai9oyOcnO9dXublf15F01861k9Phm1VGhBGsr+qiyWNIACzdIU6REtj6

qGzC1g==</wsse:BinarySecurityToken>

</wsse:Security>

</soap:Header>

<soap:Body wsu:Id="OGRN_1027739443236">

<ns5:messageListResponse xmlns:ns2="http://www.fss.ru/integration/types/common/v01" xmlns:ns3="http://www.fss.ru/integration/types/fault/v01" xmlns:ns4="http://www.fss.ru/integration/types/organization/v01" xmlns:ns5="http://www.fss.ru/integration/types/sedo/v01">

<needConfirm>false</needConfirm>

</messageList>

<messageUuid>68a67f88-f47c-48b6-9541-68001adadc63</messageUuid>

<message>Широковещательное ТЕСТОВОЕ сообщение.

Срок окончания - 31.12.2025 год</message>

</broadcastMessage>

</broadcastMessageList>

</result>

</ns5:messageListResponse>

</soap:Body>

</soap:Envelope>

6.1.1 Описание метода

Метод предназначен для запроса количества сообщений оператором.

Входное сообщение-запрос, направляемое оператором, имеет следующий атрибутивный состав:

Диаграмма

Пространство имен

http://www.fss.ru/integration/types/sedo/v01

Тип

GetCntMessageOperatorRequest

Свойства

content	complex

Дочерние элементы

systemInfo interactionType operatorOgrn messageDate msgTimeFrom msgTimeTo

Аннотация

Для операторов. Родительский элемент запроса для получения списка исходящих сообщений

Схема

Показать схему XSD

<xsd:element name="getCntMessageOperatorRequest" type="GetCntMessageOperatorRequest">
  <xsd:annotation>
    <xsd:documentation>Для операторов. Родительский элемент запроса для получения списка исходящих сообщений
            </xsd:documentation>
  </xsd:annotation>
</xsd:element>

Дополнительное описание элементов:

operatorOgrn - идентификатор оператора (ОГРН). Описание типа указано в Приложении А настоящего документа.

messageDate - дата формирования сообщения. Если в атрибуте передается значение, то в ответ возвращаются как актуальные, так и архивные сообщения, предназначенные для пользователя.

msgTimeFrom – время формирования сообщения. В ответ возвращаются актуальные и архивные сообщения, сформированные с этого времени. Для передачи необходимо заполнить тег messageDate и msgTimeTo.

msgTimeTo - время формирования сообщения. В ответ возвращаются актуальные и архивные сообщения, сформированные до этого времени. Для передачи необходимо заполнить тег messageDate и msgTimeFrom.

При запросе списка сообщений с указанием interactionType равным «2» (страхователь), в ответе будет выводиться общий список сообщений:

по типу взаимодействия «2» (страхователь) абонентов, прямо подписанных на спец. оператора по рег. номеру страхователя,

по типу взаимодействия «3» (организация), которые были найдены системой по реквизитам страхователя, по точному соответствию ОГРН, ИНН, КПП.

При запросе списка сообщений с указанием interactionType равным «3» (организация), в ответе будет выводиться общий список сообщений:

по типу взаимодействия «3» (организация) абонентов, прямо подписанных на спец. оператора по реквизитам организации,

по типу взаимодействия «3» (организация), которые были найдены системой по подпискам по рег. номеру страхователя (по точному соответствию ОГРН, ИНН, КПП).

Выходное сообщение-ответ, направляемое СФР, имеет следующий атрибутивный состав:

Диаграмма

Пространство имен

http://www.fss.ru/integration/types/sedo/v01

Тип

MessageListResponseType

Свойства

content	complex

Дочерние элементы

result errorList

Аннотация

Родительский элемент ответа.

Схема

Показать схему XSD

<xsd:element name="messageListResponse" type="MessageListResponseType">
  <xsd:annotation>
    <xsd:documentation>
                Родительский элемент ответа.
            </xsd:documentation>
  </xsd:annotation>
</xsd:element>

Дополнительное описание элементов:

result - список исходящих сообщений. Атрибутивный состав элемента представлен в Приложении А настоящего документа,

errorList - сообщения об ошибках. Атрибутивный состав элемента представлен в Приложении А настоящего документа,

messageDate – дата и время создания сообщения.

6.1.2 Пример запроса

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v01="http://www.fss.ru/integration/types/sedo/v01">

<soapenv:Header/>

<soapenv:Body>

<v01:getCntMessageOperatorRequest>

</systemInfo>

</v01:getCntMessageOperatorRequest>

</soapenv:Body>

</soapenv:Envelope>

6.1.3 Пример ответа

Возможна модификация структуры сообщения и xsd-схемы.

<soap:Header>

<wsse:Security soap:actor="http://sedo.fss.ru/actor/fss/ca/1027739443236">

<ds:Signature>

<ds:SignedInfo>

<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>

<ds:SignatureMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34102012-gostr34112012-256"/>

<ds:Reference URI="#OGRN_1027739443236">

<ds:Transforms>

<ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>

</ds:Transforms>

<ds:DigestMethod Algorithm="urn:ietf:params:xml:ns:cpxmlsec:algorithms:gostr34112012-256"/>

<ds:DigestValue>bDWLi5mdUS1OpSq7lJcpCPbN/+slLtKgdW6saYbXrXU=</ds:DigestValue>

</ds:Reference>

</ds:SignedInfo>

<ds:SignatureValue>XfXzgeNnsp5Ct31LfmgA38RD8X1FgbT3LAlNiVsz7pxmxpHxpthl8YJ9oBhX+/sH1a6/T+ZgnNEJyULr0RJIxw==</ds:SignatureValue>