Тип сервиса ServiceSowaIpa#

В контексте service объявляется соответствующий тип сервиса service_sowa_ipa:

service:
  service_sowa_ipa:

Сервис представляет собой последовательность, включающую в себя следующие параметры:

Для корректной работы сервиса service_sowa_ipa рекомендуется выполнить установку в соответствии с описанием, приведенном в разделе Процесс развертывания дистрибутива в Руководстве по установке.

Обязательные параметры:

  • id

    Идентификатор сервиса в контексте всего профиля. Используется, например, в названии директории и других системных файлах, хранящих информацию о сервисе.

    Значение параметра id должно быть уникальным.

    Идентификатор может быть строкой, числом, или их комбинацией. В качестве разделителя слов необходимо использовать знак нижнее подчеркивание « _ «.

    Количество сервисов не ограничено конфигуратором явно.

    Тип параметра: текстовое значение.

  • common

    Группа параметров, содержащих настройки адаптера, не зависящие от требуемых направлений движения данных. Является необходимым и содержит ключи, описанные ниже:

    Тип параметра: группа параметров и их значения.

    • logging_path (deprecated)

      Путь до логов данного сервиса на сервере SOWA.

      Параметр не учитывается при конфигурировании, логи располагаются по адресу /sowalogs/profile-name/services/service_sowa_ipa/servcie-id.

      Параметр оставлен для поддержки обратной совместимости.

      Тип параметра: строковое значение.

      По умолчанию: значение задается пользователем.

    • passwords_path

      Относительный путь до файла с паролями для SOWA (подробнее про этот параметр можно прочесть в разделе Формат заполнения файла с паролями). Поле является обязательным в случае взаимодействия по шифрованным протоколам - в противном случае просто опускается.

      Путь задается относительно /sowa/profile_storage/custom/ИМЯ_ПРОФИЛЯ/

      При выполнении конфигурирования (sowa-config –config) вырезает файл с паролями из данного каталога и вставляет в закрытый раздел SOWA.

      Тип параметра: строковое значение.

      По умолчанию: значение задается пользователем.

    • logging_appender_console_level

      Уровень логирования консольного appender.

      Тип параметра: строковое значение.

      По умолчанию: DEBUG.

    • logging_max_file_size

      Максимальный размер файла с логами.

      Тип параметра: строковое значение.

      По умолчанию: 100MB.

    • logging_max_history

      The optional maxHistory property controls the maximum number of archive files to keep, asynchronously deleting older files.

      Тип параметра: строковое значение.

      По умолчанию: 30.

    • logging_total_size_cap

      The optional totalSizeCap property controls the total size of all archive files

      Тип параметра: строковое значение.

      По умолчанию: 2GB.

    • logging_appender_async_file_queue_size

      The queueSize property takes an integer (greater than zero) representing the number of logging events to retain for delivery to the remote receiver.

      Тип параметра: строковое значение.

      По умолчанию: 500.

    • logging_package_org_springframework

      Категория логирования пакета.

      Тип параметра: строковое значение.

      По умолчанию: INFO.

    • logging_package_com_ibm_mq

      Категория логирования пакета.

      Тип параметра: строковое значение.

      По умолчанию: INFO.

    • logging_package_org_apache_camel

      Категория логирования пакета.

      Тип параметра: строковое значение.

      По умолчанию: INFO.

    • logging_package_org_apache_kafka

      Категория логирования пакета.

      Тип параметра: строковое значение.

      По умолчанию: INFO.

    • logging_package_ru_sbt

      Категория логирования пакета.

      Тип параметра: строковое значение.

      По умолчанию: INFO.

    • jvm_options

      Список JVM-опций для запуска сервиса sowa_ipa. Необязательный параметр.

      Тип параметра: список строковых значений.

      По умолчанию: значение задается пользователем.

      Пример:

      common:
          logging_path: path/to/log
          passwords_path: path/to/passwords
      

Опциональные параметры:

  • name

    Технологическое название сервиса, используемое для идентификации сервиса в логах транзакций.

    Значение параметра name должно быть уникальным.

    Обязательно в случае:

    optional:
      event_hook:
        ...
    

    Тип параметра: строковое значение.

    По умолчанию: значение задается пользователем.

  • profile_version

    В значении параметра определяется версия профиля данного сервиса.

    Тип параметра: текстовое значение.

    По умолчанию: значение задается пользователем.

  • description

    Параметр предназначен для хранения строки с описанием сервиса.

    Значение параметра description НЕ является уникальным.

    Тип параметра: текстовое значение.

    По умолчанию: значение задается пользователем.

  • mq_usock

    Группа параметров, описывающая направление MQ -> unix socket потребитель (в целевой модели SOWA). Состоит из двух элементов: from и to. Эта группа необходима, если отсутствует группа usock_mq на этом же уровне вложенности (но не исключается ею). Подробнее про наполнение можно почитать в подразделе «SowaIpa - mq_usock», приведенном ниже.

    Тип параметра: группа параметров и их значения.

    По умолчанию: значения группы задаются пользователем.

  • usock_mq

    Группа параметров, описывающая направление unix socket -> MQ. Состоит из двух элементов: from и to. Эта группа необходима, если отсутствует группа mq_usock на этом же уровне вложенности (но не исключается ею). Подробнее про наполнение можно почитать в подразделе «SowaIpa - usock_mq», приведенном ниже.

    Тип параметра: группа параметров и их значения.

    По умолчанию: значения группы задаются пользователем.

  • kafka_usock

    Группа параметров, описывающая направление Kafka -> unix socket потребитель (в целевой модели SOWA). Состоит из двух элементов: from и to. Эта группа необходима, если отсутствует группа usock_kafka на этом же уровне вложенности (но не исключается ею). Подробнее про наполнение можно почитать в подразделе «SowaIpa - kafka_usock», приведенном ниже.

    Тип параметра: группа параметров и их значения.

    По умолчанию: значения группы задаются пользователем.

  • usock_kafka

    Группа параметров, описывающая направление unix socket -> Kafka. Состоит из двух элементов: from и to. Эта группа необходима, если отсутствует группа kafka_usock на этом же уровне вложенности (но не исключается ею). Подробнее про наполнение можно почитать в подразделе «SowaIpa - usock_kafka», приведенном ниже.

    Тип параметра: группа параметров и их значения.

    По умолчанию: значения группы задаются пользователем.

