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

Содержание#

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Тип cервиса GostProxy

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

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

  • Параметры

    • Пaраметр async_io (parameter_async_io)

    • Пaраметр buffers (parameter_buffers)

    • Пaраметр hostname (parameter_hostname)

    • Пaраметр listen (parameter_listen)

    • Пaраметр upstream (parameter_upstream)

    • Пaраметр service_cache (parameter_service_cache)

    • Пaраметр chains (parameter_chains)

    • Пaраметр chains_action_list (parameter_chains_action_list)

    • Параметр chains_request (parameter_chains_request)

    • Параметр chains_response (parameter_chains_response)

    • Параметр response_generator (parameter_response_generator)

    • Параметр req_gunzip (parameter_req_gunzip)

    • Параметр http2 (parameter_http2)

    • Параметр cache_configuration (util_cache_configuration)

    • Параметр cookie_poisoning (util_cookie_poisoning)

    • Параметр event_hook (util_event_hook)

    • Параметр exclude_stat (util_exclude_stat)

    • Параметр gzip (util_gzip)

    • Параметр health_check (util_health_check)

    • Параметр ip_behavior (util_ip_behavior)

    • Параметр ip_blacklist (util_ip_blacklist)

    • Пaраметр kafka_settings (util_kafka_settings)

    • Пaраметр limit_conn (util_limit_conn)

    • Пaраметр limit_req (util_limit_requests)

    • Пaраметр log_masking_rules (util_log_masking)

    • Пaраметр logging (util_logging)

    • Пaраметр modifiers (util_modifiers)

    • Пaраметр robot_mitigation (util_robot_mitigation)

    • Пaраметр security_headers (util_security_headers)

    • Пaраметр spnego (util_spnego)

    • Пaраметр upstream_ssl (util_upstream_ssl)

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

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

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

    • Валидация Protobuf

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

    • Фильтр ICAP

    • Фильтр ModSecurity

    • Фильтр Transformations

    • Фильтр WebSocket

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

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

  • Настройка SOWA для работы с 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

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

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

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

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

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

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