Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2

Создание ЭП

Створення ЕП


Назва операціїПриміткаНазвание операцииПримечания
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId".
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії
5Создать ЭП
6Получить данные ЭПБлокирующая (синхронная) операция.
7Удалить сессиюВидалити сесію

Пример создания ЭП для текстовых данных (Java, Maven, Cipher Signer Server): https://github.com/stokipny/sjwsa-singer-server-client 

...

Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).


Название элементаНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесію Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId". 
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії
5Создать ЭП
6Получить результат создания ЭПНеблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания ЭП.
7Получить данные ЭПБлокирующая (синхронная) операция.
8Удалить сессиюВидалити сесію

Создание множественной встроенной ЭП


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные ЭП

В качестве данных ЭП должна быть загружена ранее созданная встроенная ЭП.
Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.

3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId".
Для параметра "dataToSignQualifier" должно быть установлено значение "alreadySigned".
Для параметра "signatureType" должно быть установлено значение "attached".
Для параметр "duplicateSign" должно быть установлено значение "true",
если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом.
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії
5Создать ЭП
6Получить данные ЭПБлокирующая (синхронная) операция.
7Удалить сессиюВидалити сесію

Создание множественной открепленной ЭП


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными
3Загрузить данные ЭП

В качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП.
Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.

4Установить параметры сессииВстановити параметри сесії

Должен быть указан параметр "caId".
Для параметра "dataToSignQualifier" должно быть установлено значение "alreadySigned".
Для параметра "signatureType" должно быть установлено значение "detached".
Для параметр "duplicateSign" должно быть установлено значение "true",
если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом.

5Загрузить ключевой Завантажити ключовий контейнер сессиисесії
6Создать ЭП
7Получить данные ЭПБлокирующая (синхронная) операция.
8Удалить сессиюВидалити сесію

Создание мобильной ЭП


Название операцииНазва операції
ПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
3Установить параметры сессииВстановити параметри сесії

Поддерживаемые параметры: "signatureType", "cadesType".

4Получить список поддерживаемых ПУМЭППо результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 5-6.
5Получить список профилей владельца ключейПо результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 6.
6Создать мобильную ЭП
7Получить данные мобильной ЭПБлокирующая (синхронная) операция.
8Удалить сессиюВидалити сесію

Создание мобильной ЭП с контролем состояния


Название операцииНазва операції
ПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
3Установить параметры сессииВстановити параметри сесіїПоддерживаемые параметры: "signatureType", "cadesType".
4Получить список поддерживаемых ПУМЭППо результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 5-8.
5Получить список профилей владельца ключейПо результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 6.
6Создать мобильную ЭП
7Получить результат создания мобильной ЭПНеблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания мобильной ЭП.
8Получить данные мобильной ЭПБлокирующая (синхронная) операция.
9Удалить сессиюВидалити сесію

Создание множественной встроенной мобильной ЭП


Название операцииНазва операції
ПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные ЭПВ качестве данных ЭП должна быть загружена ранее созданная встроенная ЭП.
Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
3Установить параметры сессииВстановити параметри сесії

Поддерживаемые параметры: "signatureType", "cadesType", "dataToSignQualifier".
Для параметра "dataToSignQualifier" должно быть установлено значение "alreadySigned".

4Получить список поддерживаемых ПУМЭППо результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 5-6.
5Получить список профилей владельца ключейПо результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 6.
6Создать мобильную ЭП
7Получить данные мобильной ЭПБлокирующая (синхронная) операция.
8Удалить сессиюВидалити сесію

Создание множественной открепленной мобильной ЭП


Название операцииНазва операції
ПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными
3Загрузить данные ЭПВ качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП.
Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
4Установить параметры сессииВстановити параметри сесії

Поддерживаемые параметры: "signatureType", "cadesType", "dataToSignQualifier".
Для параметра "dataToSignQualifier" должно быть установлено значение "alreadySigned".

5Получить список поддерживаемых ПУМЭППо результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 6-7.
6Получить список профилей владельца ключейПо результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 7.
7Создать мобильную ЭП
8Получить данные мобильной ЭПБлокирующая (синхронная) операция.
9Удалить сессиюВидалити сесію

Создание ЭП с ключами из Шифр-HSM-Site


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
3Установить параметры сессииВстановити параметри сесії
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії

В параметре keyStoreUri должен быть указан URI токена.

Тестовый токен:

5Создать ЭП
6Получить данные ЭПБлокирующая (синхронная) операция.
7Удалить сессиюВидалити сесію

Создание ЭП с ключами Depositsign


Название операцииНазва операціїПримечанияПримітка
1Получить токен доступа к API Depositsign и идентификатор хранилища ключей

Выполнить метод API Depositsign: /api/v1/{clientId}/auth/login

Тестовая учетная запись:

  • UserName: testDS
  • Password: testDS

Документация по API Depositsign: https://depositsign.com/swagger-api-doc

2Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
3Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
4Установить параметры сессииВстановити параметри сесії
5Загрузить ключевой Завантажити ключовий контейнер сессиисесіїВ параметре keyStoreUri должен быть указан URI хранилища ключей (токена), получаем значение "KeyName" с  первого запроса "Получить токен доступа к API Depositsign и идентификатор хранилища ключей".
В параметре bearerToken должен быть указан токен доступа к API Depositsign.
6Создать ЭП
7Получить данные ЭПБлокирующая (синхронная) операция.
8Удалить сессиюВидалити сесію

