Page History

Table of Contents

maxLevel	2

Створення ЕП

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

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

	Назва операції	Примітка
1	Створення сесії	Рекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію.
2	Завантаження даних сесії	Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними.
3	Завантаження даних ЕП	В якості даних ЕП має бути завантажено раніше створений відкріплений ЕП. Можуть бути завантажені у вигляді: двійкових даних, Base64 рядку, HTML-форми з двійковими даними.
4	Встановлення параметрів сесії	Для параметру "dataToSignQualifier" має бути встановлено значення "alreadySigned". Для параметру "signatureType" має бути встановлено значення "detached". Для параметру "duplicateSign" має бути встановлено значення "true", якщо необхідно забезпечити можливість підписання документу кілька разів одним і тим же підписантом. Пункти 4 та 5 можуть виконуватися у довільному порядку.
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	Завантаження даних сесії	Можуть бути завантажені у вигляді: двійкових даних, 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	Видалення сесії

Особенности функционирования

После успешного запуска приложения пользователю должен осуществить запуск Сервиса с использованием личных ключей или использовать режим работы "Без ключей".

В режиме работы "Без ключей" доступные операции проверки ЭЦП, создания МВ, проверки МВ, для версии Enerprise также доступна операция генерации новых ключей. Существует возможность автоматического старта сервиса в режиме работы "Без ключей".

Для постановки ЭЦП пользователю необходимо обязательно использовать для запуска Сервиса личные ключи, которые должны быть действительными.

Если с Сервисом не производили никаких операций на протяжении заданого временного интервала, Сервис автоматически прекращает работу. Время бездействия Сервиса может быть установлено через параметр конфигурации или посредством запроса Установка параметров Сервиса.

Для выполнения операций Сервис использует определенное конфигурационным параметром количество потоков, которое по-умолчанию для версий Enterprise и Public равно 4.

Создание ЭЦП

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

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

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

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

Создание ЭЦП с контролем состояния и использованием разрешения

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

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

Проверка ЭЦП

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

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

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

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

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