С момента прошлого поста вышло сразу три версии 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— по умолчанию, штатный .NETSslStream;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, так что, если вы пользуетесь им, проверьте это значение в своей конфигурации.