Versions Compared

Old Version 8

changes.mady.by.user Svitlana Nimych

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

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

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

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

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

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

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