SоwaIpa - kafka_usock#

Группа параметров kafka_usock отвечает за взаимодействие по направлению Kafka→unix socket и описывает все необходимые параметры для выполнения соответствующей интеграции. В целевой модели использования, производителем данных, передаваемых адаптеру по протоколу Kafka, является SOWA, так что все настройки нужно рассматривать в этом контексте. Данная группа содержит два элемента: from и to - каждый из которых является обязательным. from описывает Kafka канал, по которому адаптер получает данные, которые впоследствии должен будет переложить в unix socket канал, описанный в to. Кроме того, стоит учесть, что для необязательных параметров не существует значений по умолчанию (за исключением kafka_commit_interval). Если что-то пропущено, то адаптер просто не получит соответствующую настройку и опирающийся на нее механизм не будет запущен.

При использовании синхронного взаимодействия, для записи в topic пары ключ-значение, ключ необходимо передавать в HTTP заголовке kafka-KEY. В противном случае, значение ключа - null.

При использовании опции auto_commit = FALSE фиксация смещения происходит только после успешного прохождения маршрута (кода ответа 200). В случае, если на маршруте может возникнуть ошибка валидации или иные ошибки, при которых фиксация смещения должна выполняться, для корректной работы маршрута необходимо использовать ключ postprocessors в сервисе http_proxy.

from является группой параметров и включает в себя следующие параметры:

Обязательные параметры:

  • brokers

    Список URL брокеров.

    Тип параметра: список (Sequence).

  • group_id

    Группа, к которой принадлежит потребитель.

    Тип параметра: строковое значение.

  • topics

    Список тем, на которые производится подписка.

    Тип параметра: список (Sequence).

  • auto_commit

    Если TRUE, автоматически фиксирует смещения в соответствии с временным интервалом, заданным в параметре auto_commit_interval.

    Если FALSE, то фиксация смещения происходит после успешного прохождения маршрута.

    Тип параметра: булево значение.

Опциональные параметры:

  • client_id

    Идентификатор клиента. Используется брокером для журналирования, отслеживания записей и задания квот.

    Тип параметра: строковое значение.

  • auto_commit_interval

    Интервал автоматической фиксации смещений. Представляет собой значение в мс.

    Тип параметра: целочисленное значение.

    По умолчанию: 5000.

  • auto_offset_reset

    Указание, что делать в случае, если начальное смещение отсутствует или оно вне диапазона значений.

    Может принимать следующие значения:

    • «earliest» - переключение смещения на самое раннее;

    • «latest» - переключение смещения на самое позднее;

    • «none» - выбрасывается исключение, если для группы потребителя не найдено предыдущее значение смещения.

    Тип параметра: список.

    По умолчанию: «earliest».

  • fetch_max_bytes

    Максимальное количество данных, возвращаемое сервером на fetch-запрос, в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 52428800.

  • fetch_min_bytes

    Минимальное количество данных, возвращаемое сервером на fetch-запрос, в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 1.

  • fetch_min_bytes

    Минимальное количество данных, возвращаемое сервером на fetch-запрос, в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 1.

  • fetch_wait_max_ms

    Таймаут ожидания ответа на fetch-запрос, в мс.

    Тип параметра: целочисленное значение.

    По умолчанию: 500.

  • max_poll_records

    Максимальное число записей, возвращаемых на запрос.

    Тип параметра: целочисленное значение.

    По умолчанию: 500.

  • session_timeout_ms

    Таймаут, используемый для обнаружения сбоев при использовании средств управления группами Kafka.

    Тип параметра: целочисленное значение.

    По умолчанию: 10000.

  • consumers_count

    Количество потребителей, создаваемых и подключающихся к Kafka-серверу.

    Тип параметра: целочисленное значение.

    По умолчанию: 1.

  • consumer_streams

    Параметр не рекомендован к использованию. Будет удален в ближайших версиях.

    Размер пула потоков потребителей.

    Тип параметра: целочисленное значение.

    По умолчанию: 10.

  • ssl_keystore_path

    Путь до файла хранилища ключей. Используется для двусторонней TLS(SSL)-аутентификации. Поддерживает возможность установить как абсолютный путь до хранилища, так и относительный от /sowa/profile_storage/custom/ИМЯ_ПРОФИЛЯ/.

    Тип параметра: строковое значение.

  • ssl_truststore_path

    Путь до файла хранилища доверенных сертификатов. Используется для установления TLS(SSL)-соединения. Особенности установки путей аналогичны ssl_keystore_path.

    Тип параметра: строковое значение.

  • ssl_truststore_path

    Путь до файла хранилища доверенных сертификатов. Используется для установления TLS(SSL)-соединения. Особенности установки путей аналогичны ssl_keystore_path.

    Тип параметра: строковое значение.

  • ssl_truststore_path

    Путь до файла хранилища доверенных сертификатов. Используется для установления TLS(SSL)-соединения. Особенности установки путей аналогичны ssl_keystore_path.

    Тип параметра: строковое значение.

  • ssl_endpoint_algorithm

    Алгоритм идентификации для соединения по TLS(SSL).

    Тип параметра: строковое значение.

  • ssl_cipher_suite

    Алгоритм шифрования SSL.

    Со списком доступных значений шифрования можно ознакомиться на сайте https://www.openssl.org/docs/man1.1.1/man1/ciphers.html. Для сервиса service_sowa_ipa указывается IANA (Internet Assigned Numbers Authority) название алгоритма шифрования. При указании нескольких шифров используется разделитель «,».

    Стоит иметь в виду, что набор шифров для конкретного взаимодействия определяется соответствующими требованиями безопасности эксплуатирующей организации.

    Тип параметра: текстовое значение.

  • rs_brokers

    (Синхрон) Список URL брокеров.

    Тип параметра: список.

  • rs_client_id

    (Синхрон) Идентификатор клиента. Используется брокером для журналирования, отслеживания записей и задания квот.

    Тип параметра: строковое значение.

  • rs_request_required_acks

    (Синхрон) Количество подтверждений, которые производитель требует от брокера, прежде чем считать запрос завершенным.

    Возможны следующие значения данного поля:

    • «0» - производитель не ждет подтверждения от лидера;

    • «1» - лидер добавляет запись в свой локальный журнал, но отвечает, не дожидаясь полного подтверждения от всех подписчиков;

    • «-1» или «all» - лидер будет ожидать полного набора синхронных реплик для подтверждения записи.

    Тип параметра: список.

    По умолчанию: -1.

  • rs_batch_size

    (Синхрон) Размер пакета записей на отправку в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 16384.

  • rs_buffer_memory_size

    (Синхрон) Объем буфера, хранящего сообщения перед отправкой, в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 33554432.

  • rs_partition_key

    (Синхрон) Раздел topic, в который необходимо произвести запись.

    Данный параметр можно сделать динамическим, передавая значение в HTTP заголовке kafka-PARTITION_KEY.

    В случае отсутствия данного параметра, раздел topic выбирается автоматически, в зависимости от значения ключа.

    Тип параметра: целочисленное значение.

  • rs_linger_ms

    (Синхрон) Задержка группировки сообщений перед отправкой запроса.

    Тип параметра: целочисленное значение.

    По умолчанию: 0.

  • rs_request_timeout_ms

    (Синхрон) Таймаут получения request.required.acks, в мс.

    Тип параметра: целочисленное значение.

    По умолчанию: 305000.

  • rs_enable_idempotence

    (Синхрон) Включение идемпотентности.

    Тип параметра: булево значение.

    По умолчанию: false.

  • rs_max_request_size

    (Синхрон) Максимальный размер запроса.

    Тип параметра: целочисленное значение.

    По умолчанию: 1048576.

  • rs_max_block_ms

    (Синхрон) Ограничение на общее время, затрачиваемое на получение метаданных, в мс.

    Тип параметра: целочисленное значение.

    По умолчанию: 60000.

  • rs_retries

    (Синхрон) Количество попыток повторной отправки сообщения после получения ошибки.

    Тип параметра: целочисленное значение.

    По умолчанию: 0.

  • rs_ssl_keystore_path

    (Синхрон) Путь до файла хранилища ключей. Используется для двусторонней TLS(SSL)-аутентификации. Поддерживается возможность установить как абсолютный путь до хранилища, так и относительный от /sowa/profile_storage/custom/ИМЯ_ПРОФИЛЯ/.

    Тип параметра: строковое значение.

    По умолчанию: 0.

  • rs_ssl_truststore_path

    (Синхрон) Путь до файла хранилища доверенных сертификатов. Используется для установления TLS(SSL)-соединения. Особенности передачи пути аналогичны тому, что описаны для параметра ssl_keystore_path.

    Тип параметра: строковое значение.

    По умолчанию: 0.

  • rs_ssl_endpoint_algorithm

    (Синхрон) Алгоритм идентификации для соединения по TLS(SSL).

    Тип параметра: строковое значение.

  • key_deserializer

    Десериализатор ключей в kafka.

    Тип параметра: текстовое значение.

    • „String“;

    • „ByteArray“.

  • value_deserializer

    Десериализатор значений в kafka.

    Тип параметра: текстовое значение.

    • „String“;

    • „ByteArray“. to является списком из группы параметров для подключения к unix socket.

