Table of Contents

maxLevel	2

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

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

...

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

Створення

...

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

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

Створення

...

КЕП з контролем стану для формату XAdES та контейнерів ASIC-S(E)

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

	Назва операції	Примітка
1	Створити сесію	Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію.
2	Завантажити дані сесії	Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними.
3	Завантажити дані КЕП	В якості даних КЕП має бути завантажена раніше створено відкріплений КЕП. Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними.
При своренні вбудованого (ATTACHED) підпису формату XAdES в якості даних має бути завантажений xml-документ.
3		Встановити параметри сесії	Вказати наступні параметри: XAdES: "caId"	, "signatureType", "xadesType". ASiC-E з XAdES: "caId", "xadesType", "asicForm=ASIC_E" ASiC-E з CAdES: "caId", "cadesType", "asicForm=ASIC_E" ASIC-S з CAdES: "caId", "cadesType", "asicForm=ASIC_S" ASIC-S з XAdES: не підтримується Параметр "caId" можна не вказувати, якщо в ключовому контейнері присутній сертифікат підписанта.
4	Завантаження метаданих сесії	В якості метаданих завантажити ідентифікатор даних, зазвичай ім'я файлу.
5	Завантажити ключовий контейнер сесії
5	Завантажити ключовий контейнер сесії	6	Створити КЕП
7	Отримати результат створення КЕП	Не блокуюча (асинхронна) операція. Слід використовувати для контролю стану процесу створення КЕП.
8	Отримати дані КЕП	Блокуюча (синхронна) операція.
9	Видалити сесію

Створення

...

множинної вбудованої КЕП

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

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

Створення

...

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

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

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

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

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

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

	Назва операції	Примітка
1	Створити сесію

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

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

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

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

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

...


2	Встановити параметри сесії	Має бути вказані параметри "caId", "signatureType" та "cadesType".
3	Завантажити ключовий контейнер сесії
4	Створення ЕП для даних (масова операція)	Має бути вказаний параметр "keyStorePassword" та "dataToSign".
5	Видалити сесію

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

	Назва операції	Примітка
1	Створити сесію

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

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

5Отримати список підтримуваних НПМЕПЗа результатами виконнання запиту обрати НПМЕП та використовувтаи його ідентифікатор на етапах 6-7.6Отримати список профілів власників ключівЗа результатами виконання запиту обрати профіль власника ключа та використати йога на етапі 7.7Створити мобільну КЕП8Отримати дані мобільної КЕПБлокуюча (синхронна) операція.


2	Встановити параметри сесії	Вказати наступні параметри: XAdES: "caId", "signatureType", "xadesType". ASiC-E з XAdES: "caId", "xadesType", "asicForm=ASIC_E" ASiC-E з CAdES: "caId", "cadesType", "asicForm=ASIC_E" ASIC-S з CAdES: "caId", "cadesType", "asicForm=ASIC_S" ASIC-S з XAdES: не підтримується Параметр "caId" можна не вказувати, якщо в ключовому контейнері присутній сертифікат підписанта.
3	Завантажити ключовий контейнер сесії
4	Створення ЕП для даних (масова операція)	При створенні вбудованого (ATTACHED) підпису формату XAdES в якості даних має бути завантажений xml-документ. Має бути вказаний параметр "keyStorePassword" та "dataToSign".
5	Видалити сесію

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

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

9

Видалити сесію

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

...

на МКМ Шифр-HSM

...

Порядок виконання усіх операцій аналогічний представленому у прикладах для файлових контейнерів. Відмінність полягає тільки в операції завантаження ключового контейнера сесії.

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

Завантажити ключовий контейнер сесії
В параметрі keyStoreUri має бути вказано URI токену.
Тестовий токен:
keyStoreUri: cihsm://cipher-test-site/vhsm-53.46df7832
Password: 12345678
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

...

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

Назва операції Примітка
1 Створити сесію Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію.
2 Завантажити дані сесії Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки.
3 Встановити параметри сесії Має бути вказаний параметр "embedCertificateType".
4 Завантажити ключовий контейнер сесії
В параметрі keyStoreUri має бути вказано URI токену.
Тестовий токен:
URI: cihsm://cipher-test-site/vhsm-53.46df7832
Password: 12345678
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

...

Назва операції Примітка
1 Створити сесію Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію.
2 Завантажити дані сесії Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки.
3 Встановити параметри сесії Має бути вказаний параметр "caId".
4 Завантажити ключовий контейнер сесії
В параметрі keyStoreUri має бути вказано URI токену.
Тестовий токен:
URI: cihsm://cipher-test-site/vhsm-53.46df7832
Password: 12345678
5 Розшифрувати
6 Отримати розшифровані дані Блокуюча (синхронна) операція. Можуть бути отримати у вигляді: двійкових даних, Base64 рядка.
7 Видалити сесію

Електронна позначка часу

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

...

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

...

Page tree

Versions Compared

Old Version 38

New Version Current

Key

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

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

Створення

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

Створення

КЕП з контролем стану для формату XAdES та контейнерів ASIC-S(E)

Створення

множинної вбудованої КЕП

Створення

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

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

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

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

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

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

на МКМ Шифр-HSM

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

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

Розширення КЕП

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

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

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

Зашифрувати ключами

на МКМ Шифр-HSM

Розшифрування

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

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

на МКМ Шифр-HSM

Електронна позначка часу

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

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

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

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

Page tree

Page History

Versions Compared

Old Version 38

New Version Current

Key

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

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

Створення

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

Створення

КЕП з контролем стану для формату XAdES та контейнерів ASIC-S(E)

Створення

множинної вбудованої КЕП

Створення

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

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

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

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

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

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

на МКМ Шифр-HSM

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

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

Розширення КЕП

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

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

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

Зашифрувати ключами

на МКМ Шифр-HSM

Розшифрування

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

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

на МКМ Шифр-HSM

Електронна позначка часу

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

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

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

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