| Table of Contents | ||
|---|---|---|
|
Створення ЕП
Створення ЕП
| Назва операції | Примітка | ||||||
|---|---|---|---|---|---|---|---|
| 1Создать сессию | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. | |||||
| 2Загрузить данные сессии | Завантаження даних сесії | Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |||||
| 3Установить параметры сессии | Встановлення параметрів сесії | ||||||
| 4Создать ЭП | Створення ЕП | ||||||
| 5Получить данные ЭП | Отримання даних ЕП | Блокуюча (синхронна) операція.
| |||||
| 6 | Видалення сесії | 6 | Удалить сессию |
Приклад створення ЕП для текстових даних (Java, Maven, Cipher Signer Server): https://github.com/stokipny/sjwsa-singer-server-client
...
Можливе використання у випадку пакетної обробки великох кількості ресурсів (файлів).
| Назва операції | Примітка | ||||||
|---|---|---|---|---|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. | |||||
| 2 | Завантаження даних сесії | Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |||||
| 3 | Встановлення параметрів сесії | ||||||
| 4 | Створення ЕП | ||||||
| 5 | Отримання результату створення ЕП | Неблокуючи (асинхронна) операція. Слід використовувати для контролю стану процесу створення ЕП. | |||||
| 6 | Отримання даних ЕП | Блокуюча (синхронна) операція.
| |||||
| 7 | Видалення сесії |
Створення ЕП з контролем стану для формату CAdES
| Назва операції | Примітка | ||||||
|---|---|---|---|---|---|---|---|
| 1Создать сессию | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. | |||||
| 2Загрузить данные сессии | Завантаження даних сесії | Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |||||
| 3Установить параметры сессии | Встановлення параметрів сесії | Має бути вказані параметри "signatureType" та "cadesType". | |||||
| 4Создать ЭП | Створення ЕП | ||||||
| 5Получить результат создания ЭП | Отримання результату створення ЕП | Неблокуючи (асинхронна) операція. Слід використовувати для контролю стану процесу створення ЕП. | |||||
| 6 | Получить данные ЭПОтримання даних ЕП | Блокуюча (синхронна) операція.
| |||||
| 7Удалить сессию | Видалення сесії |
Створення ЕП з контролем стану для формату XAdES та контейнерів ASIC-S(E)
| Назва операції | Примітка | ||||||
|---|---|---|---|---|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. | |||||
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. При своренні вбудованого (ATTACHED) підпису формату XAdES в якості даних має бути завантажений xml-документ. | |||||
| 3 | Встановлення параметрів сесії | Вказати наступні параметри:
| |||||
| 4 | Завантаження метаданих сесії | В якості метаданих завантажити ідентифікатор даних, зазвичай ім'я файлу. | |||||
| 5 | Створення ЕП | ||||||
| 6 | Отримання результату створення ЕП | Неблокуючи (асинхронна) операція. Слід використовувати для контролю стану процесу створення ЕП. | |||||
| 7 | Отримання даних ЕП | Блокуюча (синхронна) операція.
| |||||
| 8 | Видалення сесії |
Створення множинного вбудованого ЕП
| Назва операції | Примітка | ||||||
|---|---|---|---|---|---|---|---|
| 1Создать сессию | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. | |||||
| 2Загрузить данные ЭП | Завантаження даних ЕП | В якості даних ЕП має бути завантажено раніше створений ЕП. Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |||||
| 3Установить параметры сессии | Встановлення параметрів сесії | Має бути вказаний параметр "cadesType". | |||||
| 4Создать ЭП | Створення ЕП | ||||||
| 5Получить данные ЭП | Отримання даних ЕП | Блокуюча (синхронна) операція.
| |||||
| 6Удалить сессию | Видалення сесії |
Створення множинного відкріпленого ЕП
| Назва операції | Примітка | ||||||
|---|---|---|---|---|---|---|---|
| 1Создать сессию | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. | |||||
| 2Загрузить данные сессии | Завантаження даних сесії | Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |||||
| 3Загрузить данные ЭП | Завантаження даних ЕП | В якості даних ЕП має бути завантажена раніше створена для даних сесії відкріплений ЕПвідкріплений ЕП. Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |||||
| 4Установить параметры сессии | Встановлення параметрів сесії | Має бути вказаний параметр "cadesType". | |||||
| 5Создать ЭП | Створення ЕП | ||||||
| 6Получить данные ЭП | Отримання даних ЕП | Блокуюча (синхронна) операція.
| |||||
| 7Удалить сессию | Видалення сесії |
Створення ЕП для даних (масова операція) для формату CAdES
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Встановлення параметрів сесії | Має бути вказані параметри "signatureType" та "cadesType". |
| 3 | Створення ЕП для даних (масова операція) | Має бути вказаний параметр "dataToSign". |
| 4 | Видалення сесії |
Створення ЕП для даних (масова операція) для для формату XAdES та контейнерів ASIC-S(E)
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Встановлення параметрів сесії | Вказати наступні параметри:
|
| 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 рядкуМогут быть загружены в виде: двоичных данных или Base64 строки. Обовʼязкові у тому випадку, якщо вихідний ЕП вихідний ЕП є відкріпленим. |
| 4Установить параметры сессии | Встановлення параметрів сесії | Для параметра "cadesType" має бути встановлено значення формату модифікованого (результуючого) ЕП. Якщо параметр містить держит (за замовчуванням) значення "undefined", в якості формату модификованого ЕП буде використовуватися значення значення "CAdESXLong". | |
| 5Модифицировать ЭП | Модифікація ЕП | ||
| 6Получить данные модифицированной ЭП | Отримання даних модифікованого ЕП | Блокуюча (синхронна) операція. Для отримання додатковї інформації про результат модифікації слід використовувати запит Отримання результату модифікації ЕП. | |
| 7Удалить сессию | Видалення сесії |
Модифікація існуючого ЕП з контролем стану
| Назва операції | Примітка | ||
|---|---|---|---|
| 1Создать сессию | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. | |
| 2 | Загрузить данные ЭП | Завантаження даних ЕП | Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядкуМогут быть загружены в виде: двоичных данных или Base64 строки. |
| 3 | Загрузить данные сессии | Завантаження даних сесії | Можуть бути завантажені дані у вигляді: двійкових даних, Base64 рядкуМогут быть загружены в виде: двоичных данных или Base64 строки. Обовʼязкові у тому випадку, якщо вихідний ЕП вихідний ЕП є відкріпленим. |
| 4Установить параметры сессии | Встановлення параметрів сесії | Для параметра "cadesType" має бути встановлено значення формату модифікованого (результуючого) ЕП. Якщо параметр містить держит (за замовчуванням) значення "undefined", в якості формату модификованого ЕП модификованого ЕП буде використовуватися значення "CAdESXLong". | |
| 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 | Встановлення параметрів сесії | 3 | Установить параметры сессии | |
| 5Проверить ЭМВ | Перевірка ЕПЧ | |||
| 6Получить результат проверки ЭМВ | Отримання результату перевірки ЕПЧ | Блокуюча (синхронна) операція. | ||
| 7Удалить сессию | Видалення сесії |