Каждая группа параметров включает в себя следующие параметры:

Обязательные параметры:

  • service_id

    Id сервиса для подключения к серверу unix socket.

    Тип параметра: строковое значение.

  • service_type

    Тип сервиса для подключения к серверу unix socket.

    Тип параметра: строковое значение с корректным наименованием типа сервиса (пример -«service_http_proxy»).

Опциональные параметры:

  • headers_whitelist

    Список разрешенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Данный параметр имеет больший приоритет, чем headers_blacklist (При его использовании параметр headers_blacklist игнорируется).

    Тип параметра: список.

  • headers_blacklist

    Список запрещенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: список.

  • content_type

    В значении параметра определяется тип содержимого запроса.

    Тип параметра: строковое значение.

    Пример:

    to:
      - route_id: '*'
        service_id: async_mq_usock_socket_http
        service_type: service_http_proxy
        content_type: application/json
    

Пример асинхронного сервиса:

service_sowa_ipa:
    - id: async_kafka_usock
      common:
        logging_package_org_apache_camel: DEBUG
        logging_package_org_springframework: DEBUG
        logging_package_ru_sbt: DEBUG
        passwords_path: passwords_ipa.properties
      kafka_usock:
        from:
          auto_commit: true
          auto_commit_interval: 10000
          auto_offset_reset: latest
          brokers:
            - 10.x.x.x:9092
          client_id: consumerClient
          fetch_max_bytes: 1488
          group_id: group1
          topics:
            - AsyncKafkaUsockTopic
        to:
          service_id: async_kafka_usock_socket_http
          service_type: service_http_proxy

Пример синхронного сервиса:

service_sowa_ipa:
    - id: sync_kafka_usock
      common:
        logging_package_org_apache_camel: DEBUG
        logging_package_org_springframework: DEBUG
        logging_package_ru_sbt: DEBUG
        passwords_path: passwords_ipa.properties
      kafka_usock:
        from:
          auto_commit: true
          auto_commit_interval: 10000
          auto_offset_reset: latest
          brokers:
            - 10.x.x.x:9092
          client_id: consumerClient
          fetch_max_bytes: 1488
          group_id: group1
          rs_brokers:
            - 10.x.x.x:9092
          rs_topic: SyncKafkaUsockRsTopic
          topics:
            - SyncKafkaUsockRqTopic
        to:
          service_id: sync_kafka_usock_socket_http
          service_type: service_http_proxy

SоwaIpa - mq_usock#

Группа параметров mq_usock отвечает за взаимодействие по направлению MQ → unix socket и описывает все необходимые настройки для выполнения соответствующей интеграции. В целевой модели потребителем данных по протоколу unix socket является SOWA.

Внимание! При соединении с service_http_proxy для стабильной работы необходимо задавать в последнем следующий параметр:

modifiers:
  set_header:
    - Host IPA

Эта группа параметров разделяется на две группы: from и to - каждый из которых является группой параметров. from описывает параметры очереди, из которой будут считываться данные, а to - адресата, которому эти данные будут передаваться по протоколу unix socket.

from включает в себя следующие параметры:

  • rq_queue

    Имя очереди, обязательно, если не задано имя topic rq_topic.

    Тип параметра: строковое значение.

  • rq_name

    Имя MQ менеджера.

    Тип параметра: строковое значение.

  • rq_hostname

    Хост MQ соединения.

    Тип параметра: строковое значение с корректным IPv4 адресом или псевдонимом сервера.

  • rq_port

    Порт MQ соединения.

    Тип параметра: целочисленное значение от 1 до 65535.

  • rq_channel

    Канал соединения.

    Тип параметра: строковое значение.

  • rq_topic

    Имя topic, обязательно, если не задано имя очереди rq_queue, соотносится с параметром MQ TOPICOBJ.

    Тип параметра: строковое значение.

