Table of Contents | ||
---|---|---|
|
Створення ЕП
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
4 | Завантажити ключовий контейнер сесії | |
5Создать ЭП | Створити ЕП | |
6Получить данные ЭП | Отримати дані ЕП | Блокирующая (синхронная) операция. |
7 | Видалити сесію |
Пример создания ЭП для текстовых данных (Java, Maven, Cipher Signer Server): https://github.com/stokipny/sjwsa-singer-server-client
Создание ЭП с контролем состояния
Возможно использовать в случае пакетной обработки большого количества ресурсов (файлов).
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
4 | Завантажити ключовий контейнер сесії | |
5 | Создать ЭП | |
6 | Получить результат создания ЭП | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания ЭП. |
7 | Получить данные ЭП | Блокирующая (синхронная) операция. |
8 | Видалити сесію |
Создание множественной встроенной ЭП
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная встроенная ЭП. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". Для параметра "dataToSignQualifier" должно быть установлено значение має бути встановлено значення "alreadySigned". Для параметра "signatureType" должно быть установлено значение "attachedмає бути встановлено значення "detached". Для параметр "duplicateSign" должно быть установлено значение має бути встановлено значення "true", если необходимо обеспечить возможность подписания документа несколько раз одним и тем же подписантомякщо необхідно забезпечити можливість підписання документа кілька разів одним і тим же підписантом. |
4 | Завантажити ключовий контейнер сесії | |
5 | Создать ЭП | |
6 | Получить данные ЭП | Блокирующая (синхронная) операция. |
7 | Видалити сесію |
Создание множественной открепленной ЭП
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП. |
4 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
5 | Завантажити ключовий контейнер сесії | |
6 | Создать ЭП | |
7 | Получить данные ЭП | Блокирующая (синхронная) операция. |
8 | Видалити сесію |
Создание мобильной ЭП
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Поддерживаемые параметры: "signatureType", "cadesType". |
4 | Получить список поддерживаемых ПУМЭП | По результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 5-6. |
5 | Получить список профилей владельца ключей | По результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 6. |
6 | Создать мобильную ЭП | |
7 | Получить данные мобильной ЭП | Блокирующая (синхронная) операция. |
8 | Видалити сесію |
Создание мобильной ЭП с контролем состояния
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Поддерживаемые параметры: "signatureType", "cadesType". |
4 | Получить список поддерживаемых ПУМЭП | По результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 5-8. |
5 | Получить список профилей владельца ключей | По результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 6. |
6 | Создать мобильную ЭП | |
7 | Получить результат создания мобильной ЭП | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания мобильной ЭП. |
8 | Получить данные мобильной ЭП | Блокирующая (синхронная) операция. |
9 | Видалити сесію |
Создание множественной встроенной мобильной ЭП
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная встроенная ЭП. Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными данными. |
3 | Встановити параметри сесії | Поддерживаемые параметры: "signatureType", "cadesType", "dataToSignQualifier". |
4 | Получить список поддерживаемых ПУМЭП | По результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 5-6. |
5 | Получить список профилей владельца ключей | По результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 6. |
6 | Создать мобильную ЭП | |
7 | Получить данные мобильной ЭП | Блокирующая (синхронная) операция. |
8 | Видалити сесію |
Создание множественной открепленной мобильной ЭП
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Загрузить данные ЭП | В качестве данных ЭП должна быть загружена ранее созданная для данных сессии открепленная ЭП. Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
4 | Встановити параметри сесії | Поддерживаемые параметры: "signatureType", "cadesType", "dataToSignQualifier". |
5 | Получить список поддерживаемых ПУМЭП | По результату выполнения запроса выбрать ПУМЭП и использовать его идентификатор на этапах 6-7. |
6 | Получить список профилей владельца ключей | По результату выполнения запроса выбрать профиль владельца ключа и использовать его на этапе 7. |
7 | Создать мобильную ЭП | |
8 | Получить данные мобильной ЭП | Блокирующая (синхронная) операция. |
9 | Видалити сесію |
Создание ЭП с ключами из Шифр-HSM-Site
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | |
4 | Завантажити ключовий контейнер сесії | В параметре keyStoreUri должен быть указан URI токена. Тестовый токен:
|
5 | Создать ЭП | |
6 | Получить данные ЭП | Блокирующая (синхронная) операция. |
7 | Видалити сесію |
Создание ЭП с ключами Depositsign
Назва операції | Примітка | |
---|---|---|
1 | Получить токен доступа к API Depositsign и идентификатор хранилища ключей | Выполнить метод API Depositsign: /api/v1/{clientId}/auth/login Тестовая учетная запись:
Документация по API Depositsign: https://depositsign.com/swagger-api-doc |
2 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
3 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
4 | Встановити параметри сесії | |
5 | Завантажити ключовий контейнер сесії | В параметре keyStoreUri должен быть указан URI хранилища ключей (токена), получаем значение "KeyName" с первого запроса "Получить токен доступа к API Depositsign и идентификатор хранилища ключей". В параметре bearerToken должен быть указан токен доступа к API Depositsign. |
6 | Создать ЭП | |
7 | Получить данные ЭП | Блокирующая (синхронная) операция. |
8 | Видалити сесію |
Проверка ЭП
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Загрузить данные ЭП | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
4 | Встановити параметри сесії | |
5 | Проверить ЭП | |
6 | Получить результат проверки ЭП | Блокирующая (синхронная) операция. |
7 | Видалити сесію |
...
Приклад перевірки ЕП з отриманням текстових даних (Java, Maven, Cipher Signer Server): https://github.com/stokipny/sjwsa-singer-server-client
Зашифровывание
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId", "embedCertificateType". |
4 | Завантажити ключовий контейнер сесії | |
5 | Завантажити сертифікати отримувачів | Необходим как минимум один сертификат получателя зашифрованных данных. Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки. |
6 | Зашифрувати | |
7 | Отримати зашифровані дані | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
8 | Видалити сесію |
Зашифрування з контролем стану
Можливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId", "embedCertificateType". |
4 | Завантажити ключовий контейнер сесії | |
5 | Завантажити сертифікати отримувачів | Необходим как минимум один сертификат получателя зашифрованных данных. Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки. |
6 | Зашифрувати | |
7 | Отримати результат зашифрування | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса зашифрования. |
8 | Отримати зашифровані дані | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
9 | Видалити сесію |
Зашифрувати ключами з Шифр-HSM-Site
Можливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Встановити параметри сесії | Должен быть указан параметр Має бути вказаний параметр "embedCertificateType". |
4 | Завантажити ключовий контейнер сесії | В параметре keyStoreUri должен быть указан URI токена. Тестовый токен:
|
5 | Завантажити сертифікати отримувачів | Необходим как минимум один сертификат получателя зашифрованных данных. Сертификаты могут быть загружены в виде: двоичных данных, Base64 строки. |
6 | Зашифрувати | |
7 | Отримати зашифровані дані | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
8 | Видалити сесію |
Розшифрувати
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
4 | Завантажити ключовий контейнер сесії | |
5 | Розшифрувати | |
6 | Отримати розшифровані дані | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
7 | Видалити сесію |
Розшифрувати з контролем стану
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
4 | Завантажити ключовий контейнер сесії | |
5 | Розшифрувати | |
6 | Отримати результат розшифрування | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса расшифрования. |
7 | Отримати розшифровані дані | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
8 | Видалити сесію |
Розшифрувати ключами з Шифр-HSM-Site
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки. |
3 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
4 | Завантажити ключовий контейнер сесії | В параметре keyStoreUri должен быть указан URI токена. Тестовый токен:
|
5 | Розшифрувати | |
6 | Отримати розшифровані дані | Блокирующая (синхронная) операция. Могут быть получены в виде: двоичных данных, Base64 строки. |
7 | Видалити сесію |
Створення електронної позначки часу
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | Пункты 3 и 4 могут выполняться в произвольном порядке. |
4 | Створити ЕПЧ | |
5 | Отримати дані ЕПЧ | Блокирующая (синхронная) операция. |
6 | Видалити сесію |
Створення електронної позначки часу з контролем стану
Можливе використання у випадку пакетної обробки великої кількості ресурсів (файлів).
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Встановити параметри сесії | |
4 | Створити ЕПЧ | |
5 | Отримати результат створення ЕПЧ | Неблокирующая (асинхронная) операция. Следует использовать для контроля состояния процесса создания ЭМВ. |
6 | Отримання даних ЕПЧ | Блокирующая (синхронная) операция. |
7 | Видалити сесію |
Перевірка електронної позначки часу
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Завантажити дані сесії | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
3 | Завантажити дані ЕПЧ | Могут быть загружены в виде: двоичных данных, Base64 строки, HTML-формы c двоичными даннымиМожуть бути завантажені у вигляді: двійкових даних, Base64 рядки, HTML-форми з двійковими даними. |
4 | Встановити параметри сесії | |
5 | Перевірка ЕПЧ | |
6 | Отримати результат перевірки ЕПЧ | Блокирующая (синхронная) операция. |
7 | Видалити сесію |
Отримання даних про ключовий контейнер
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
3 | Завантажити ключовий контейнер сесії | |
4 | Отримання даних про ключовий контейнер | |
5 | Видалити сесію |
Отримання даних сертифіката
Назва операції | Примітка | |
---|---|---|
1 | Створити сесію | Рекомендуется для каждого отдельного ресурса (файла) создавать отдельную сессиюРекомендується для кожного окремого ресурсу (файлу) створювати окрему сесію. |
2 | Встановити параметри сесії | Должен быть указан Має бути вказаний параметр "caId". |
3 | Завантажити ключовий контейнер сесії | |
4 | Отримання даних сертифіката | |
5 | Видалити сесію |
...