.. _faq:

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

Также сведения о типовых ошибках приведены на `портале ЕСКС <https://info.gosuslugi.ru/articles/Типовые_ошибки_Агента_СМЭВ4/>`_

.. _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. При запуске Агента ПОДД без использования docker убедитесь, |
    |   | ошибка: "Ошибка вызова функции         | что контейнер с ключами выложен в                              |
    |   |                                        | ``/var/opt/cprocsp/keys/{{user}}/``                            |
    |   | acquireContext: 0x80090016"            |  - пользователь {{user}} имеет доступ на чтение к              |
    |   |                                        | ``/var/opt/cprocsp/keys/{{user}}/``.                           |
    |   |                                        |                                                                |
    |   |                                        | 2. Убедитесь, что Агент ПОДД запускается от пользователя       |
    |   |                                        | {{user}}. При использовании docker убедитесь, что при запуске  |
    |   |                                        | указан ключ ``--user=1000``.                                   |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 4 | В лог-файле присутствует ошибка        | 1. При использовании docker, установите владельца id=1000 на   |
    |   | "Ошибка вызова функции acquireContext: | каталог keys рекурсивно ``chown -R 1000 keys``.                |
    |   | 0x8009001a"                            |                                                                |
    |   |                                        | 2.	При запуске без использования docker, сделайте            |
    |   |                                        |пользователя {{user}} владельцем каталога                       |
    |   |                                        | /var/opt/cprocsp/keys/{{user}}/ рекурсивно.                    |
    |   |                                        |                                                                |
    |   |                                        | 3. При запуске без использования docker на платформе           |
    |   |                                        | CentOS/RedOS, убедитесь что SELinux находится в режиме         |
    |   |                                        | permissive или diasbled.                                       |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 5 | В логе присутствуют сообщения          | Убедитесь, что CryptoPro JCSP и CryptoPro CSP установлены      |
    |   | "No such provider: JCP"                | корректно (согласно данного руководства), а также путь к       |
    |   |                                        | jar файлам СryptoPro JCSP присутствует в classpath при запуске |
    |   |                                        | java.                                                          |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 6 | В логе присутствуют сообщения          | 1. Убедитесь, что используется верный ключ.                    |
    |   | "No required SSL certificate was sent" |                                                                |
    |   |                                        | 2. Убедитесь, что указан корректный адрес {{ gost_nlb }}.      |
    |   |                                        |                                                                |
    |   |                                        | 3. Убедитесь, что используется cp_ca_store, содержащий         |
    |   |                                        | необходимые цепочки для подключения к используемому Ядру ПОДД. |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 7 | При выполнении запроса, запрос не      | Используемая trial лицензия CryptoPro истекла. Необходимо      |
    |   | проходит, в логе агента появляются     | приобрести лицензии на CryptoPro CSP и JCSP и внести           |
    |   |сообщения                               | информацию о них в систему, как описано в                      |
    |   |«java.lang.IllegalStateException:       | :ref:`cryptopro_lisence` настоящего документа                  |
    |   | Ошибка вызова функции signHash: 0x65b» |                                                                |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 8 | Агент не подключается к Ядру,          | 1. Убедитесь, что используется корректный ключ                 | 
    |   | сообщения об ошибке в логах содержат   | CryptoPro, соответствующий данной информационной системе.      |
    |   | текст «invalid_client_credentials»     |                                                                |
    |   |                                        | 2. Убедитесь, что мнемоника Агента в конфигурационном файле    | 
    |   |                                        | указана корректно. Параметр agent.id                           |
    |   |                                        |                                                                |
    |   |                                        |   **Регистр учитывается!** Например, «agentMnemonic» и         |
    |   |                                        |   «agentmnemonic» - две различные мнемоники.                   |
    |   |                                        |                                                                |
    |   |                                        | 3. Обратитесь в службу поддержки для проверки корректности     |
    |   |                                        | сертификата данного Агента ПОДД, загруженного в Ядро ПОДД.     |
    |   |                                        | У вас будут запрошены дополнительные данные о подключении,     |
    |   |                                        | необходимо будет их предоставить согласно инструкции от службы |
    |   |                                        | поддержки.                                                     |
    +---+----------------------------------------+----------------------------------------------------------------+