Проверка ЭП


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными
3Загрузить данные ЭПМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными
4Установить параметры сессииВстановити параметри сесії
5Проверить ЭП
6Получить результат проверки ЭПБлокирующая (синхронная) операция.
7Удалить сессиюВидалити сесію

Если после проверки прикрепленной ЭП необходимо получить (извлечь) подписанные данные, то следует использовать запрос Получение подписанных данных.

Пример проверки ЭП с извлечением для текстовых данных (Java, Maven, Cipher Signer Server): https://github.com/stokipny/sjwsa-singer-server-client 

Зашифровывание


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки.
3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId", "embedCertificateType".
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії
5Загрузить сертификаты получателейНеобходим как минимум один сертификат получателя зашифрованных данных.
Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки.
6Зашифровать
7Получить зашифрованные данныеБлокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки.
8Удалить сессиюВидалити сесію

Зашифровывание с контролем состояния

Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки.
3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId", "embedCertificateType".
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії
5Загрузить сертификаты получателейНеобходим как минимум один сертификат получателя зашифрованных данных.
Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки.
6Зашифровать
7Получить результат зашифрованияНеблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса зашифрования.
8Получить зашифрованные данныеБлокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки.
9Удалить сессию

...

Зашифрувати ключами з Шифр-HSM-Site

Возможно использовать в случае пакетной обработки большого количества ресурсов (файловМожливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки.
3Установить параметры сессииВстановити параметри сесії Должен быть указан параметр "embedCertificateType".
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії

В параметре keyStoreUri должен быть указан URI токена.

Тестовый токен:

5Загрузить сертификаты получателейЗавантажити сертифікати отримувачівНеобходим как минимум один сертификат получателя зашифрованных данных.
Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки.
6ЗашифроватьЗашифрувати
7Получить зашифрованные данныеОтримати зашифровані даніБлокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки.
8Удалить сессиюВидалити сесію

...


Розшифрувати


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки.
3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId".
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії
5РасшифроватьРозшифрувати
6Получить расшифрованные данныеОтримати розшифровані даніБлокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки.
7Удалить сессию

Расшифрование с контролем состояния

Розшифрувати з контролем стану


Назва операціїПриміткаНазвание операцииПримечания
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки.
3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId".
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії
5РасшифроватьРозшифрувати
6Получить Отримати результат расшифрованиярозшифруванняНеблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса расшифрования.
7Получить расшифрованные данныеОтримати розшифровані даніБлокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки.
8Удалить сессиюВидалити сесію

...


Розшифрувати ключами

...

з Шифр-HSM-Site


Название операцииНазва операціїПримечанияПримітка
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки.
3Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId".
4Загрузить ключевой Завантажити ключовий контейнер сессиисесії

В параметре keyStoreUri должен быть указан URI токена.

Тестовый токен:

5РасшифроватьРозшифрувати
6Получить расшифрованные данныеОтримати розшифровані даніБлокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки.
7Удалить сессию

Создание электронной метки времени

Створення електронної позначки часу


Назва операціїПриміткаНазвание операцииПримечания
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными
3Установить параметры сессииВстановити параметри сесіїПункты 3 и 4 могут выполняться в произвольном порядке.
4Создать ЭМВСтворити ЕПЧ
5Получить данные ЭМВОтримати дані ЕПЧБлокирующая (синхронная) операция.
6Удалить сессию

Создание электронной метки времени с контролем состояния

Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).

Створення електронної позначки часу з контролем стану

Можливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).


Назва операціїПримітка
1Створити сесіюНазвание элементаПримечания1Создать сессиюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.
3Установить параметры сессииВстановити параметри сесії
4Создать ЭМВСтворити ЕПЧ 
5Получить Отримати результат создания ЭМВстворення ЕПЧНеблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания ЭМВ.
6Получить данные ЭМВОтримання даних ЕПЧ Блокирующая (синхронная) операция.
7Удалить сессию

Проверка электронной метки времени

Перевірка електронної позначки часу


Назва операціїПриміткаНазвание операцииПримечания
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Загрузить данные сессииЗавантажити дані сесіїМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными
3Загрузить данные ЭМВЗавантажити дані ЕПЧМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными
4Установить параметры сессииВстановити параметри сесії
5Проверить ЭМВПеревірка ЕПЧ
6Получить Отримати результат проверки ЭМВперевірки ЕПЧБлокирующая (синхронная) операция.
7Удалить сессию

Получение данных о ключевом контейнере

Отримання даних про ключовий контейнер


Назва операціїПриміткаНазвание операцииПримечания
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId".
3Загрузить ключевой Завантажити ключовий контейнер сессиисесії
4Получение данных о ключевом контейнереОтримання даних про ключовий контейнер
5Удалить сессию

Получение данных сертификата

Отримання даних сертифіката


Назва операціїПриміткаНазвание операцииПримечания
1Создать сессиюСтворити сесіюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию.
2Установить параметры сессииВстановити параметри сесіїДолжен быть указан параметр "caId".
3Загрузить ключевой Завантажити ключовий контейнер сессиисесії
4Получение данных сертификатаОтримання даних сертифіката
5Удалить сессиюВидалити сесію