Opt-In Software Blog

Software, dvelopment, and practical insights

ProxyMapService: разбиение TLS-записей, SSL-настройки по портам и хостам

Читать на другом языке: English | Русский

С момента прошлого поста вышло сразу три версии ProxyMapService: 1.0.0, 1.0.1 и 1.0.2. Главная новинка последней — разбиение TLS-записей: прокси умеет разрезать первую исходящую TLS-запись (ClientHello) на несколько отдельных записей. Кроме неё, в этих версиях появились настройки SSL для отдельных портов и хостов, запуск сервиса без конфигурации и несколько изменений, которые стоит учесть при обновлении.

Разбиение TLS-записей (1.0.2)

Зачем это нужно

ClientHello — первое сообщение TLS-хендшейка, и в нём открытым текстом передаётся имя хоста (SNI). Некоторые DPI-системы классифицируют HTTPS-трафик, анализируя именно первую запись как единое целое: нашли в ней нужный SNI — и соединение блокируется или обрабатывается особым образом.

Фрагментация на уровне TLS-протокола ломает такую проверку. Получившиеся записи имеют тот же тип содержимого и ту же версию, что и исходная, а вместе собираются в точно такой же payload, поэтому любой сервер, соответствующий RFC, принимает их без каких-либо изменений. А DPI видит не один собранный ClientHello, а несколько отдельных пакетов: каждая запись отправляется отдельно.

Как включить

Опцию TlsRecordSplit можно задать на двух уровнях: для всего порта — в секции Listen записи ProxyMappings, или только для нужных хостов — в правилах HostRules.

Для всего порта:

"ProxyMappings": [
    {
        "Listen": {
            "Port": 5001,
            "TlsRecordSplit": "1,0+sm"
        }
    }
]

Для отдельных хостов — например, чтобы фрагментировать ClientHello только при обращении к YouTube:

"HostRules": {
    "Items": [
        {
            "Pattern": "youtube\\.com$",
            "TlsRecordSplit": "1,0+sm"
        },
        {
            "Pattern": "googlevideo\\.com$",
            "TlsRecordSplit": "1,0+sm"
        },
        {
            "Pattern": "\\.ytimg\\.com$",
            "TlsRecordSplit": "1,0+sm"
        }
    ]
}

Значение правила HostRule имеет приоритет над значением из Listen; если в правиле опция не задана, действует значение из Listen. Так можно не трогать остальной трафик и разбивать записи только для тех хостов, к которым нужно.

Формат значения одинаков на обоих уровнях — список позиций разбиения через запятую. Каждая позиция записывается так: offset[:repeats:skip][+flag1[flag2]].

  • offset — позиция относительно начала ClientHello (то есть payload TLS-записи, без 5-байтового заголовка); отрицательное смещение без флагов отсчитывается от конца;
  • repeats:skip — необязательная часть: повторить разбиение repeats раз с шагом skip байт (например, 1:3:5 разрежет запись в позициях 1, 6 и 11);
  • флаги:
    • +s — смещение от начала SNI-имени хоста;
    • +e — смещение от конца ClientHello (вместе с +s — от конца SNI-имени);
    • +m — смещение от середины ClientHello (вместе с +s — от середины SNI-имени);
    • +n — нулевое смещение (позиция остаётся абсолютной).

Несколько примеров:

Значение Где будет разрезана запись
1 после первого байта ClientHello
3+s через 3 байта после начала SNI-имени хоста
0+sm в середине SNI-имени хоста
-5 за 5 байт до конца ClientHello

Значения можно комбинировать: "1,0+sm" из примеров выше режет запись сразу в двух местах — после первого байта и посередине имени хоста.

Работает в обоих режимах

Разбиение применяется к исходящему (upstream) TLS-соединению и работает в двух режимах:

  • с расшифровкой SSL (DecryptSSL: true) — ClientHello формирует сам прокси (в том числе с TLS-отпечатком как у Chrome или Firefox), а разбиение выполняется «под» TLS-реализацией;
  • в режиме passthrough (без расшифровки) — ClientHello клиента проходит через туннель и «на лету» нарезается на куски.

Детали поведения

  • Разбивается только первая TLS-запись (ClientHello); все последующие записи проходят без изменений.
  • Если спецификация ни к чему не приводит — например, все позиции отсчитываются от SNI, а в записи его нет, или позиция попадает ровно на границу записи, — запись отправляется как есть.
  • Когда разбиение активно, прокси пишет об этом в лог на уровне debug (чтобы увидеть сообщение, включите TlsHandshakeLog).

