Создание ЭП
Створення ЕП
Створення ЕП
| Название операции | ПримечанияСоздать сессиюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
2 |
Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными | 3 | Установить параметры сессии | Должен быть указан Загрузить ключевой контейнер сессии | | 5 | Создать ЭП | |
6 | Получить данные ЭП | Блокирующая (синхронная) операция. |
7 | Удалить сессию | |
Приклад створення ЕП для текстових даних Пример создания ЭП для текстовых данных (Java, Maven, Cipher Signer Server): https://github.com/stokipny/sjwsa-singer-server-client
Создание ЭП с контролем состояния
Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).
Создание множественной встроенной ЭП
Створення ЕП з контролем стану
Можливо використовувати у випадку пакетної обробки великої кількості ресурсів (файлів).
Note |
---|
|
За допомогою запиту Отримати результат створення ЕП можна отримати розширену помилку, чому саме не створений ЕП. |
Створення ЕП з контролем стану за допомогою защищенного носія
Створення ЕП з контролем стану для формату CAdES
Створення ЕП з контролем стану для формату XAdES та контейнерів ASIC-S(E)
| Назва операції | Примітка |
---|
1 | Створити сесію | Рекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
2 | Завантажити дані сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Вказати наступні параметри: - XAdES: "caId", "signatureType", "xadesType".
- ASiC-E з XAdES: "caId", "xadesType", "asicForm=ASIC_E"
- ASiC-E з CAdES: "caId", "cadesType", "asicForm=ASIC_E"
- ASIC-S з CAdES: "caId", "cadesType", "asicForm=ASIC_S"
- ASIC-S з XAdES: не підтримується
Параметр "caId" можна не вказувати, якщо в ключовому контейнері присутній сертифікат підписанта. |
4 | Завантаження метаданих сесії | В якості метаданих завантажити ідентифікатор даних, зазвичай ім'я файлу. |
5 | Завантажити ключовий контейнер сесії |
|
6 | Створити ЕП |
|
7 | Отримати результат створення ЕП | Неблокуюча (асинхронна) операція. Слід використовувати для контролю стану процесу створення ЕП. |
8 | Отримати дані ЕП | Блокуюча (синхрона) операція. |
9 | Видалити сесію |
|
Створення множинної вбудованої ЕП
| Назва операції | Примітка |
---|
1 | Створити сесію | Рекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
2 | Завантажені дані ЕП | В якості даних ЕП має бути завантажена раніше створено вбудований ЕП. Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Має бути вказаний |
| Название операции | Примечания |
---|
1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
2 | Загрузить данные ЭП | В качестве данных ЭЦП должна быть загружена ранее созданная встроенная ЭП. Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
3 | Установить параметры сессии | Должен быть указан параметр "caId". Для параметра "dataToSignQualifier" |
должно быть установлено значение мають бути встановлені значення "alreadySigned". Для параметра "signatureType" |
должно быть установлено значение мають бути встановлені значення "attached". Для параметр "duplicateSign" |
должно быть установлено значение мають бути встановлені значення "true",
|
если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантом якщо необхідно забезпечити можливість підпису документа кілька разів одним і тим же підписантом. |
4 |
Загрузить ключевой контейнер сессии | Создать ЭП | Получить данные ЭП | Блокирующая (синхронная) операция. | 7 | Удалить сессию | |
Создание множественной открепленной ЭП
Створення множинної відкріпленої ЕП
| Назва операції | Примітка |
---|
1 | Створити сесію | Рекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
2 | Завантажити дані сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Завантажити дані ЕП | В якості даних ЕП має бути завантажена раніше створено відкріплений ЕП. Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
4 | Встановити параметри сесії | Має бути вказаний |
| Название операции | Примечания |
---|
1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными |
3 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП. Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
4 | Установить параметры сессии | Должен быть указан параметр "caId". Для параметра "dataToSignQualifier" |
должно быть установлено значение має бути встановлено значення "alreadySigned". Для параметра "signatureType" |
должно быть установлено значение має бути встановлено значення "detached". Для параметр "duplicateSign" |
должно быть установлено значение має бути встановлено значення "true",
|
если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантомякщо необхідно забезпечити можливість підписання документа кілька разів одним і тим же підписантом. |
5 |
Загрузить ключевой контейнер сессии | | 6 | Создать ЭП | |
7 | Получить данные ЭП | Блокирующая (синхронная) операция. |
8 | Удалить сессию | |
Проверка ЭП
Если после проверки ЭП необходимо получить подписанные данные, то следует использовать запрос Получение подписанных данных.
Створення ЕП для даних (масова операція) для формату CAdES
Створення ЕП для даних (масова операція) для для формату XAdES та контейнерів ASIC-S(E)
| Назва операції | Примітка |
---|
1 | Створити сесію | Рекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
2 | Завантажити дані сесії | Можуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Вказати наступні параметри: - XAdES: "caId", "signatureType", "xadesType".
- ASiC-E з XAdES: "caId", "xadesType", "asicForm=ASIC_E"
- ASiC-E з CAdES: "caId", "cadesType", "asicForm=ASIC_E"
- ASIC-S з CAdES: "caId", "cadesType", "asicForm=ASIC_S"
- ASIC-S з XAdES: не підтримується
Параметр "caId" можна не вказувати, якщо в ключовому контейнері присутній сертифікат підписанта. |
4 | Завантажити ключовий контейнер сесії |
|
5 | Створення ЕП для даних (масова операція) | Має бути вказаний параметр "keyStorePassword" та "dataToSign". |
6 | Видалити сесію |
|
Створення ЕП для гешів (масова операція)
| Назва операції | Примітка |
---|
1 | Створити сесію | Рекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
3 | Встановити параметри сесії | Вказати наступні параметри: - XAdES: "caId", "signatureType", "xadesType".
- ASiC-E з XAdES: "caId", "xadesType", "asicForm=ASIC_E"
- ASiC-E з CAdES: "caId", "cadesType", "asicForm=ASIC_E"
- ASIC-S з CAdES: "caId", "cadesType", "asicForm=ASIC_S"
- ASIC-S з XAdES: не підтримується
Параметр "caId" можна не вказувати, якщо в ключовому контейнері присутній сертифікат підписанта. |
4 | Завантажити ключовий контейнер сесії |
|
5 | Створення ЕП для гешів (масова операція) | Має бути вказаний параметр "keyStorePassword" та "dataToSign". |
6 | Видалити сесію |
|
Перевірка ЕП
Якщо після перевірки ЕП необхідно отримати підписані дані, то слід використовувати запит Отримання підписаних даних.
Приклад перевірки ЕП для текстових даних Пример проверки ЭП для текстовых данных (Java, Maven, Cipher Signer Server): https://github.com/stokipny/sjwsa-singer-server-client
...
Зашифрування
...
Зашифрування
Название операцииПримечанияСоздать сессиюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
2 |
Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строкиУстановить параметры сессии | Должен быть указан Загрузить ключевой сессии | Загрузить сертификаты получателей | Завантажити сертифікати отримувачів | Необхідно, як мінімум один сертифікат отримувача зашифрованих даних. Сертифікати можуть бути завантажені у вигляді: двійкових даних, Base64 рядка |
Необходим как минимум один сертификат получателя зашифрованных данных. Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки Зашифровать | Получить зашифрованные данные | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строкиУдалить сессию | | Зашифрование с контролем состояния
Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).
Зашифрування з контролем стану
Можливо використовувати у випадку пакетної обробки великої кількості ресурсів (файлів).
| Название операции | Примечания |
---|
1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Установить параметры сессии | Должен быть указан Загрузить ключевой сессии | Загрузить сертификаты получателей | Завантажити сертифікати отримувачів | Необхідно, як мінімум один сертифікат отримувача зашифрованих даних. Сертифікати можуть бути завантажені у вигляді: двійкових даних, Base64 рядка |
Необходим как минимум один сертификат получателя зашифрованных данных. Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки Зашифровать | Получить зашифрованияНеблокирующая асинхронная операция Следует использовать Слід використовувати для контроля |
состояния процесса зашифрованиястану процесу зашифрування. |
8 |
Получить зашифрованные данные | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строкиУдалить сессию Розшифрування
...
Розшифрування
| Название операции | ПримечанияСоздать сессиюРекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створити окрему сесію. |
2 |
Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строкиУстановить параметры сессии | Должен быть указан Загрузить ключевой контейнер сессии | Расшифровать | Получить расшифрованные данные | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строкиУдалить сессию | | Расшифрование с контролем состояния
Розшифрування з контролем стану
| Название операции | Примечания |
---|
1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Установить параметры сессии | Должен быть указан Загрузить ключевой контейнер сессии | Расшифровать | Получить расшифрованияНеблокирующая асинхронная операция Следует использовать Слід використовувати для контроля |
состояния процесса расшифрованиястану процесу зашифрування. |
7 |
Получить расшифрованные данные | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строкиУдалить сессию | | Создание электронной метки времени
Создание электронной метки времени с контролем состояния
Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).
Проверка электронной метки времени
Електронна позначка часу
Створення електронної позначки часу
Створення електронної позначки часу з контролем стану
Можливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).
Перевірка електронної позначки часу
Отримання даних про ключовий контейнер
Отримання даних сертифіката
Генерація ключів
Генерація ключів з автоматичною відправкою сертифікатів до (К)НЕДП
| Назва операції | Примітка |
---|
1 | Отримання профілів генерації ключів | - Отримати перелік доступних профілів генерації ключів.
- Для кожного профілю генерації ключів отримати перелік полів та їх параметри (типове (default) значення, обов'язковість заповнення, ідентифікатор та інші).
|
2 | Генерація нових ключів | Після успішного виконання запит або запити на сертифікат будуть відправлені до (К)НЕДП через проксі сервер, який вказаний у конфігурації Агента. |
3 | Створити сесію |
|
4 | Завантажити ключовий контейнер сесії |
|
5 | Отримання даних про ключовий контейнер | Після успішного видання сертифікат або сертифікати (у випадку генерації ключів підпису і ключів шифрування) будуть записані в ключовий контейнер. Note |
---|
| - Видання сертифіката може зайняти певний час, який необхідний для виконання визначених у (К)НЕДП технічних та організаційних процедур.
- Агент виконує запит до (К)НЕДП щодо наявності сертифікатів один раз під час виконання запиту Отримання даних про ключовий контейнер.
|
|
Генерація ключів з отриманням запитів на сертифікат
| Назва операції | Примітка |
---|
1 | Отримання профілів генерації ключів | - Отримати перелік доступних профілів генерації ключів.
- Для кожного профілю генерації ключів отримати перелік полів та їх параметри (типове (default) значення, обов'язковість заповнення, ідентифікатор та інші).
|
2 | Генерація нових ключів | Встановити значення відного параметра PKCS10_DELIVERY_TYPE="RETURN_IN_RESPONSE". Після успішного виконання запит або запити на сертифікат будуть повернуті в об'єкті відповіді. |
3 | Доставка запита(ів) до (К)НЕДП та отримання сертифіката(ів) | Типові варіанти доставки запиту на сертифікат до (К)НЕДП: - У випадку використання продуктів компанії Сайфер, відправити запит до сервісу RO-jCMP.
- У випадку інтеграції з іншим (К)НЕДП, скористатися наданим розробником (К)НЕДП API.
- Особисто відвідати (К)НЕДП
|
4 | Створити сесію |
|
5 | Завантажити ключовий контейнер сесії |
|
6 | Імпорт сертифіката | У випадку наявності сертифікатів електронного підпису і шифрування, виконати окремо для кожного сертифіката. |
| Название операции | Примечания |
---|
1 | Создать сессию | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессию. |
2 | Загрузить данные сессии | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными |
3 | Загрузить данные ЭМВ | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными |
4 | Установить параметры сессии | |
5 | Проверить ЭМВ | |
6 | Получить результат проверки ЭМВ | Блокирующая (синхронная) операция. |
7 | Удалить сессию |