Опциональные параметры:

  • rq_user_id

    Имя пользователя. Данное поле необходимо, когда менеджер требует авторизации по user_id и паролю (который в свою очередь должен присутствовать в файле с паролями из блока common). Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: строковое значение.

  • rq_ssl_cert_store

    Путь до хранилища TLS(SSL) сертификатов на сервере SOWA. Данное поле необходимо, если взаимодействие с MQ брокером предусматривает шифрование. Если в данном параметре нет необходимости, должно быть просто опущено. Поддерживается возможность установить как абсолютный путь до хранилища, так и относительный от /sowa/profile_storage/custom/ИМЯ_ПРОФИЛЯ/.

    Тип параметра: строковое значение.

  • rq_ssl_cipher_suite

    Спецификатор алгоритма шифрования TLS(SSL) соединения. Данное поле необходимо, если взаимодействие с MQ брокером предусматривает шифрование. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: строковое значение из списка.

  • rq_poll_delay (deprecated, см. rq_reconnect_delay)

    rq_reconnect_delay

    rq_poll_delay - интервал, с которым IPA будет опрашивать очередь.

    rq_reconnect_delay - интервал, через который будет происходить реконнект к очереди.

    Тип параметра: целочисленное значение.

    По умолчанию 500мс.

  • rq_threads (после версии 80919)

    Количество потоков, которые будут читать из очереди MQ.

    Тип параметра: целочисленное значение.

    По умолчанию 5.

  • rq_reconnect_on_startup

    Флаг необходимости переподключения к MQ менеджеру для восстановления работоспособности.

    Тип параметра: булево значение.

    По умолчанию: false.

  • rq_topic_string

    Идентификатор topic, соотносится с параметром MQ TOPICSTR.

    Тип параметра: строковое значение.

  • rq_subscription_name

    Имя подписки, соотносится с параметром MQ SUBNAME.

    Тип параметра: строковое значение.

  • rq_topic_durability

    Отвечает за опцию MQSO_DURABLE/MQSO_NON_DURABLE при подписке.

    Тип параметра: булевое значение.

  • rq_rfh_routing_header

    Отвечает за маршрутизацию запроса и представляет собой имя заголовка, в котором передается имя сервиса.

    Тип параметра: строковое значение.

  • rq_rfh_routing_header

    Отвечает за маршрутизацию запроса и представляет собой имя заголовка, в котором передается имя сервиса.

    Тип параметра: строковое значение.

  • rq_alternate_user_id

    Параметр, необходимый если задан ALTERNATE_USER_AUTHORITY.

    Тип параметра: строковое значение.

  • rs_queue

    [Синхрон] Имя очереди.

    Тип параметра: строковое значение.

  • rs_name

    [Синхрон] Имя MQ менеджера.

    Тип параметра: строковое значение.

  • rs_hostname

    [Синхрон] Хост MQ соединения.

    Тип параметра: строковое значение с корректным IPv4 адресом или псевдонимом сервера.

  • rs_port

    [Синхрон] Порт MQ соединения.

    Тип параметра: целочисленное значение от 1 до 65535.

  • rs_channel

    [Синхрон] Канал соединения.

    Тип параметра: строковое значение.

  • rs_topic

    [Синхрон] Имя topic, соотносится с параметром MQ TOPICOBJ.

    Тип параметра: строковое значение.

  • rs_topic_string

    [Синхрон] Идентификатор topic, соотносится с параметром MQ TOPICSTR.

    Тип параметра: строковое значение.

  • rs_subscription_name

    [Синхрон] Имя подписки, соотносится с параметром MQ SUBNAME.

    Тип параметра: строковое значение.

  • rs_alternate_user_id

    [Синхрон] Параметр, необходимый если задан ALTERNATE_USER_AUTHORITY.

    Тип параметра: строковое значение.

  • rs_user_id

    [Синхрон] Имя пользователя. Данное поле необходимо, когда менеджер требует авторизации по user_id и паролю (который в свою очередь должен присутствовать в файле с паролями из блока common). Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: строковое значение.

  • rs_payload_charset

    [Синхрон] Параметр, задающий чарсет тела, использующийся при записи сообщения в очередь.

    Тип параметра: строковое значение.

  • rs_ssl_cert_store

    [Синхрон] Путь до хранилища TLS(SSL) сертификатов на сервере SOWA. Данное поле необходимо, если взаимодействие с MQ брокером предусматривает шифрование. Если в данном параметре нет необходимости, должно быть просто опущено. Особенности передачи пути аналогичны тому, что описаны для параметра rq_ssl_cert_store.

    Тип параметра: строковое значение.

  • rs_ssl_cipher_suite

    [Синхрон] Спецификатор алгоритма шифрования TLS(SSL) соединения. Данное поле необходимо, если взаимодействие с MQ брокером предусматривает шифрование. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: строковое значение из списка.

to включает в себя параметры, описанные ниже:

Обязательные параметры:

  • route_id

    Идентификатор unix socket маршрута. Есть возможность маршрутизировать сообщения из mq в различные http_proxy по заголовкам из домена usr ServiceName и ServiceVersion, задавая различные route_id виде: ServiceName, если есть только ServiceName, ServiceName.v.ServiceVersion если есть оба заголовка и «*» если нету ни одного.

    Тип параметра: уникальное строковое значение.

  • service_id

    ID сервиса для подключения к серверу unix socket.

    Тип параметра: строковое значение.

  • service_type

    Тип сервиса для подключения к серверу unix socket.

    Тип параметра: строковое значение с корректным наименованием типа сервиса (пример -«service_http_proxy»).

Опциональные параметры:

  • headers_whitelist

    Список разрешенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: список.

  • headers_blacklist

    Список запрещенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: список.

  • content_type

    В значении параметра определяется тип содержимого запроса.

    Тип параметра: строковое значение.

    Пример:

    to:
      - route_id: '*'
        service_id: async_mq_usock_socket_http
        service_type: service_http_proxy
        content_type: application/json
    
  • proxy_rfh2_folders

    Список проксируемых MQ папок. по умолчанию, если список не объявлен, то он состоит из usr.

    Используется в случае:

    rq_pass_http_headers is None.

    Тип параметра: последовательность текстовых значений.

