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

вказаний параметр

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

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

Має бути вказаний параметр та

	Назва операції	Примітка
1	Створити сесію	Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію.
2	Завантажити дані сесії	Можуть бути завантажені у вигляді: двійкових даних, 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	Завантажити ключовий контейнер сесії
6	Створити КЕП
7	Отримати результат створення КЕП	Не блокуюча (асинхронна) операція. Слід використовувати для контролю стану процесу створення КЕП.
8	Отримати дані КЕП	Блокуюча (синхронна) операція.
9	Видалити сесію

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

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

4Не блокуюча (асинхронна) операція. Слід використовувати для контролю стану процесу створення КЕП.8

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

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

Створення

...

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

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

створювати окрему сесію.3 сесії4Не блокуюча (асинхронна) операція. Слід використовувати для контролю стану процесу створення КЕП.

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

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

Створення

...

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

	Назва операції	Примітка
1	Створити сесію
2	Встановити параметри сесії	Має бути вказані параметри "caId", "signatureType" та "cadesType".
3

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

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

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

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

Завантажити ключовий контейнер сесії

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


4	Створення ЕП для даних (масова операція)	Має бути вказаний параметр "keyStorePassword" та "dataToSign".
5	Видалити сесію

Створення

...

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

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

1Створити сесіюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію.


1	Створити сесію
2

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

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

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

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

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

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

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

Вказати наступні параметри:

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".

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


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

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

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

для гешів (масова операція)5Видалити сесію

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

для гешів (масова операція)
5	Видалити сесію

Створення КЕП з ключами на МКМ Шифр-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	Встановити параметри сесії	Має бути вказаний параметр "cadesType", "signatureType"
5	Розширення КЕП
6	Отримати дані розширеного КЕП	Блокуюча (синхронна) операція.
7	Отримати результат розширення КЕП
8	Видалити сесію

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

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