.. _faq:

Типовые вопросы и проблемы
============================

:numref:`tab_faq` Содержит типовые ошибки, причины и решения ошибок

.. _tab_faq:

.. table:: Типовые вопросы и проблемы


    +---+----------------------------------------+-------------------------------------------------------------------+
    | № | Вопрос/Проблема                        | Возможная причина                                                 |
    +===+========================================+===================================================================+
    | 1 | Как скачать актуальный JDBC драйвер?   | 1. Драйвер можно получить по адресу                               |
    |   |                                        | http://<ваш_хост>:8192/api/v1/jdbc-driver.                        |
    +---+----------------------------------------+-------------------------------------------------------------------+
    | 2 | Как проверить соединение Агента        | 1. Воспользуйтесь запросом "SELECT 1".                            |
    |   | с Ядром ПОДД?                          |                                                                   |
    |   |                                        | 2. Воспользуйтесь командой для проверки через REST с              |
    |   |                                        | использованием утилиты curl:                                      |
    |   |                                        | ``curl -X POST -H "Accept-Version:1" -H "Content-Type:            |
    |   |                                        | application/json" -d '{"sql": {"sql": "select 1"}}'``             |
    +---+----------------------------------------+-------------------------------------------------------------------+
    | 3 | В лог-файле присутствует               | 1. Убедитесь, что контейнер с ключами выложен в                   |
    |   | ошибка: "Ошибка вызова функции         | ``/var/opt/cprocsp/keys/{{user}}/``                               |
    |   | acquireContext: 0x80090016"            |                                                                   |
    |   |                                        | - пользователь {{user}} имеет доступ на чтение к                  |
    |   |                                        | ``/var/opt/cprocsp/keys/{{user}}/``                               |
    |   |                                        |                                                                   |
    |   |                                        | 2. Убедитесь, что Notarius запускается от пользователя            |
    |   |                                        | {{user}}.                                                         |
    +---+----------------------------------------+-------------------------------------------------------------------+
    | 4 | В лог-файле присутствует ошибка        | 1. Назначьте пользователя {{user}} владельцем каталога            |
    |   | "Ошибка вызова функции acquireContext: | /var/opt/cprocsp/keys/{{user}}/ рекурсивно.                       |
    |   | 0x8009001a"                            |                                                                   |
    |   |                                        | 2. Убедитесь, что SELinux находится в режиме                      |
    |   |                                        | permissive или diasbled                                           |
    +---+----------------------------------------+-------------------------------------------------------------------+
    | 5 | В логе присутствуют сообщения          | 1. Убедитесь, что используется верный КриптоПро ключ              |
    |   | "No required SSL certificate was sent" |                                                                   |
    |   |                                        | 2. Убедитесь, что указан(ы) корректный(е) адрес(а)                |
    |   |                                        | в значениях параметра                                             |
    |   |                                        | ``data-center.nodes.pulsar.auth.keycloak-oauth.auth-server.url``  |
    +---+----------------------------------------+-------------------------------------------------------------------+
    | 6 | При выполнении запроса, запрос не      | Используемая trial лицензия КриптоПро CSP 5.0 R2 истекла.         |
    |   | проходит, в логе агента повторяются    | Необходимо приобрести лицензии на КриптоПро CSP 5.0 R2 и внести   |
    |   | сообщения                              | информацию о ней в систему, как описано в                         |
    |   | «java.lang.IllegalStateException:      | :ref:`notarius_pre_requisites` настоящего документа               |
    |   | Ошибка вызова функции signHash: 0x65b» |                                                                   |
    +---+----------------------------------------+-------------------------------------------------------------------+
    | 7 | Агент не подключается к Ядру,          | 1. Убедитесь, что используется корректный ключ                    |
    |   | сообщения об ошибке в логах содержат   | CryptoPro, соответствующий данной информационной системе.         |
    |   | текст «invalid_client_credentials»     |                                                                   |
    |   |                                        | 2. Убедитесь, что мнемоника Агента в конфигурационном файле       |
    |   |                                        | указана корректно: параметр agent.id                              |
    |   |                                        |                                                                   |
    |   |                                        | **Регистр учитывается!** Например, «agentMnemonic» и              |
    |   |                                        | «agentmnemonic» - две различные мнемоники.                        |
    |   |                                        |                                                                   |
    |   |                                        | 3. Обратитесь в службу поддержки для проверки корректности        |
    |   |                                        | сертификата данного Агента ПОДД, загруженного в Ядро ПОДД.        |
    |   |                                        | У вас будут запрошены дополнительные данные о подключении,        |
    |   |                                        | их необходимо будет предоставить согласно инструкции от службы    |
    |   |                                        | поддержки.                                                        |
    +---+----------------------------------------+-------------------------------------------------------------------+