Table of Contents | ||
---|---|---|
|
Создание ЭП
Створення ЕП
Назва операції | Примітка | Название операции | Примечания | |
---|---|---|---|---|
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 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная встроенная ЭП. |
3Установить параметры сессии | Встановити параметри сесії | Должен быть указан параметр "caId". Для параметра "dataToSignQualifier" должно быть установлено значение "alreadySigned". Для параметра "signatureType" должно быть установлено значение "attached". Для параметр "duplicateSign" должно быть установлено значение "true", если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом. |
4 | Загрузить ключевой Завантажити ключовий контейнер сессиисесії | |
5 | Создать ЭП | |
6 | Получить данные ЭП | Блокирующая (синхронная) операция. |
7Удалить сессию | Видалити сесію |
Создание множественной открепленной ЭП
Название операцииНазва операції | ПримечанияПримітка | |
---|---|---|
1Создать сессию | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
2Загрузить данные сессии | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными |
3 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП. |
4Установить параметры сессии | Встановити параметри сесії | Должен быть указан параметр "caId". |
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". |
4 | Получить список поддерживаемых ПУМЭП | По результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 5-6. |
5 | Получить список профилей владельца ключей | По результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 6. |
6 | Создать мобильную ЭП | |
7 | Получить данные мобильной ЭП | Блокирующая (синхронная) операция. |
8Удалить сессию | Видалити сесію |
Создание множественной открепленной мобильной ЭП
Название операцииНазва операції | ПримечанияПримітка | |
---|---|---|
1Создать сессию | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
2Загрузить данные сессии | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными |
3 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП. Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
4Установить параметры сессии | Встановити параметри сесії | Поддерживаемые параметры: "signatureType", "cadesType", "dataToSignQualifier". |
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 Тестовая учетная запись:
Документация по 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Удалить сессию | Видалити сесію |