Стоит отметить, что на маршруте mq-usock по умолчанию все rfh2.usr заголовки трансформируются в http заголовки. В случае, если необходимо прокидывать другие rfh2 заголовки, то нужно использовать параметр proxy_rfh2_folders, где необходимо указать список проксируемых папок.

На уровне http rfh2 заголовки преобразуются к виду mq-rfh2-folder-<folder_name>-<field_name> (для usr - просто field_name).

Пример асинхронного сервиса:

service_sowa_ipa:
  - id: async_mq_usock
    common:
      logging_package_org_apache_camel: DEBUG
      logging_package_org_springframework: DEBUG
      logging_package_ru_sbt: DEBUG
      passwords_path: passwords_ipa.properties
    mq_usock:
      from:
        rq_channel: SVRCONN.SSL
        rq_hostname: 10.x.x.x
        rq_name: DEV.1.QMGR
        rq_port: 1415
        rq_queue: USOCK.ASYNC.FROM
        rq_reconnect_on_startup: true
        rq_ssl_cert_store: client_ipa.jks
        rq_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
      to:
        - route_id: '*'
          service_id: async_mq_usock_socket_http
          service_type: service_http_proxy
        - route_id: test
          service_id: async_mq_usock_socket_http_test
          service_type: service_http_proxy

Пример синхронного сервиса:

service_sowa_ipa:
  - id: sync_mq_usock
    common:
      logging_package_org_apache_camel: DEBUG
      logging_package_org_springframework: DEBUG
      logging_package_ru_sbt: DEBUG
      passwords_path: passwords_ipa.properties
    mq_usock:
      from:
        rq_channel: SVRCONN.SSL
        rq_hostname: 10.x.x.x
        rq_name: DEV.1.QMGR
        rq_port: 1415
        rq_queue: MQ.SYNC.FROM
        rq_reconnect_on_startup: true
        rq_ssl_cert_store: client_ipa.jks
        rq_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
        rs_channel: SVRCONN.SSL
        rs_hostname: 10.x.x.x
        rs_name: DEV.1.QMGR
        rs_port: 1415
        rs_queue: MQ.SYNC.TO
        rs_ssl_cert_store: client_ipa.jks
        rs_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
      to:
        - route_id: '*'
          service_id: sync_mq_usock_socket_http
          service_type: service_http_proxy
        - route_id: test
          service_id: sync_mq_usock_socket_http_test
          service_type: service_http_proxy

SоwaIpa - usock_kafka#

Группа параметров usock_kafka отвечает за взаимодействие по направлению unix socket→Kafka и описывает все необходимые параметры для выполнения соответствующей интеграции. В целевой модели использования, производителем данных, передаваемых адаптеру по протоколу unix socket, является SOWA, так что все настройки нужно рассматривать в этом контексте. Данная группа содержит два элемента: from и to - каждый из которых является обязательным. from описывает unix socket канал, по которому адаптер получает данные, которые впоследствии должен будет переложить в Kafka канал, описанный в to. Кроме того, стоит учесть, что для необязательных параметров не существует значений по умолчанию. Если что-то пропущено, то адаптер просто не получит соответствующую настройку и опирающийся на нее механизм не будет запущен.

Для записи в topic пары ключ-значение, ключ необходимо передавать в HTTP заголовке kafka-KEY. В противном случае, значение ключа - null.

from является группой параметров и включает в себя следующие параметры:

Обязательные параметры:

  • usock_socket_timeout

    Время ожидания ответа в сокет, мс.

    Тип параметра: целочисленное значение.

  • usock_busy_timeout

    Время ожидания в случае занятого сервера, мс.

    Тип параметра: целочисленное значение.

  • usock_max_concurrent_connections

    Количество коннектов к серверному сокету.

    Тип параметра: целочисленное значение.

to является списком из группы параметров для Kafka подключения.

Каждая группа параметров включает в себя следующие параметры::

Обязательные параметры:

  • brokers

    Список URL брокеров.

    Тип параметра: список.

  • topic

    Тема, в которую производится запись.

    Тип параметра: строковое значение.

