Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  1. Файловий контейнер
    Для використання в якості ключового контейнеру сесії завантажується файловий контейнер у кодуванні base64 у форматі PKCS#12, пропрієтарні формати ІІТ ("Key-6.dat", "Приватбанк jks", "Україна ZS2"). У випадку успішного завантаження при виконанні операції створення КЕП, зашифрування та розшифрування використовується особистий ключ, та за наявності сертифікат (ланцюг сертифікатів) із завантаженого файлогового файлового контейнеру.
    Дані ключового контейнеру сесії знаходяться в оперативній памʼяті з моменту завантаження до моменту видалення сесії та виконання віртуальною машиною Java наступної процедури збору сміття. Дані ключового контейнеру НІКОЛИ не зберігаються сервісом у файл, базу даних чи інші обʼєкти для довгострокового зберігання інформації. 
  2. Сховище ключів (токен) у складі хмарного ссервісусервісу.
    Підтримувані сервіси: Cipher-CKS, Depositsign
Note
titleУвага

Метод підтримує захищені параметри. 
Ознайомитись с описом та деталями використання захищених параметрів можливо за посиланням Створення та використання захищених параметрів.
Усі параметри JSON обʼєкту запиту можуть бути передані як захищені параметри. Якщо відкритий параметр та захищений параметр мають однакове ім'я, то буде використане значення захищеного параметра.

URL-адреса запиту

https:///localhost:9094ccs-dev-api.cipher.kiev.ua/ccs/api/v1/ticket/{uuid}/keyStore

Метод

PUT

Параметри запиту
uuidStringІдентифікатор сесії

...

Імʼя
Тип
Опис
Допустимі значення
base64Data
String

Файловий контейнер у кодуванні Base64.

Необовʼязковий Не обовʼязковий параметр, який використовується лише при роботі з файловим контейнером. 

Правильно закондаваний закодований Base64 рядок
keyStoreUriString

Унікальний ідентифікатор сховища ключів (токена).

Необовʼязковий Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами.

Формат залежить від хмарного сервісу, який згенерував URI
bearerTokenString

Токен доступу, який необхідний для доступу до API хмарного сервісу.

Необовʼязковий Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами.

Формат залежить від хмарного сервісу, який згенерував токен
privilegedBearerTokenString

Токен доступу, який використовується для виконання запитів без другого фактору, навіть якщо другий фактор ввімкнено в налаштуваннях облікового запису користувача.

Необовʼязковий Не обовʼязковий параметр, який використовується лише при роботі з деякими хмарними сервісами.

Лише для хмарного сервісу Depositsign

...

ПараметрТип данихОпис
messageStringОпис результату проведення операції
failureCause StringОпис причини появи помилки
Приклад коду на JavaScript + jQuery 2.2.4
Файловые контейнеры
Code Block
var settings = {
  "url": "https://localhost:9094/api/v1/ticket/32cec449-9857-4ace-aaa4-b8c2c507e1d2/keyStore",
  "method": "PUT",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer {{token}}"
  },
  "data": JSON.stringify({
    "base64Data": "MIIE4wIBAzCCBIAGCSqGSIb3DQEHAaCCBHEEggRtMIIEaTCCBGUGCSqGSIb3DQEHAaCCBFYEggRSMIIETjCCAfIGCyqGSIb3DQEMCgECoIIBrjCCAaowgbAGCSqGSIb3DQEFDTCBojBDBgkqhkiG9w0BBQwwNgQgHjNPbWQsQ9UK3CR6wfTZdvuwtDW0So6Dny2fpdXUvG0CAicQMA4GCiqGJAIBAQEBAQIFADBbBgsqhiQCAQEBAQEBAzBMBAhAIS5+Hm6tHQRAqdbrRfE8cIKAxJZ7Ix9erfZY66TANykdONlr8CXKThf46XINxhW0OiiXXwvB3qNkOLVk6iwXn9ASPm24+sV5BASB9LwokywZbaJhIpOjNnVNW6SQNil5ghgfaqeF2kIYrsi7UYjq5SpNSxY3/9g8Y/9z1AcB6NyKEqzAsrU1v1mnv1j4S2uw4ynTbsSY5KPi3w4x9DjTdWya0Cn5e7RJ7+Szhcc8zvqXB2KqCe4qdzcrbLe0KgNcNDIwIE+dZLOj7KLYIR8a8cw5+KhI90FSuEfvReAlZqgjtSV7IECbJHlyF0Cq2EdCJ9CDtV7m3GS61KdlrXIpWnd3a7g0A0Kvd9CQXoi3sjl3SJ+Xh7S6DNzRykRWuHe+jPzGS0IYjpqtFOpAOjxjn2W3VAQw/IBQW4po1E+mmE8xMTAvBgkqhkiG9w0BCRUxIgQgBBb7wFVMJwq8Y1yG6SDgtkOQSDOHqo8cYuTcnIRRepkwggJUBgsqhkiG9w0BDAoBAqCCAhAwggIMMIGwBgkqhkiG9w0BBQ0wgaIwQwYJKoZIhvcNAQUMMDYEIKUx0CFQ4n7040lVjWvZlNQvALlgujsSZvtWbtNE7AWlAgInEDAOBgoqhiQCAQEBAQECBQAwWwYLKoYkAgEBAQEBAQMwTAQIKYyhwjLgbWYEQKnW60XxPHCCgMSWeyMfXq32WOukwDcpHTjZa/Alyk4X+OlyDcYVtDool18Lwd6jZDi1ZOosF5/QEj5tuPrFeQQEggFVxHMEdMa0ooGKEMkYMjFVHf2LYhwcwk4r0/wr7/hihmqdde1GN6UGVMr0/jrYYLHE0uJsOyqVc0/nXF6L1wycqbCnGxxwL48QdQDz6j4D7pIoN21c5c2kFYqZjxi5g73kctLeR0skqqu+pD2vxpsW7fkJhTdVgdxTFNM1JBgC2O5XBEcT3BUP90omF2X3NZL4n/j3L1X3lePjnffVIH0ThLMowEkBo2sxg4iGJeRD9xshpvJqgy8wq3KSy3Tp9Ph7Tb3Akecvxl13Yu80gRku8ZdWvHdsMMMoMPaO6Jp/+41RqqH7xGJwL7nAv4K7w3VATvwvISKXwNwRPRSL7gzZtUE+iqtQG7o8+LbtV29LPLTIC0G2UpT3RIRYExc0CZYXcPk0QtjM5NutqdvI5Gmw8e48hz+/tqtUXKzAKwzIRqagfPS4nApu1y6uZwl8ry3EuGnkrU4xMTAvBgkqhkiG9w0BCRUxIgQgQ3nRbUNM+XnKILpt5dwLfZPDC6X382vd+mYygooG59wwWjAyMA4GCiqGJAIBAQEBAgEFAAQg4kDtDBXfZMoOhoeLysS157OaRYC8N9Nc21xp5uEP77AEIH8jII3jRSetdi1iVrO0oJ9i6C1rPK7ischqsqzLCS1TAgInEA=="
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
Depositsign

...

languagejs

...