- Фаловый Файловий контейнер
Для использования в качестве ключевого контейнера сессии загружается файловый контейнер в кодировке base64 в формате PKCS#12, проприетарных форматах ИИТ використання в якості ключового контейнеру сесії завантажується файловий контейнер у кодуванні base64 у форматі PKCS#12, пропрієтарні формати ІІТ ("Key-6.dat", "Приватбанк jks", "Украина Україна ZS2"). В случае успешной загрузки при выполнении операций создания ЭП, зашифрования и расшифрования будет использоваться личный ключ и, в случае наличия, сертификат (цепочка сертификатов) из загруженного файлового контейнера.
Данные ключевого контейнера сессии находятся в оперативной памяти с момента загрузки до момента удаления сессии и выполнения виртуальной машиной Java последующей процедуры сборки мусора. Данные ключевого контейнера НИКОГДА не сохраняются сервисом в файл, базу данных или другие объекты для долгосрочного хранения информации. - Хранилище ключей (токен) в составе облачного сервиса
Поддерживаемые сервисы: Cipher-CKS, Depositsign
URL-адрес запроса
- У випадку успішного завантаження при виконанні операції створення КЕП, зашифрування та розшифрування використовується особистий ключ, та за наявності сертифікат (ланцюг сертифікатів) із завантаженого файлового контейнеру.
Дані ключового контейнеру сесії знаходяться в оперативній памʼяті з моменту завантаження до моменту видалення сесії та виконання віртуальною машиною Java наступної процедури збору сміття. Дані ключового контейнеру НІКОЛИ не зберігаються сервісом у файл, базу даних чи інші обʼєкти для довгострокового зберігання інформації. - Сховище ключів (токен) у складі хмарного сервісу.
Підтримувані сервіси: Cipher-CKS, Depositsign
| Note | ||
|---|---|---|
| ||
Метод підтримує захищені параметри. |
URL-адреса запиту
https://ccs-dev-api.cipher.kiev.ua/ccshttps://localhost:9094/api/v1/ticket/{uuid}/keyStore
Метод
PUT
...
Параметри запиту
| uuid | StringИдентификатор | сессииІдентифікатор сесії |
...
Налаштовувані заголовки
...
запиту
| Content-Type | application/json |
...
Параметри JSON
...
обʼєкту запиту
ИмяІмʼя | Тип | ОписаниеОпис | Допустимые значенияДопустимі значення |
|---|---|---|---|
base64Data | String | Файловый Файловий контейнер в кодировке у кодуванні Base64. Необязательный Не обовʼязковий параметр, используется только при работе с файловым який використовується лише при роботі з файловим контейнером. | Правильно закодированная закодований Base64 строкарядок |
| keyStoreUri | String | Уникальный идентификатор хранилища ключей Унікальний ідентифікатор сховища ключів (токена). Необязательный Не обовʼязковий параметр, используется только при работе с некоторыми облачными сервисами.який використовується лише при роботі з деякими хмарними сервісами. | Формат залежить від хмарного сервісу, який згенерував Формат зависит от облачного сервиса, который сгенерировал URI |
| bearerToken | String | Токен доступадоступу, который необходим для доступа к API облачного сервиса. Необязательный параметр, используется только при работе с некоторыми облачными сервисами. | Формат зависит от облачного сервиса, который сгенерировал токен |
Ответ
який необхідний для доступу до API хмарного сервісу. Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами. | Формат залежить від хмарного сервісу, який згенерував токен | ||
| privilegedBearerToken | String | Токен доступу, який використовується для виконання запитів без другого фактору, навіть якщо другий фактор ввімкнено в налаштуваннях облікового запису користувача. Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами. | Лише для хмарного сервісу Depositsign |
Відповідь
| Код відповідіКод ответа | Content-type | Допустимые параметры | Допустимі параметри | Приклад вмістуПример содержимого |
|---|---|---|---|---|
| 200 | application/json | message | { | |
| 503 | application/json | message | { | |
| 400 | application/json | message | { | |
| 500 | application/json | message failureCause | { |
...
Параметри JSON
...
обʼєкта відповіді
| Параметр | Тип данныхданих | ОписаниеОпис |
|---|---|---|
| message | String | Описание результата проведения операцииОпис результату проведення операції |
| failureCause | String | Описание причины возникновения ошибки |
Пример кода на JavaScript + jQuery 2.2.4
...
| language | js |
|---|
...
| Опис причини появи помилки |