Опциональные параметры:

  • client_id

    Идентификатор клиента. Используется брокером для журналирования, отслеживания записей и задания квот.

    Тип параметра: строковое значение.

  • request_required_acks

    Количество подтверждений, которые производитель требует от брокера, прежде чем считать запрос завершенным.

    Возможны следующие значения данного поля:

    • «0» - производитель не ждет подтверждения от лидера;

    • «1» - лидер добавляет запись в свой локальный журнал, но отвечает, не дожидаясь полного подтверждения от всех подписчиков;

    • «-1» или «all» - лидер будет ожидать полного набора синхронных реплик для подтверждения записи.

    Тип параметра: перечисление.

    По умолчанию: -1.

  • batch_size

    Размер пакета записей на отправку в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 16384.

  • buffer_memory_size

    Объем буфера, хранящего сообщения перед отправкой, в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 33554432.

  • partition_key

    Раздел topic, в который необходимо произвести запись.

    Данный параметр можно сделать динамическим, передавая значение в HTTP заголовке kafka-PARTITION_KEY.

    В случае отсутствия данного параметра, раздел topic выбирается автоматически, в зависимости от значения ключа.

    Тип параметра: целочисленное значение.

  • linger_ms

    Задержка группировки сообщений перед отправкой запроса.

    Тип параметра: целочисленное значение.

    По умолчанию: 0.

  • request_timeout_ms

    Таймаут получения request.required.acks, в мс.

    Тип параметра: целочисленное значение.

    По умолчанию: 305000.

  • enable_idempotence

    Включение идемпотентности.

    Тип параметра: булево значение.

    По умолчанию: false.

  • max_request_size

    Максимальный размер запроса.

    Тип параметра: целочисленное значение.

    По умолчанию: 1048576.

  • max_block_ms

    Ограничение на общее время, затрачиваемое на получение метаданных, в мс.

    Тип параметра: целочисленное значение.

    По умолчанию: 60000.

  • retries

    Количество попыток повторной отправки сообщения после получения ошибки.

    Тип параметра: целочисленное значение.

    По умолчанию: 0.

  • ssl_keystore_path

    Путь до файла хранилища ключей. Используется для двусторонней TLS(SSL)-аутентификации. Поддерживается возможность установить как абсолютный путь до хранилища, так и относительный от /sowa/profile_storage/custom/ИМЯ_ПРОФИЛЯ/.

    Тип параметра: строковое значение.

  • ssl_truststore_path

    Путь до файла хранилища доверенных сертификатов. Используется для установления TLS(SSL)-соединения. Особенности установки путей аналогичны ssl_keystore_path.

    Тип параметра: строковое значение.

  • ssl_endpoint_algorithm

    Алгоритм идентификации для соединения по TLS(SSL).

    Тип параметра: строковое значение.

  • ssl_cipher_suite

    Алгоритм шифрования SSL.

    Тип параметра: текстовое значение.

  • headers_whitelist

    Список разрешенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Данный параметр имеет больший приоритет, чем headers_blacklist (При его использовании параметр headers_blacklist игнорируется).

    Тип параметра: список.

  • headers_blacklist

    Список запрещенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: список.

  • rs_brokers

    (Синхрон) Список URL брокеров.

    Тип параметра: список.

  • rs_client_id

    (Синхрон) Идентификатор клиента. Используется брокером для журналирования, отслеживания записей и задания квот.

    Тип параметра: строковое значение.

  • rs_group_id

    (Синхрон) Группа, к которой принадлежит потребитель.

    Тип параметра: строковое значение.

  • rs_fetch_max_bytes

    (Синхрон) Максимальное количество данных, возвращаемое сервером на fetch-запрос, в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 52428800.

  • rs_fetch_min_bytes

    (Синхрон) Минимальное количество данных, возвращаемое сервером на fetch-запрос, в байтах.

    Тип параметра: целочисленное значение.

    По умолчанию: 1.

  • rs_fetch_wait_max_ms

    (Синхрон) Таймаут ожидания ответа на fetch-запрос, в мс.

    Тип параметра: целочисленное значение.

    По умолчанию: 500.

  • rs_max_poll_records

    (Синхрон) Максимальное число записей, возвращаемых на запрос.

    Тип параметра: целочисленное значение.

    По умолчанию: 500.

  • rs_session_timeout_ms

    (Синхрон) Таймаут, используемый для обнаружения сбоев при использовании средств управления группами Kafka.

    Тип параметра: целочисленное значение.

    По умолчанию: 10000.

  • rs_topic

    (Синхрон) Тема, из которой принимается ответ.

    Тип параметра: строковое значение.

  • rs_timeout

    (Синхрон) Таймаут получения ответа в мс.

    Обратите внимание, что значение данного параметра не оказывает влияние на значения параметров сервиса http_proxy (в числе прочего, client_header_timeout, client_body_timeout и session_timeout). Убедитесь в том, что значения параметров синхронизированы.

    Тип параметра: целочисленное значение.

    По умолчанию: 10000.

  • rs_ssl_keystore_path

    (Синхрон) Путь до файла хранилища ключей. Используется для двусторонней TLS(SSL)-аутентификации. Поддерживается возможность установить как абсолютный путь до хранилища, так и относительный от /sowa/profile_storage/custom/ИМЯ_ПРОФИЛЯ/.

    Тип параметра: строковое значение.

  • rs_ssl_truststore_path

    (Синхрон) Путь до файла хранилища доверенных сертификатов. Используется для установления TLS(SSL)-соединения. Особенности передачи пути аналогичны тому, что описаны для параметра ssl_keystore_path.

    Тип параметра: строковое значение.

  • rs_ssl_endpoint_algorithm

    (Синхрон) Алгоритм идентификации для соединения по TLS(SSL).

    Тип параметра: строковое значение.

  • rs_ssl_cipher_suite

    Спецификатор алгоритма шифрования SSL соединения. Данное поле необходимо, если взаимодействие с kafka предусматривает шифрование.

    Тип параметра: текстовое значение.

  • key_serializer

    Сериализатор ключей в kafka.

    Тип параметра: текстовое значение.

    • „String“;

    • „ByteArray“.

  • value_serializer

    Сериализатор значений в kafka.

    Тип параметра: текстовое значение.

    • „String“;

    • „ByteArray“. Пример асинхронного сервиса:

service_sowa_ipa:
    - id: async_usock_kafka
      common:
        logging_package_org_apache_camel: DEBUG
        logging_package_org_springframework: DEBUG
        logging_package_ru_sbt: DEBUG
        passwords_path: passwords_ipa.properties
      usock_kafka:
        from:
          usock_busy_timeout: 100
          usock_max_concurrent_connections: 10
          usock_socket_timeout: 100
        to:
          batch_size: 1489
          brokers:
            - 10.x.x.x:9092
          buffer_memory_size: 8512
          client_id: producerClient
          request_required_acks: all
          topic: AsyncUsockKafkaTopic

Пример синхронного сервиса:

service_sowa_ipa:
    - id: sync_usock_kafka
      common:
        logging_package_org_apache_camel: DEBUG
        logging_package_org_springframework: DEBUG
        logging_package_ru_sbt: DEBUG
        passwords_path: passwords_ipa.properties
      usock_kafka:
        from:
          usock_busy_timeout: 100
          usock_max_concurrent_connections: 10
          usock_socket_timeout: 100
        to:
          batch_size: 1489
          brokers:
            - 10.x.x.x:9092
          topic: SyncUsockKafkaTopic
          buffer_memory_size: 8512
          client_id: producerClient
          request_required_acks: all
          rs_brokers:
            - 10.x.x.x:9092
          rs_group_id: ll
          rs_timeout: 120000
          rs_topic: SyncUsockKafkaRsTopic

SоwaIpa - usock_mq#

Группа параметров usock_mq отвечает за взаимодействие по направлению unix socket→MQ и описывает все необходимые параметры для выполнения соответствующей интеграции. В целевой модели использования, производителем данных, передаваемых адаптеру по протоколу unix socket, является SOWA, так что все настройки нужно рассматривать в этом контексте.

Внимание! При соединении с service_http_proxy для стабильной работы необходимо задавать в последнем следующий параметр:

modifiers:
  set_header:
    - Host IPA

