You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 44 Next »

Створення КЕП

Створення КЕП


Назва операціїПримітка
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Видалити сесію

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


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

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


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

Створення КЕП з контролем стану для типу ASIC-S/ASIC-E


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

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

Підтримується лише для формату CAdES


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

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

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

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

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

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

Підтримується лише для формату CAdES


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

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

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

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

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

Створення КЕП для даних (масова операція) для формату CAdES

Створення КЕП для даних (масова операція) для формату XAdES

Створення КЕП для даних (масова операція) для типу ASIC-S/ASIC-E

Створення КЕП для гешів (масова операція)

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


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

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

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

5Створити КЕП
6Отримати дані КЕПБлокуюча (синхронна) операція.
7Видалити сесію

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


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

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

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

5Створити КЕП
6Отримати дані КЕПБлокуюча (синхронна) операція.
7Видалити сесію

Створення КЕП з ключами з Шифр-HSM-Site для типу ASIC-S/ASIC-E


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

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

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

5Створити КЕП
6Отримати дані КЕПБлокуюча (синхронна) операція.
7Видалити сесію

Створення КЕП з ключами Depositsign

Підтримується лише для формату CAdES


Назва операціїПримітка
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 сховища ключів (токена), отримуємо значення "KeyName" з 1-го запиту "Отримати токен доступу до API Depositsign та ідентифікатор сховища ключів".
В параметрі 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 рядки, HTML-форми з двійковими даними.
3Завантажити дані КЕПМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними.
4Встановити параметри сесіїМає бути вказаний параметр "cadesType", "signatureType"
5Розширення КЕП
6Отримати дані розширеного КЕПБлокуюча (синхронна) операція.
7Отримати результат розширення КЕП
8Видалити сесію

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

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


Назва операціїПримітка
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-форми з двійковими даними.
3Встановити параметри сесіїПункти з та 4 можуть виконуватися в довільному порядку.
4Створити ЕПЧ
5Отримати дані ЕПЧБлокуюча (синхронна) операція.
6Видалити сесію

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

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


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

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


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

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


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

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


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