.. _faq:

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

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

.. _tab_faq:

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


    +---+----------------------------------------+----------------------------------------------------------------+
    | № | Вопрос/Проблема                        | Возможная причина                                              |
    +===+========================================+================================================================+
    | 1 | Как скачать актуальный JDBC драйвер?   | 1. Драйвер можно получить по адресу                            |
    |   |                                        |    ``http://<ваш_хост>:8192/api/v1/jdbc-driver``.              |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 2 | Как проверить соединение Агента СМЭВ4  | 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. При запуске Агента СМЭВ4 без использования docker           |
    |   |                                        |    убедитесь, что контейнер с ключами выложен в                |
    |   | "Ошибка вызова функции                 |    ``/var/opt/cprocsp/keys/{{user}}/``                         |
    |   | acquireContext: 0x80090016"            |                                                                |
    |   |                                        |    - пользователь {{user}} имеет доступ на чтение к            |
    |   |                                        |      ``/var/opt/cprocsp/keys/{{user}}/``.                      |
    |   |                                        |                                                                |
    |   |                                        | 2. Убедитесь, что Агент СМЭВ4 запускается от пользователя      |
    |   |                                        |    {{user}}.                                                   |
    |   |                                        |                                                                |
    |   |                                        |    При использовании docker убедитесь, что при запуске         |
    |   |                                        |    указан ключ ``--user=1000``.                                |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 4 | В лог-файле присутствует ошибка        | 1. При использовании docker, установите владельца id=1000 на   |
    |   |                                        |    каталог keys рекурсивно ``chown -R 1000 keys``.             |
    |   | "Ошибка вызова функции acquireContext: |                                                                |
    |   | 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:      | :numref:`cryptopro_lisence` настоящего документа               |
    |   | Ошибка вызова функции signHash: 0x65b» |                                                                |
    +---+----------------------------------------+----------------------------------------------------------------+
    | 8 | Агент не подключается к Ядру,          | 1. Убедитесь, что используется корректный ключ                 | 
    |   | сообщения об ошибке в логах содержат   |    CryptoPro, соответствующий данной информационной системе.   |
    |   | текст «invalid_client_credentials»     |                                                                |
    |   |                                        | 2. Убедитесь, что мнемоника Агента СМЭВ4 в конфигурационном    | 
    |   |                                        |    файле указана корректно. Параметр agent.id                  |
    |   |                                        |                                                                |
    |   |                                        |    **Регистр учитывается!** Например, «agentMnemonic» и        |
    |   |                                        |    «agentmnemonic» - две различные мнемоники.                  |
    |   |                                        |                                                                |
    |   |                                        | 3. Обратитесь в службу поддержки для проверки корректности     |
    |   |                                        |    сертификата данного Агента СМЭВ4, загруженного в Ядро ПОДД  |
    |   |                                        |    СМЭВ.                                                       |
    |   |                                        |                                                                |
    |   |                                        |    У вас будут запрошены дополнительные данные о               |
    |   |                                        |    подключении, необходимо будет их предоставить согласно      |
    |   |                                        |    инструкции от службы поддержки.                             |
    +---+----------------------------------------+----------------------------------------------------------------+