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

Содержание#

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Правила фильтрации

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

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

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

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

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

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

• Вспомогательные инструменты для разработки конфигураций

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

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

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

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

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

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

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

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

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

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

    • Формат заполнения файла с паролями

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

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

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

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

• Параметры

  • Параметр allowed_queries

  • Параметр async_io

  • Параметр buffers

  • Параметр cache_configuration

  • Параметр chains

  • Параметры chains_request

  • Параметры chains_response

  • Параметр chains_action_list

  • Параметр chains_tracing

  • Параметр cookie_poisoning

  • Параметр event_hook

  • Параметр exclude_stat

  • Параметр gzip

  • Параметр health_check

  • Параметр hostname

  • Параметр http2

  • Параметр init_handlers

  • Параметр ip_behavior

  • Параметр ip_blacklist

  • Параметр kafka_settings

  • Параметр ldap_connection

  • Параметр ldap_request

  • Параметр limit_conn

  • Параметр limit_req

  • Параметр limit_requests

  • Параметр listen

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

  • Параметр log_masking_rules

  • Параметр logging

  • Параметр modifiers

  • Параметр opentelemetry_tracing

  • Параметр ocsp

  • Параметр req_gunzip

  • Параметр resolver

  • Параметр response_generator

  • Параметр robot_mitigation

  • Параметр security_headers

  • Параметр service_cache

  • Параметр spnego

  • Параметр upstream

  • Параметр upstream_ssl

  • Параметр vault

  • Пaраметр healthcheck_dynamic

  • Параметр response_gunzip

  • Параметр required_action_request

  • Параметр required_action_response

• Обработчики

  • HealthCheck

  • LdapSearch

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

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

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

  • Валидация Protobuf

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

  • Фильтр ICAP

  • Фильтр ModSecurity

  • Фильтр Transformations

  • Фильтр WebSocket

• Работа модуля CORS

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

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

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

  • Постобработчик hc_response

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

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

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

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

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

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

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

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

    • CheckDataSize

    • AntivirusFileChecker

    • CheckMimeType

    • ConditionChecker

    • JsonValidation

    • XsdValidation

    • WsdlValidation

    • ProtobufValidation

    • GraphQLRequestValidation

    • OpenApiValidation

    • FilterMds

    • HttpFilter

    • OcspSignValidator

    • ICAPFileChecker

    • JwtVerifier

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

    • ASN1ContentExtractor

    • Base64Decode

    • Base64Encode

    • JsonPathExtract

    • JsonPathExtractToVars

    • JsonTransformer

    • XmlTransformer

    • MtomExtractor

    • MultipartExtract

    • PostFormDataToFlateJson

    • RandomNumberToVar

    • SetMessageFromVar

    • SharedMapSetter

    • SharedMapGetter

    • SharedMapDeleter

    • SharedMapRemover

    • XPathExtract

    • DelimiterSplitter

    • ProtobufToJson

    • ASN1ToJson

    • OcspToJson

    • UrlDecode

    • UrlDecodeUni

    • UrlEncode

    • Utf8ToUnicode

    • Trim

    • ToLowerCase

    • ToUpperCase

    • HexDecode

    • HexEncode

    • DigestFromMessage

    • HttpSender

    • MessageAccumulator

    • MessageFromAccumulator

    • MessageFromPattern

    • JsonPatchVar

    • JsonPatchMessage

    • MultipartFormGenerateFromMessage

    • FileToMessage

    • LdapSearch

    • SimpleRateLimiter

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

    • SetVarFromMessage

    • SharedMapToVars

    • VarsToSharedMap

    • FileToVars

    • VarsToFile

    • SetVar

    • MessageToFile

    • MultipartFormGenerateFromVar

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

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

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

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

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

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

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

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

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

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

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

• Плагины SOWA

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

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