Page History

Запит дозволяє ініціювати процес використання особистих ключів при виконанні Сервісом відповідних операцій. Функціональність аналогічна наданому інтерфейсом Сервісу, відмінність лише в способі надання даних. У випадку використання інтерфейсу користувача, шлях до ключового контейнеру, пароль до ключового контейнеру, використовуваний Кваліфікований надавач електронних довірчих послуг (КНЕДП) та за необхідності, сертифікат ключа вказується у відповідному елементі управління, а при використанні REST API вказані вище дані передаються у вигляді JSON об'єкта.

У випадку успішного виконання запиту сервіс починає використовувати особисті ключі, інтерфейс користувача починає відображати інформацію із сертифікату ключа та доступні користувачу дії.

Запит не буде виконано. якщо Сервіс вже використовує особисті ключі. Для завершення використання особистих ключів за допомогою REST API, необхідно використовувати запит Завершення використання особистих ключів.

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

Запрос позволяет инициировать процесс использования личных ключей пользователя при выполнении Сервисом соответствующих операций. Функциональность аналогична предоставляемой пользовательским интерфейсом Сервиса, отличие лишь в способе предоставления данных. В случае использования интерфейса пользователя, путь к ключевому контейнеру, пароль к ключевому контейнеру, использоемый ЦСК и, при необходимости, сертификат ключа вводятся в соответствующие элементы управления, а при использовании REST API указанные выше данные передаются в виде JSON объекта.

В случае успешного выполнения запроса сервис начинает использовать личные ключи, интерфейс пользователя начинает отображать информацию из сертификата ключа и доступные пользователю действия.

Запрос не будет выполнен, если Сервис уже использует личные ключи. Для завершения использования личных ключей посредством REST API необходимо использовать запрос Завершение использования личных ключей.

...

https://local.cipher.kiev.ua:9091/api/v1/personalKeysSession

Метод

POST

...

Параметри запиту

ОтсутствуютВідсутні

...

Налаштовувані заголовки

...

запиту

Параметры JSON объекта запроса

Параметри JSON об'єкта відповіді

Ответ

Відповідь

{
    "message": "ЗапросЗапит на использованиевикористання личныхособистих ключейключів выполненвиконано."
}

{
       "message" : "СервисСервіс хранениязберігання данных не запущензапущено." 
}

{
       "message" : "ЗапросЗапит нена содержитмістить JSON объектаоб'єкта сз дополнительнымидодатковими даннымиданими." 
}

{
    "message": "ЗапросЗапит на использованиевикористання личныхособистих ключейключів не выполненвиконано.",
    "failureCause": "ПерсональныйПерсональний сервиссервіс ужевже используетвикористовує личныеособисті ключиключі. ЗавершитеЗавершіть ихїх использованиевикористання."
}

{
    "message": "ЗапросЗапит на использованиевикористання личныхособистих ключейключів не выполненвиконано.",
    "failureCause": [
        "НевозможноНе вдалося создатьстворити криптографическийкриптографічний контекст",
        "Помилка завантаження ключового контейнераконтейнеру."
     ]
}

...

Параметри JSON об'єкта відповіді

Пример кода на JavaScript + jQuery 2.2.4

...

...