Данная группа содержит два элемента: from и to - каждый из которых является обязательным. from описывает unix socket канал, по которому адаптер получает данные, которые впоследствии должен будет переложить в MQ каналы, описанные в to. Стоит отдельно отметить, что, несмотря на одностороннюю природу данной группы настроек, может возникнуть ситуация, когда требуется некоторая синхронизация запроса, проходящего по этому направлению, и ответа, идущего в обратном. Эта деталь описывается в блоке to. Кроме того, стоит учесть, что для необязательных параметров не существует значений по умолчанию. Если что-то пропущено, то адаптер просто не получит соответствующую настройку и опирающийся на нее механизм не будет запущен.

from является группой параметров и включает в себя следующие параметры:

Обязательные параметры:

  • usock_socket_timeout

    Время ожидания ответа в сокет, мс.

    Тип параметра: целочисленное значение.

  • usock_busy_timeout

    Время ожидания в случае занятого сервера, мс.

    Тип параметра: целочисленное значение.

  • usock_max_concurrent_connections

    Количество коннектов к серверному сокету.

    Тип параметра: целочисленное значение.

to является последовательностью, каждый элемент которой содержит описание одного MQ подключения и представляет собой группу параметров. NB. Каждый элемент секвенции содержит в себе параметры, которые могут быть логически разбиты на три подгруппы по однородности: одиночный параметр route_id и два набора параметров с префиксами rq и rs, отвечающие за «запрос» и «ответ» соответственно. Механически соответствующие параметры этих наборов устроены одинаково. Семантическая же разница заключается именно в механизме запрос-ответ для каждого роута.

Каждая группа параметров включает в себя следующие параметры:

Обязательные параметры:

  • route_id

    Идентификатор MQ роута. Важно! Данный идентификатор используется для маршрутизации запросов внутри адаптера и должен совпадать с контекстом запроса. Пример: Если route_id: testRoute, то к данном блоку снаружи можно будет обратиться http://host:port/testRoute. В случае, если необходимо использовать пустой контекст, можно использовать route_id: * . В таком случае к блоку можно будет обратиться через http://host:port.

    Тип параметра: уникальное строковое значение.

  • rq_topic

    Идентификатор topic. Данное поле может быть опущено, если заполнено поле rq_queue.

    Тип параметра: строковое значение.

  • rq_queue

    Имя очереди. Данное поле может быть опущено, если заполнено поле rq_topic.

    Тип параметра: строковое значение.

  • rq_name

    Имя MQ менеджера. В случае, если требуется подключение к кластеру, то следует вместо имени менеджера писать „*“ (в кавычках) Таким образом, подключение не будет привязано к конкретному менеджеру.

    Тип параметра: строковое значение.

  • rq_hostname

    Хост MQ соединения.

    Тип параметра: строковое значение с корректным IPv4 адресом или псевдонимом сервера.

  • rq_port

    Порт MQ соединения.

    Тип параметра: целочисленное значение от 1 до 65535.

  • rq_channel

    Канал соединения.

    Тип параметра: строковое значение.

Опциональные параметры:

  • rq_user_id

    Имя пользователя. Данное поле необходимо, когда менеджер требует авторизации по user_id и паролю (который в свою очередь должен присутствовать в файле с паролями из блока common). Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: строковое значение.

  • headers_whitelist

    Список разрешенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: список.

  • headers_blacklist

    Список запрещенных заголовков. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: список.

  • rq_ssl_cert_store

    Путь до хранилища TLS(SSL) сертификатов на сервере SOWA. Данное поле необходимо, если взаимодействие с MQ брокером предусматривает шифрование. Если в данном параметре нет необходимости, должно быть просто опущено. Поддерживается возможность установить как абсолютный путь до хранилища, так и относительный от /sowa/profile_storage/custom/ИМЯ_ПРОФИЛЯ/.

    Тип параметра: строковое значение.

  • rq_ssl_cipher_suite

    Спецификатор алгоритма шифрования TLS(SSL) соединения. Данное поле необходимо, если взаимодействие с MQ брокером предусматривает шифрование. Если в данном параметре нет необходимости, должно быть просто опущено.

    Тип параметра: строковое значение из списка.

  • rq_payload_charset

    Параметр, задающий чарсет тела, использующийся при записи сообщения в очередь.

    Тип параметра: строковое значение.

  • rq_pass_http_headers

    Параметр определяет, записывать ли заголовки в rfh2 usr.

    Используется в случае:

    proxy_rfh2_folders is None.

    Тип параметра: булево значение.

  • proxy_rfh2_folders

    Список проксируемых MQ папок. по умолчанию, если список не объявлен, то он состоит из usr.

    Используется в случае:

    rq_pass_http_headers is None.

    Тип параметра: последовательность текстовых значений.

  • rq_use_string_format_for_rfh2

    Задает формат строки для rfh2.

  • rq_jms_type

    Параметр, задающий jms тип тела сообщения, которое запишется в MQ. В настоящий момент поддерживаются значения byte и text. По умолчанию выбирается byte.

    Тип параметра: строковое значение.

  • rq_managers_count

    Параметр, задающий количество подключений к менеджеру очередей для записи. В случае синхронного маршрута такое же количество подключений к менеджеру дополнительно будет создано на вычитку. Параметр влияет на пропускную способность адаптера. Задавать его рекомендуется в паре с rq_queue_access_count таким образом, чтобы произведение rq_managers_count * rq_queue_access_count было не меньше, чем tps * задержку в секундах. По умолчанию значение параметра равно 1.

    Внимание! Увеличение данного параметра увеличивает потребление ресурсов, при их нехватке рекомендуется увеличить xmx и mxs параметры для данного адаптера.

    Тип параметра: целочисленное значение от 1 до 100.

  • rq_queue_access_count

    Параметр, задающий количество активных открытий очереди для записи в рамках каждого экземпляра подключения к менеджеру (количество которых задается в параметреrq_managers_count ). В случае синхронного маршрута такое же количество подключений к менеджеру дополнительно будет создано на вычитку. Параметр влияет на пропускную способность адаптера. Задавать его рекомендуется в паре с rq_queue_access_count таким образом, чтобы произведение rq_managers_count * rq_queue_access_count было не меньше, чем tps * задержку в секундах. По умолчанию значение параметра равно 1.

    Внимание! Увеличение данного параметра увеличивает потребление ресурсов, при их нехватке рекомендуется увеличить xmx и mxs параметры для данного адаптера.

    Тип параметра: целочисленное значение от 1 до 100.

  • main_configuration_reconnect_period

    Параметр, определяющий время, через которое будет осуществляться попытка переподключения к основному менеджеру очередей при использовании резервного. Задается в мс. Значение по умолчанию равно 10000.

    Тип параметра: целочисленное значение от 1 до 65535.

  • queue_access_timeout

    Параметр, определяющий таймаут попытки открытия очереди на чтение или запись. Задается в мс. Значение по умолчанию равно 10000.

    Тип параметра: целочисленное значение от 1 до 65535.

  • rq_mqgroup

    Параметр, задающий группу дополнительных MQ-настроек. Эти настройки будут использоваться для создания дополнительных MQ-подключений, которые будут использоваться в случае, если подключение, задаваемое основными настройками по тем или иным причинам не доступно. Данный параметр представляет собой список, элементами которого являются совокупности следующих параметров:

    • rq_topic

    • rq_queue

    • rq_name

    • rq_hostname

    • rq_port

    • rq_channel

    • rq_user_id

    • rq_ssl_cert_store

    • rq_ssl_cipher_suite

    • rq_payload_charset

    • rq_jms_type

    Для каждого из этих параметров сохраняются требования по обязательности / не обязательности в соответствии с тем, что написано выше. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: список.

  • rs_queue

    [Синхрон] Аналогично rq_queue. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера и rs_topic отсутствует. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: строковое значение.

  • rs_name

    [Синхрон] Аналогично rq_name. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: строковое значение.

  • rs_hostname

    [Синхрон] Аналогично rq_hostname. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: строковое значение с корректным IPv4 адресом или псевдонимом сервера.

  • rs_port

    [Синхрон] Аналогично rq_port. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: целочисленное значение от 1 до 65535.

  • rs_channel

    [Синхрон] Аналогично rq_channel. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: строковое значение.

  • rs_user_id

    [Синхрон] Аналогично rq_user_id. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера и при этом MQ-менеджер требует авторизации по user_id и паролю (который в свою очередь должен присутствовать в файле с паролями из блока common). Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: строковое значение.

  • rs_ssl_cert_store

    [Синхрон] Аналогично rq_ssl_cert_store. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера с использованием SSL. Если в данном параметре нет необходимости, он должен быть просто опущен. Особенности передачи пути аналогичны тому, что описаны для параметра rq_ssl_cert_store.

    Тип параметра: строковое значение.

  • rs_ssl_cipher_suite

    [Синхрон] Аналогично rq_ssl_cipher_suite. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера с использованием SSL. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: строковое значение из списка (здесь будет ссылка на список).

  • rs_timeout

    [Синхрон] Таймаут ожидания ответа по каналу. Данное поле необходимо, если предусмотрено ожидание ответа от MQ брокера. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: целочисленное значение от 0 до 1е7.

  • rs_mqgroup

    [Синхрон] Параметр, задающий группу дополнительных MQ-настроек. Эти настройки будут использоваться для создания дополнительных MQ-подключений, которые будут использоваться в случае, если подключение, задаваемое основными настройками по тем или иным причинам не доступно. Данный параметр представляет собой список, элементами которого являются совокупности следующих параметров:

    • rs_topic

    • rs_queue

    • rs_name

    • rs_hostname

    • rs_port

    • rs_channel

    • rs_user_id

    • rs_ssl_cert_store

    • rs_ssl_cipher_suite

    • rs_timeout

    Для каждого из этих параметров сохраняются требования по обязательности / не обязательности в соответствии с тем, что написано выше. Если в данном параметре нет необходимости, он должен быть просто опущен.

    Тип параметра: список.

