.. _faq:

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

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

.. _tab_faq:

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


    +---+----------------------------------------+----------------------------------------------------------------+
    | № | Вопрос/Проблема                        | Возможная причина                                              |
    +===+========================================+================================================================+
    | 1 | Как скачать актуальный JDBC драйвер?   | 1. Драйвер можно получить по адресу                            |
    |   |                                        | http://<ваш_хост>:8182/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. При запуске на платформе CentOS/RedOS, убедитесь что        |
    |   |                                        | SELinux находится в режиме permissive или diasbled             |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 5 | В логе присутствуют сообщения          | 1. Убедитесь, что используется верный CryptoPro ключ           |
    |   | "No required SSL certificate was sent" |                                                                |
    |   |                                        | 2. Убедитесь, что указан(ы) корректный(е) адрес(а)             |
    |   |                                        | в значениях параметра                                          |
    |   |                                        |   data-center.nodes.pulsar.auth.keycloak-oauth.auth-server.url |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 6 | При выполнении запроса, запрос не      | Используемая trial лицензия CryptoPro истекла. Необходимо      |
    |   | проходит, в логе агента появляются     | приобрести лицензии на CryptoPro CSP и внести                  |
    |   | сообщения                              | информацию о ней в систему, как описано в                      |
    |   | «java.lang.IllegalStateException:      | :ref:`notarius_pre_requisites` настоящего документа            |
    |   | Ошибка вызова функции signHash: 0x65b» |                                                                |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 7 | Агент не подключается к Ядру,          | 1. Убедитесь, что используется корректный ключ                 | 
    |   | сообщения об ошибке в логах содержат   | CryptoPro, соответствующий данной информационной системе.      |
    |   | текст «invalid_client_credentials»     |                                                                |
    |   |                                        | 2. Убедитесь, что мнемоника Агента в конфигурационном файле    | 
    |   |                                        | указана корректно. Параметр agent.id                           |
    |   |                                        |                                                                |
    |   |                                        |   **Регистр учитывается!** Например, «agentMnemonic» и         |
    |   |                                        |   «agentmnemonic» - две различные мнемоники.                   |
    |   |                                        |                                                                |
    |   |                                        | 3. Обратитесь в службу поддержки для проверки корректности     |
    |   |                                        | сертификата данного Агента ПОДД, загруженного в Ядро ПОДД.     |
    |   |                                        | У вас будут запрошены дополнительные данные о подключении,     |
    |   |                                        | необходимо будет их предоставить согласно инструкции от службы |
    |   |                                        | поддержки.                                                     |
    +---+----------------------------------------+----------------------------------------------------------------+