.. _faq:

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

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

.. _tab_faq:

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


    +---+----------------------------------------+---------------------------------------------------------------------+
    | № | Вопрос/Проблема                        | Возможная причина                                                   |
    +===+========================================+=====================================================================+
    | 1 | Как узнать версию установленного       | Проверка версии установленного Агента СМЭВ4 осуществляется          |
    |   | Агента СМЭВ4                           | командой:                                                           |
    |   |                                        |                                                                     |
    |   |                                        | ``curl -X GET 'http://<agent-ip>:8192/api/v1/agent-info/version'``  |
    +---+----------------------------------------+---------------------------------------------------------------------+
    | 2 | Как скачать актуальный JDBC драйвер?   | Драйвер можно получить по адресу                                    |
    |   |                                        | ``http://<agent-ip>:8192/api/v1/jdbc-driver``.                      |
    +---+----------------------------------------+---------------------------------------------------------------------+
    | 2 | В лог-файле присутствует ошибка:       | 1. При запуске Агента СМЭВ4 без использования Docker                |
    |   |                                        |    убедитесь, что контейнер с ключами выложен в                     |
    |   | "Ошибка вызова функции                 |    ``/var/opt/cprocsp/keys/{{user}}/``                              |
    |   | acquireContext: 0x80090016"            |                                                                     |
    |   |                                        |    - пользователь {{user}} имеет доступ на чтение к                 |
    |   |                                        |      ``/var/opt/cprocsp/keys/{{user}}/``.                           |
    |   |                                        |                                                                     |
    |   |                                        | 2. Убедитесь, что Агент СМЭВ4 запускается от пользователя           |
    |   |                                        |    {{user}}.                                                        |
    |   |                                        |                                                                     |
    |   |                                        |    При использовании Docker убедитесь, что при запуске              |
    |   |                                        |    указан ключ ``--user=1000``.                                     |
    +---+----------------------------------------+---------------------------------------------------------------------+
    | 3 | В лог-файле присутствует ошибка        | 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.                                         |
    +---+----------------------------------------+---------------------------------------------------------------------+
    | 4 | В логе присутствуют сообщения          | 1. Убедитесь, что используется верный ключ.                         |
    |   | "No required SSL certificate was sent" |                                                                     |
    |   |                                        | 2. Убедитесь, что указан корректный адрес {{ gost_nlb }}.           |
    +---+----------------------------------------+---------------------------------------------------------------------+
    | 5 | При выполнении запроса, запрос не      | Используемая trial лицензия CryptoPro истекла.                      |
    |   | проходит, в логе агента появляются     |                                                                     |
    |   | сообщения                              | Необходимо приобрести лицензию на CryptoPro CSP и                   |
    |   |                                        | внести информацию о них в систему, как описано в                    |
    |   | «java.lang.IllegalStateException:      | :numref:`cryptopro_lisence` настоящего документа                    |
    |   | Ошибка вызова функции signHash: 0x65b» |                                                                     |
    +---+----------------------------------------+---------------------------------------------------------------------+
    | 6 | Агент не подключается к Ядру,          | 1. Убедитесь, что используется корректный ключ                      | 
    |   | сообщения об ошибке в логах содержат   |    CryptoPro, соответствующий данной информационной системе.        |
    |   | текст «invalid_client_credentials»     |                                                                     |
    |   |                                        | 2. Убедитесь, что мнемоника Агента СМЭВ4 в конфигурационном         | 
    |   |                                        |    файле указана корректно. Параметр agent.id                       |
    |   |                                        |                                                                     |
    |   |                                        |    **Регистр учитывается!** Например, «agentMnemonic» и             |
    |   |                                        |    «agentmnemonic» - две различные мнемоники.                       |
    |   |                                        |                                                                     |
    |   |                                        | 3. Обратитесь в службу поддержки для проверки корректности          |
    |   |                                        |    сертификата данного Агента СМЭВ4, загруженного в Ядро СМЭВ4      |
    |   |                                        |    СМЭВ.                                                            |
    |   |                                        |                                                                     |
    |   |                                        |    У вас будут запрошены дополнительные данные о                    |
    |   |                                        |    подключении, необходимо будет их предоставить согласно           |
    |   |                                        |    инструкции от службы поддержки.                                  |
    +---+----------------------------------------+---------------------------------------------------------------------+