| Table of Contents | ||
|---|---|---|
|
Создание ЭП
Створення ЕП
| Назва операції | Примітка |
|---|
| 1 |
| Створення сесії |
| Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 |
| Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |
| 3 | Встановлення параметрів сесії | Пункти 3 та 4 можуть виконуватися у довільному порядку. |
| 4 | Встановлення метаданих сесії | Пункти 3 та 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 | Получить результат создания ЭП | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания ЭП. |
| 7 | Получить данные ЭП | Блокирующая (синхронная) операция. |
| 9 | Удалить сессию |
Создание ЭП с контролем состояния и использованием разрешения
Рекомендуется использовать в случае пакетной обработки большого количества ресурсов (файлов).
| Название элемента | Примечания | |
|---|---|---|
| 1 | Создать разрешение | |
| 2 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
| 3 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
| 4 | Установить параметры сессии | Пункты 3 и 4 могут выполняться в произвольном порядке. |
| 5 | Установить метаданные сессии | |
| 6 | Создать ЭП c разрешением | |
| 7 | Получить результат создания ЭП | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания ЭП. |
| 8 | Получить данные ЭП | Блокирующая (синхронная) операция. |
| 9 | Удалить сессию | |
| 10 | Выполнить пп.2-9 для следующего файла |
Создание множественной встроенной ЭП
| Название операции | Примечания | |
|---|---|---|
| 1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
| 2 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная встроенная ЭП. |
| 3 | Установить параметры сессии | Для параметра "dataToSignQualifier" должно быть установлено значение "alreadySigned". Для параметра "signatureType" должно быть установлено значение "attached". Для параметр "duplicateSign" должно быть установлено значение "true", если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом. |
| 4 | Установить метаданные сессии | Пункты 3 и 4 могут выполняться в произвольном порядке. |
| 5 | Создать ЭП | |
| 6 | Получить данные ЭП | Блокирующая (синхронная) операция. |
| 7 | Удалить сессию |
Создание множественной открепленной ЭП
| Название операции | Примечания | |
|---|---|---|
| 1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
| 2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
| 3 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП. |
| 4 | Установить параметры сессии | Для параметра "dataToSignQualifier" должно быть установлено значение "alreadySigned". |
| 5 | Установить метаданные сессии | Пункты 4 и 5 могут выполняться в произвольном порядке. |
| 6 | Создать ЭП | |
| 7 | Получить данные ЭП | Блокирующая (синхронная) операция. |
| 8 | Удалить сессию |
Проверка ЭП
| Название операции | Примечания | |
|---|---|---|
| 1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
| 2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
| 3 | Загрузить данные ЭП | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
| 4 | Установить параметры сессии | |
| 5 | Проверка ЭП | |
| 6 | Получить результат проверки ЭП | Блокирующая (синхронная) операция. |
| 7 | Удалить сессию |
Если после проверки ЭП необходимо получить подписанные данные, то следует использовать запрос Получение подписанных данных.
Створення ЕП з контролем стану
Можливо використовувати у випадку пакетної обробки більшої кількості ресурсів (файлів).
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. |
| 3 | Встановлення параметрів сесії | Пункти 3 та 4 можуть виконуватися у довільному порядку. |
| 4 | Встановлення метаданих сесії | |
| 5 | Створення ЕП | |
| 6 | Отримання результату створення ЕП | Не блокуюча (асинхрона) операція. Слід використовувати для контролю стану процесу створення ЕП. |
| 7 | Отримання даних ЕП | Блокуюча (синхрона) операція. |
| 9 | Видалення сесії |
Створення ЕП з контролем стану та використання розширення
Рекомендується використовувати у випадку пакетної обробки більшої кількості ресурсів (файлів).
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення розширення | |
| 2 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 3 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. |
| 4 | Встановлення параметрів сесії | Пункти 3 та 4 можуть виконуватися у довільному порядку. |
| 5 | Встановлення метаданих сесії | |
| 6 | Створення ЕП з розширенням | |
| 7 | Отримання результату створення ЕП | Не блокуюча (асинхрона) операція. Слід використовувати для контролю стану процесу створення ЕП. |
| 8 | Отримання даних ЕП | Блокуюча (синхрона) операція. |
| 9 | Видалення сесії | |
| 10 | Виконати пп.2-9 для наступного файлу |
Створення множинного вбудованого ЕП
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних ЕП | В якості даних ЕП має бути завантажено раніше створений вбудований ЕП. |
| 3 | Встановлення параметрів сесії | Для параметру "dataToSignQualifier" має бути встановлено значення "alreadySigned". |
| 4 | Встановлення метаданих сесії | Пункти 3 та 4 можуть виконуватися у довільному порядку. |
| 5 | Створення ЕП | |
| 6 | Отримання даних ЕП | Блокуюча (синхрона) операція. |
| 7 | Видалення сесії |
Створення множинного відкріпленого ЕП
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. |
| 3 | Завантаження даних ЕП | В якості даних ЕП має бути завантажено раніше створений відкріплений ЕП. |
| 4 | Встановлення параметрів сесії | Для параметру "dataToSignQualifier" має бути встановлено значення "alreadySigned". |
| 5 | Встановлення метаданих сесії | Пункти 4 та 5 можуть виконуватися у довільному порядку. |
| 6 | Створення ЕП | |
| 7 | Отримання даних ЕП | Блокуюча (синхрона) операція. |
| 8 | Видалення сесії |
Перевірка ЕП
| Назва операції | Примітка | |
|---|---|---|
| 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 |
Создание электронной метки времени с контролем состояния
Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).
| Название элемента | Примечания | |
|---|---|---|
| 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 | Генерация новых ключей |
Зашифрование
| Название операции | Примечания | |
|---|---|---|
| 1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
| 2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки. |
| 3 | Установить параметры сессии | |
| 4 | Загрузить сертификаты получателей | Необходим как минимум один сертификат получателя зашифрованных данных. Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки. |
| 5 | Зашифровать | |
| 6 | Получить зашифрованные данные | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
| 7 | Удалить сессию |
Зашифрование с контролем состояния
Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).
| Название операции | Примечания | |
|---|---|---|
| 1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
| 2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки. |
| 3 | Установить параметры сессии | |
| 4 | Загрузить сертификаты получателей | Необходим как минимум один сертификат получателя зашифрованных данных. Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки. |
| 5 | Зашифровать | |
| 6 | Получить результат зашифрования | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса зашифрования. |
| 7 | Получить зашифрованные данные | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
| 8 | Удалить сессию |
Расшифрование
| Название операции | Примечания | |
|---|---|---|
| 1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
| 2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки. |
| 3 | Расшифровать | |
| 5 | Получить расшифрованные данные | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
| 6 | Удалить сессию |
Расшифрование с контролем состояния
| Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. | |
| 3 | Встановлення параметрів сесії | Пункти 2 та 3 можуть виконуватися у довільному порядку. |
| 4 | Створення ЕПЧ | |
| 5 | Отримання даних ЕПЧ | Блокуюча (синхрона) операція. |
| 6 | Видалення сесії |
Створення електронної позначки часу з контролем стану
Можливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. |
| 3 | Встановлення параметрів сесії | |
| 4 | Створення ЕПЧ | |
| 5 | Отримання результату створення ЕПЧ | Неблокуюча (асинхрона) операція. Слід використовувати для контролю стану процесу створення ЕПЧ. |
| 6 | Отримання даних ЕПЧ | Блокуюча (синхрона) операція. |
| 7 | Видалення сесії |
Перевірка електронної позначки часу
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. |
| 3 | Завантаження даних ЕПЧ | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними. |
| 3 | Встановлення параметрів сесії | |
| 5 | Перевірка ЕПЧ | |
| 6 | Отримання результату перевірки ЕПЧ | Блокуюча (синхрона) операція. |
| 7 | Видалення сесії |
Генерація нових ключів
| Назва операції | Примітка | |
|---|---|---|
| 1 | Отримання профілю для генерації ключів | |
| 2 | Генерація нових ключів |
Зашифрування
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку. |
| 3 | Встановлення параметрів сесії | |
| 4 | Завантаження сертифікатів отримувачів | Необхідно як мінімум один сертифікат отримувача зашифрованих даних. Сертифікати можуть бути завантажені у вигляді: двійкових даних, Base64 рядку. |
| 5 | Зашифрування | |
| 6 | Отримання зашифрованих даних | Блокуюча (синхрона) операція. Можуть бути отримані у вигляді: двійкових даних, Base64 рядку. |
| 7 | Видалення сесії |
Зашифрування з контролем стану
Можливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку. |
| 3 | Встановлення параметрів сесії | |
| 4 | Завантаження сертифікатів отримувачів | Необхідно як мінімум один сертифікат отримувача зашифрованих даних. Сертифікати можуть бути завантажені у вигляді: двійкових даних, Base64 рядку. |
| 5 | Зашифрування | |
| 6 | Отримання результату зашифрування | Неблокуюча (асинхрона) операція. Слід використовувати для контролю стану процесу зашифрування. |
| 7 | Отримання зашифрованих даних | Блокуюча (синхрона) операція. Можуть бути отримані у вигляді: двійкових даних, Base64 рядку. |
| 8 | Видалення сесії |
Розшифрування
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку. |
| 3 | Розшифрування | |
| 5 | Отримання розшифрованих даних | Блокуюча (синхрона) операція. Можуть бути отримані у вигляді: двійкових даних, Base64 рядку. |
| 6 | Видалення сесії |
Розшифрування з контролем стану
| Назва операції | Примітка | |
|---|---|---|
| 1 | Створення сесії | Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
| 2 | Завантаження даних сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку. |
| 3 | Розшифрування | |
| 4 | Отримання результату розшифрування | Неблокуюча (асинхрона) операція. Слід використовувати для контролю стану процесу розшифрування. |
| 5 | Отримання розшифрованих даних | Блокуюча (синхрона) операція. Можуть бути отримані у вигляді: двійкових даних, Base64 рядку. |
| 6 | Видалення сесії |