Page History

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

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

2

Загрузить данные сессииМогут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными.3Установить параметры сессии 4Создать ЭП 5Получить данные ЭПБлокирующая (синхронная) операция.6Удалить сессию

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

3

4

5

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

Note

title	Увага

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

6

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

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

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

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

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

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

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

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

Примітка

1

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

2

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

3

4

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

5

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

6

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

Note

title	Увага

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

7

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

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

Примітка

1

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

2

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

3

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

4

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

5

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

6

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

Note

title	Увага

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

7

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

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

Примітка

1

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

2

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

При своренні вбудованого (ATTACHED) підпису формату XAdES в якості даних має бути завантажений xml-документ.

3

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

XAdES: "signatureType", "xadesType".
ASiC-E з XAdES: "xadesType", "asicForm=ASIC_E"
ASiC-E з CAdES: "cadesType", "asicForm=ASIC_E"
ASIC-S з CAdES: "cadesType", "asicForm=ASIC_S"
ASIC-S з XAdES: не підтримується

4

Завантаження метаданих сесії

В якості метаданих завантажити ідентифікатор даних, зазвичай ім'я файлу.

5

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

6

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

7

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

Note

title	Увага

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

8

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

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

Примітка

1

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

2

Завантаження даних ЕП

В якості даних ЕП має бути завантажено раніше створений ЕП.

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

3

Має бути вказаний параметр "cadesType".
Для параметра "dataToSignQualifier" має бути встановлено значення

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

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

3Установить параметры сессииДля параметра "dataToSignQualifier" должно быть установлено значение

"alreadySigned".
Для параметра "signatureType"

должно быть установлено значение

має бути встановлено значення "attached".
Для параметра "duplicateSign"

должно быть установлено значение

має бути встановлено значення "true",

если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом

якщо необхідно забезпечиит можливість підписання документу кілька разів одним і тим же підписантом.

4

Создать ЭП

5

Получить данные ЭПБлокирующая (синхронная) операция.6Удалить сессию

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

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

Note

title	Увага

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

6

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

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

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

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

4Установить параметры сессииДля параметра "dataToSignQualifier" должно быть установлено значение

"alreadySigned".
Для параметра "signatureType"

должно быть установлено значение

має бути встановлено значення "detached".
Для параметр "duplicateSign"

должно быть установлено значение

має бути встановлено значення "true",

если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом

якщо необхідно забезпечиит можливість підписання документу кілька разів одним і тим же підписантом.

5

Создать ЭП

6

Получить данные ЭПБлокирующая (синхронная) операция.7Удалить сессию

Проверка ЭП

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

Если после проверки ЭП необходимо получить подписанные данные, то следует использовать запрос Получение подписанных данных.

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

Note

title	Увага

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

7

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

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

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

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

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

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

Перевірка ЕП

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

Загрузить данные сессииМогут быть загружены в виде: двоичных данных или Base64 строки.
Обязательны только в случае, если исходная ЭП является открепленной.4Установить параметры сессии

Завантаження даних сесії	Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядку. Обовʼязкові у тому випадку, якщо вихідний ЕП є відкріпленим.
4	Встановлення параметрів сесії	Для параметра "cadesType"

должно быть установлено значение формата модифицированной (результирующей) ЭП. Если параметр содержит (по-умолчанию) значение

має бути встановлено значення формату модифікованого (результуючого) ЕП. Якщо параметр містить (за замовчуванням) значення "undefined", в

качестве формата модифицированной подписи будет использоваться значение

якості формату модификованого ЕП буде використовуватися значення "CAdESXLong".
Для параметра "signatureType"

должно быть установлено значение типа модифицированной (результирующей) ЭП

має бути встановлено значення типу модифікованого (результуючого) ЕП.

5

Модифицировать ЭП

Модифікація ЕП
6

Получить данные модифицированной ЭПБлокирующая (синхронная) операция.
Для получения дополнительной информации о результате модификации следует использовать запрос Получение результата модификации ЭП

Отримання даних модифікованого ЕП	Блокуюча (синхронна) операція. Для отримання додатковї інформації про результат модифікації слід використовувати запит Отримання результату модифікації ЕП.
7

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

Модификация существующей ЭП с контролем состояния