SSL-настройки для отдельных портов и хостов (1.0.0)

Глобальные секции SslClientOptions (исходящие TLS-соединения) и SslServerOptions (входящие соединения при расшифровке) теперь можно уточнять на двух уровнях:

  • Listen.SslClientOptions / Listen.SslServerOptions — действуют на весь трафик порта (диапазона портов) из ProxyMappings;
  • HostRule.SslClientOptions / HostRule.SslServerOptions — действуют только на соединения, подходящие под правило хоста.

Приоритет: глобальные настройки → Listen → HostRule. В переопределении заменяются только явно заданные свойства, всё остальное наследуется с уровня выше. Переопределение из HostRule применяется, только если правило сработало и его действие не Deny.

Например, ограничим версии протоколов для одного порта и дадим отдельный сертификат и Chrome-подобный отпечаток для одного хоста:

"ProxyMappings": [
    {
        "Listen": {
            "Port": 5001,
            "DecryptSSL": true,
            "SslServerOptions": {
                "EnabledSslProtocols": "Tls12,Tls13"
            }
        }
    }
],
"HostRules": {
    "Items": [
        {
            "HostName": "example.com",
            "SslClientOptions": {
                "TlsClientType": "BoringSsl"
            },
            "SslServerOptions": {
                "ServerCertificate": {
                    "Path": "certs/example.com.pfx",
                    "Password": "secret"
                }
            }
        }
    ]
}

Можно переопределять:

  • в SslClientOptions: EnabledSslProtocols, CheckCertificateRevocation, ApplicationProtocols, TrustedCAs, TlsClientType;
  • в SslServerOptions: EnabledSslProtocols, ClientCertificateRequired, CheckCertificateRevocation, ApplicationProtocols, ServerCertificate, CACertificate.

TlsClientType вместо UseBoringSsl

В посте про TLS-отпечаток как у Chrome использовалась опция UseBoringSsl. Теперь вместо неё в SslClientOptions задаётся TlsClientType со значениями:

  • Native — по умолчанию, штатный .NET SslStream;
  • BoringSsl — TLS-отпечаток как у Chrome (BoringSslStream);
  • Nss — TLS-отпечаток как у Firefox (NssStream).

То есть прежнее "UseBoringSsl": true теперь записывается как "TlsClientType": "BoringSsl". А благодаря переопределениям выше тип клиента можно выбирать для отдельного порта или хоста.

Сертификаты из хранилища

ServerCertificate и CACertificate принимают полный формат SslCertificateConfig. Сертификат для хоста можно загрузить из файла (Path + Password, символ ~ раскрывается) или из локального хранилища сертификатов (StoreLocation + StoreName + Subject).

Что сломается при обновлении

Свойства CertificatePath и CertificatePassword в HostRule удалены в пользу SslServerOptions.ServerCertificate. Старые конфигурации не вызовут ошибку — эти свойства будут молча проигнорированы, поэтому перенесите их вручную:

// было:
{
    "HostName": "example.com",
    "CertificatePath": "certs/example.com.pfx",
    "CertificatePassword": "secret"
}
// стало:
{
    "HostName": "example.com",
    "SslServerOptions": {
        "ServerCertificate": {
            "Path": "certs/example.com.pfx",
            "Password": "secret"
        }
    }
}

Запуск без конфигурации (1.0.1)

Раньше при отсутствующей или пустой секции ProxyMappings сервис падал с NoMappingsException и отказывался стартовать. Теперь он пишет предупреждение No proxy mappings и продолжает работу, используя встроенную секцию DefaultProxyMappings из appsettings.json — обычный Bypass-слушатель на порту 5001 с расшифровкой SSL.

Благодаря этому сервис можно запустить «пустым», открыть дашборд, отредактировать конфигурацию и перезапустить сервис прямо из веб-интерфейса.

Обратите внимание: запасной вариант применяется, только если действующая конфигурация — это базовый appsettings.json, то есть никакие дополнительные appsettings.*.json не загружались. Если есть файл настроек окружения (например, appsettings.Production.json), ProxyMappings должна быть определена в нём.

Session API: домен теперь обязателен (1.0.1)

SessionAPIConfig.Domain должен быть непустым, чтобы Session API был доступен. Раньше пустой домен приводил к тому, что любой запрос без совпадения по имени хоста считался запросом к Session API. Значение по умолчанию в appsettings.json изменено с "" на proxymapper. Запросы к любым другим именам хостов больше не перехватываются обработчиком Session API, так что, если вы пользуетесь им, проверьте это значение в своей конфигурации.

Search