Versions Compared

Old Version 3

changes.mady.by.user Alexandr Stokipny

Saved on

compared with

New Version Current

changes.mady.by.user Svitlana Nimych

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2

Создание ЭЦП

Створення ЕП

Створення ЕП


Назва операціїПримітка
 Название операцииПримечания
1
Создать сессию
Створення сесії
Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию
Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію.
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",

если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом.
Пункты 3 и 4 могут выполняться в произвольном порядке.5Создать ЭЦП 6Получить данные ЭЦПБлокирующая (синхронная) операция.7Удалить сессию 

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

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

4Створення ЕП
5Отримання даних ЕП

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

Note
titleУвага

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

6Видалення сесії

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


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

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

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

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

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

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

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

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

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

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

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

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

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

если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом.
Пункты 3 и 4 могут выполняться в произвольном порядке.5Создать ЭЦП 6Получить данные ЭЦПБлокирующая (синхронная) операция.7Удалить сессию 

Проверка ЭЦП

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

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

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

5Створення ЕП
6Отримання даних ЕП

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

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 строки, HTML-формы c двоичными данными3Установить параметры сессииПункты 3 и 4 могут выполняться в произвольном порядке.4Создать МВ 5Получить данные МВБлокирующая (синхронная) операция.6Удалить сессию 

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

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

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

Проверка метки времени

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

Генерация новых ключей

 Название операцииПримечания
1Получить профиль генерации ключей 
2Генерация новых ключей 

 

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

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

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

Модифікація існуючого ЕП з контролем стану


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

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

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

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

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


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

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

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


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

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


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

...