Versions Compared

Key

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

Table of Contents
maxLevel2

Створення

...

КЕП


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

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

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

Створення КЕП з контролем стану

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


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

...


Створення множинної вбудованої КЕП


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

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

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

...


Створення множинної відкріпленої КЕП


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

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

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

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

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

...


Створення мобільної КЕП


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

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

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

...


Створення мобільної КЕП з контролем стану


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

...


Створення множинної будованої КЕП


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

В якості даних КЕП має бути завантажена раніше створено вбудований КЕП.
Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними

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

.

3Встановити параметри сесії

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

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

...


Створення множинної відкріпленої мобільної КЕП


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

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

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

...


Створення КЕП з ключами з Шифр-HSM-Site


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

В параметре keyStoreUri должен быть указан URI токенапараметрі 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-форми з двійковими даними.
4Встановити параметри сесії
5Завантажити ключовий контейнер сесіїВ параметре keyStoreUri должен быть указан URI хранилища ключей параметрі keyStoreUri має бути вказано URI сховища ключів (токена), получаем значение отримуємо значення "KeyName" с  первого запроса "Получить токен доступа к API Depositsign и идентификатор хранилища ключейз 1-го запиту "Отримати токен доступу до API Depositsign та ідентифікатор сховища ключів".
В параметре bearerToken должен быть указан токен доступа к параметрі bearerToken має бути вказано токен доступу до API Depositsign.
6Создать ЭПСтворити КЕП
7Получить данные ЭПОтримати дані КЕПБлокуюча (синхронна) операціяБлокирующая (синхронная) операция.
8Видалити сесію

...


Перевірка КЕП


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

Якщо після перевірки вбудованого ЕП КЕП необхідно отримати (виокремити) підписані дані, то слід використовувати запит Отримання підписаних даних.

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

...

Зашифрування


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

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

...


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

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

...


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

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

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

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

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


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

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


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

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


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

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

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

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

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


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

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

...


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

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


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

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

...