Пример асинхронного сервиса:

service_sowa_ipa:
  - id: async_usock_mq
    common:
      logging_package_org_apache_camel: DEBUG
      logging_package_org_springframework: DEBUG
      logging_package_ru_sbt: DEBUG
      passwords_path: passwords_ipa.properties
    usock_mq:
      from:
        usock_busy_timeout: 100
        usock_max_concurrent_connections: 10
        usock_socket_timeout: 100
      to:
        - route_id: '*'
          rq_channel: SVRCONN.SSL
          rq_hostname: 10.x.x.x
          rq_name: DEV.1.QMGR
          rq_port: 1415
          rq_queue: USOCK.ASYNC.TO
          rq_ssl_cert_store: client_ipa.jks
          rq_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
        - route_id: test
          rq_channel: SVRCONN.SSL
          rq_hostname: 10.x.x.x
          rq_name: DEV.1.QMGR
          rq_port: 1415
          rq_queue: USOCK.ASYNC.TO.TEST
          rq_ssl_cert_store: client_ipa.jks
          rq_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256

Пример синхронного сервиса:

service_sowa_ipa:
  - id: sync_usock_mq
    common:
      logging_package_org_apache_camel: DEBUG
      logging_package_org_springframework: DEBUG
      logging_package_ru_sbt: DEBUG
      passwords_path: passwords_ipa.properties
    usock_mq:
      from:
        usock_busy_timeout: 100
        usock_max_concurrent_connections: 10
        usock_socket_timeout: 100
      to:
        - route_id: '*'
          rq_channel: SVRCONN.SSL
          rq_hostname: 10.x.x.x
          rq_mqgroup:
          - rq_channel: SVRCONN.SSL
            rq_hostname: 10.x.x.x
            rq_name: DEV.2.GMGR
            rq_port: 1416
            rq_queue: USOCK.SYNC.TO
            rq_ssl_cert_store: client_ipa.jks
            rq_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
          rq_name: DEV.1.QMGR
          rq_port: 1415
          rq_queue: USOCK.SYNC.TO
          rq_ssl_cert_store: client_ipa.jks
          rq_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
          rs_channel: SVRCONN.SSL
          rs_hostname: 10.x.x.x
          rs_mqgroup:
          - rs_channel: SVRCONN.SSL
            rs_hostname: 10.x.x.x
            rs_name: DEV.2.GMGR
            rs_port: 1416
            rs_queue: USOCK.SYNC.FROM
            rs_ssl_cert_store: client_ipa.jks
            rs_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
            rs_timeout: 15000
          rs_name: DEV.1.QMGR
          rs_port: 1415
          rs_queue: USOCK.SYNC.FROM
          rs_ssl_cert_store: client_ipa.jks
          rs_ssl_cipher_suite: TLS_RSA_WITH_AES_128_CBC_SHA256
          rs_timeout: 15000