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