Page History

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

2

Загрузить данные сессии

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

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

3

Установить параметры сессии

Має бути вказаний

3

Должен быть указан параметр "caId".

4

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

6

Блокуюча (синхронна) операція.

Note

title	Увага

За допомогою запиту Отримання результату створення ЕП можна отримати розширену помилку, чому саме не створений ЕП

Блокирующая (синхронная) операция

.

7

Удалить сессию

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

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

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

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

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

Note

title	Увага

За допомогою запиту Отримати результат створення ЕП можна отримати розширену помилку, чому саме не створений ЕП.

Назва операції

Примітка

1

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

2

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

3

Установить параметры сессии

Має бути вказаний

Название элемента

Примечания

1

Создать сессию

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

2

Загрузить данные сессии

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

3

Должен быть указан параметр "caId".

4

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

5Создать ЭП

6

Получить Отримати результат создания ЭПстворення ЕП

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

Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания ЭП

.

7

Получить данные ЭП

Блокуюча (синхронна) операція.

Note

title	Увага

За допомогою запиту Отримання результату створення ЕП можна отримати розширену помилку, чому саме не створений ЕП

Блокирующая (синхронная) операция

.

8

Удалить сессию

Создание множественной встроенной ЭП

...

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

...

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

Назва операції

Примітка

1

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

2

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

3

Має бути вказані параметри "caId", "signatureType" та "cadesType".

4

5

Отримати результат створення ЕП

6

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

7

Блокуюча (синхронна) операція.

Note

title	Увага

За допомогою запиту Отримання результату створення ЕП можна отримати розширену помилку, чому саме не створений ЕП.

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

Блокуюча (синхронна) операція.

Note

title	Увага

За допомогою запиту Отримання результату створення ЕП можна отримати розширену помилку, чому саме не створений ЕП.

9

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

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

Назва операції

Примітка

1

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

2

Завантажити дані ЕП

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

3

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

4

5

6

Блокуюча (синхронна) операція.

Note

title	Увага

За допомогою запиту Отримання результату створення ЕП можна отримати розширену помилку, чому саме не створений ЕП.

7

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

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

Назва операції

Примітка

1

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

2

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

3

Завантажити дані ЕП

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

4

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

5

6

7

Блокуюча (синхронна) операція.

Note

title	Увага

За допомогою запиту Отримання результату створення ЕП можна отримати розширену помилку, чому саме не створений ЕП.

8

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

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

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

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

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

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

Назва операції

Примітка

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

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

keyStoreUri: cihsm://cipher-test-site/vhsm-53.46df7832
Password: 12345678

Створення ЕП з ключами 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

Блокуюча (синхронна) операція.

Note

title	Увага

За допомогою запиту Отримання результату створення ЕП можна отримати розширену помилку, чому саме не створений ЕП.

8