Руководство прикладного разработчика#

Содержание#

• Системные требования

• Подключение и конфигурирование

  • Описание конфигурационных ключей и флагов

  • Работа с профилем

  • Резервное копирование

  • Структура каталогов конфигуратора

  • Внутренние переменные

• Базовая конфигурация сервисов SOWA

  • Создание файла с базовой конфигурацией

  • Базовая конфигурация system-optional

• Типы сервисов

  • Тип сервиса ServiceCache

  • Тип сервиса ServiceHttpKafkaProxy

  • Тип сервиса HttpMQProxy

  • Тип сервиса HttpProxy

  • Тип сервиса MainProxy

  • Тип сeрвиса ServiceStatic

  • Тип сeрвиса WebSocketProxy

  • Тип сервиса ProfileStatusPrometheus

• Параметры

  • Параметр allowed_queries

  • Пaраметр async_io

  • Пaраметр buffers

  • Пaраметр hostname

  • Пaраметр listen

    • Согласованные наборы Protocols and Ciphers_listen

  • Пaраметр upstream

  • Пaраметр service_cache

  • Пaраметр chains

  • Пaраметр chains_action_list

  • Параметр chains_request

  • Параметр chains_response

  • Параметр response_generator

  • Параметр req_gunzip

  • Параметр http2

  • Параметр cache_configuration

  • Параметр cookie_poisoning

  • Параметр event_hook

  • Параметр exclude_stat

  • Параметр gzip

  • Параметр health_check

  • Параметр ip_behavior

  • Параметр ip_blacklist

  • Пaраметр kafka_settings

  • Пaраметр limit_conn

  • Пaраметр limit_req

  • Пaраметр log_masking_rules

  • Пaраметр logging

  • Пaраметр modifiers

  • Параметр resolver

  • Пaраметр robot_mitigation

  • Пaраметр security_headers

  • Пaраметр spnego

  • Пaраметр upstream_ssl

• Настройка валидации в SOWA

  • Валидация по JSON схеме

  • Валидация по WSDL/XSD схеме

  • Валидация Protobuf

• Настройка фильтрации в SOWA

  • Фильтр ICAP

  • Фильтр ModSecurity

  • Фильтр Transformations

  • Фильтр WebSocket

• Настройка постобработчика

  • Создание файла с правилами

• Настройка SOWA для работы с HTTP2/GRPC

  • Прием HTTP2 трафика

  • Проксирование HTTP2 трафика

  • Опциональные директивы HTTP2

  • Обработка ошибок GRPC

• Работа с цепочками

  • Конфигурирование цепочек

  • Проверяющие действия

    • CheckDataSize

    • AntivirusFileChecker

    • CheckMimeType

    • ConditionChecker

    • JsonValidation

    • XsdValidation

    • WsdlValidation

    • ProtobufValidation

    • GraphQLRequestValidation

    • OpenApiValidation

    • FilterMds

    • HttpFilter

    • OcspSignValidator

    • ICAPFileChecker

  • Преобразователи сообщений

    • ASN1ContentExtractor

    • Base64Decode

    • JsonPathExtract

    • JsonPathExtractToVars

    • JsonTransformer

    • XmlTransformer

    • MtomExtractor

    • MultipartExtract

    • PostFormDataToFlateJson

    • RandomNumberToVar

    • SetMessageFromVar

    • SharedMapSetter

    • SharedMapGetter

    • SharedMapDeleter

    • SharedMapRemover

    • XPathExtract

    • DelimeterSplitter

    • ProtobufToJson

    • ASN1ToJson

    • OcspToJson

    • UrlDecode

    • UrlDecodeUni

    • UrlEncode

    • Utf8ToUnicode

    • Trim

    • ToLowerCase

    • ToUpperCase

    • HexDecode

    • HexEncode

  • Манипуляторы с переменными

    • SetVarFromMessage

    • SharedMapToVars

    • VarsToSharedMap

    • FileToVars

    • VarsToFile

    • SetVar

  • Варианты использования

    • Балансировка на основании содержимого запроса JSON

    • Балансировка на основании содержимого запроса JSON с валидацией

    • Балансировка на основании содержимого запроса XML с валидацией

    • Выбор схемы валидации на основе содержимого сообщения

    • Проверка на допустимый тип вложений в Multipart-FormData

    • Извлечение данных из объектов MTOM/XOP

    • Валидация HTTP-форм с использованием JSON-схем

    • Кэширование данных

    • Проверка файлов на антивирусе Symantec

    • Удаление запрещенных JSON-элементов

• Миграция на текущую версию

• Быстрый старт

  • Предварительные требования

  • Создание заглушки

  • Создание прокси-сервиса

  • Настройка SSL/TLS

  • Проверка передаваемого содержимого

  • Модификация заголовков запросов и ответов

  • Постобработка ошибок

  • Настройка элементов окружения

• Использование программного компонента

• Часто встречающиеся проблемы и пути их устранения