diff --git a/doc/html/plugins/SSLPlugin.html b/doc/html/plugins/SSLPlugin.html index 8ced4b4..4b419e9 100644 --- a/doc/html/plugins/SSLPlugin.html +++ b/doc/html/plugins/SSLPlugin.html @@ -1,50 +1,59 @@

3proxy SSL/TLS plugin

-Plugin can be used to transparently decypher SSL/TLS data and TLS encryption to proxy. -potential securiy reasons. +Plugin can be used to transparently decypher SSL/TLS data and TLS encryption for proxy traffic. -
-ssl_certcache PATH_TO_CACHE
-ssl_mitm
-ssl_nomitm
-ssl_srvcert
-ssl_srvkey 
-ssl_serv
-ssl_noserv
-
-

For transparent certificate spoofing:

-ssl_certcache - path to certificates cache. For transparent spoofing cache must contain 3 files: 3proxy.pem - public -self-signed certificates, 3proxy.key - key for public certificates, server.key - this key will be used to generates -spoofed certificates. -Generated certificates will be placed to the same path. -
ssl_mitm - spoof certificates for services started below. Using ssl_mitm is insecure, because proxy does not check certificates. +
ssl_mitm - spoof certificates for services started below. Usage without ssl_client_verify is insecure.
ssl_nomitm - do not spoof certificates for services started below +

To protect traffic to server (https:// proxy) - since 0.9.5 version

+ssl_serv - require TLS connection for services below +
ssl_noserv - do not require TLS connection for services below -

Example:

+Parameters: +
ssl_server_cert /path/to/cert - Server certificate (should not be selfsigned and must contain Alternative name) for ssl_serv +
ssl_server_key /path/to/key - Server ceritifacte key for ssl_server_cert or generated mitm certificate +
ssl_client_ciphersuites ciphersuites_list - TLS client ciphers for TLS 1.3, e.g. ssl_client_ciphersuites TLS_AES_128_GCM_SHA256 +
ssl_server_ciphersuites ciphersuites_list - TLS server ciphers for TLS 1.3 +
ssl_client_cipher_list ciphersuites_list - TLS client ciphers for TLS 1.2 and below , e.g. ssl_client_cipher_list ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-CHACHA20-POLY1305 +
ssl_server_cipher_list ciphersuites_list - TLS server ciphers for TLS 1.2 and below +
ssl_client_min_proto_version tls_version - TLS client min TLS version (e.g. TLSv1.2) +
ssl_server_min_proto_version tls_version - TLS server min TLS version (e.g. TLSv1.2) +
ssl_client_max_proto_version tls_version - TLS client max TLS version (e.g. TLSv1.2) +
ssl_server_max_proto_version tls_version - TLS server max TLS version (e.g. TLSv1.2) +
ssl_client_verify - verify certificate for upstream server in TLS client functionality (used with ssl_mitm) +
ssl_client_no_verify - do not verify certificate for upstream server in TLS client functionality (default) +
ssl_server_ca_file /path/to/cafile - CA certificate file for mitm +
ssl_server_ca_key /path/to/cakey - key for ssl_server_ca_file mitm CA +
ssl_client_ca_file, ssl_client_ca_dir, ssl_client_ca_store - locations for root CAs used with ssl_client_verify for TLS client +
ssl_certcache /path/to/cache/ - location for generated mitm certificates cache, optional, if ssl_server_ca_file / ssl_server_ca_key are configured. +Cache may contain 3 files: 3proxy.pem - public +self-signed certificates (used if ssl_server_ca_file is not configured), +3proxy.key - key for public certificates, used if ssl_server_ca_keyserver.key is not configured, server.key - this key is used if ssl_server_key is not configured to generates +spoofed certificates. If server.key is absent, 3proxy.key is used to generate certificates. +Generated certificates are placed to the same path. + + +

mitm example:

 plugin /path/to/SslPlugin.dll ssl_plugin
-ssl_certcache /path/to/cache/
+ssl_server_ca_file /path/to/cafile
+ssl_server_ca_key /path/to/cakey
 ssl_mitm
 proxy -p3128
 ssl_nomitm
 proxy -p3129
 
-

To protect traffic to server (https:// proxy) - since 0.9.5 version

-ssl_srvcert - Server certificate (should not be selfsigned and must contain Alternative name) -ssl_srvkey - Server ceritifacte key -ssl_serv - require TLS connection for services below -ssl_noserv - do not require TLS connection for services below +mitm's traffic with spoofed ceritifacate for port 3128 proxy. -Example: +

https:// proxy example:

 plugin /path/to/SSLPlugin.so ssl_plugin
-ssl_srvcert path_to_cert
-ssl_srvkey path_to_key
+ssl_server_cert path_to_cert
+ssl_server_key path_to_key
 ssl_serv
 proxy -p33128
 ssl_noserv
@@ -52,11 +61,4 @@ proxy -p3128
 
creates https:// proxy on 33128 and http:// proxy on 3128 - - -

Download:

- - © Vladimir Dubrovin, License: BSD style diff --git a/doc/html/plugins/SSLPlugin.ru.html b/doc/html/plugins/SSLPlugin.ru.html index 4436358..4aa292e 100644 --- a/doc/html/plugins/SSLPlugin.ru.html +++ b/doc/html/plugins/SSLPlugin.ru.html @@ -1,60 +1,61 @@ -

Плагин SSL/TLS для 3proxy

+

3proxy SSL/TLS плагин

-Плагин используется для транспарентной дешифровки SSL-трафика с подменой сертификата и для TLS шифрования трафика прокси. +Плагин можно использовать для перехвата и дешифровки SSL/TLS трафика и для шифрования трафика прокси-сервера + +

Для транспаретной перехватки трафика (mitm):

+ +
ssl_mitm - подменять сертификаты для сервисов стартованных ниже. Не безопасно использовать без ssl_client_verify. +
ssl_nomitm - не подменять сертификаты для сервисов стартованных ниже. -
-ssl_certcache PATH_TO_CACHE
-ssl_mitm
-ssl_nomitm
-ssl_srvcert
-ssl_srvkey
-ssl_serv
-ssl_noserv
-
+

Для защиты трафика прокси-сервера (например https:// proxy) - начиная с 0.9.5

+ssl_serv - включает TLS для соединений к сервисам ниже +
ssl_noserv - отключает TLS для соединений к сервисам ниже -

Использование для перехвата трафика с подменой сертификата

+Параметры: +
ssl_server_cert /path/to/cert - сертификат сервера, не должен быть самоподписаным, имя CN должно содержаться в альтернативных именах - используется для ssl_serv +
ssl_server_key /path/to/key - ключ сертификата сервера для ssl_server_cert или сгенерированного сертификата ssl_mitm +
ssl_client_ciphersuites ciphersuites_list - наборы шифрова TLS для TLS 1.3, пример ssl_client_ciphersuites TLS_AES_128_GCM_SHA256 +
ssl_server_ciphersuites ciphersuites_list - наборы шифрова TLS для TLS 1.3 +
ssl_client_cipher_list ciphersuites_list - наборы шифрова TLS для TLS 1.2 и ниже, пример ssl_client_cipher_list ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-CHACHA20-POLY1305 +
ssl_server_cipher_list ciphersuites_list - наборы шифрова TLS для TLS 1.2 и ниже +
ssl_client_min_proto_version tls_version - минимальная версия TLS клиента (например ssl_client_min_proto_version TLSv1.2) +
ssl_server_min_proto_version tls_version - минимальная версия TLS сервера +
ssl_client_max_proto_version tls_version - максимальная версия TLS клиента +
ssl_server_max_proto_version tls_version - максимальная версия TLS сервера +
ssl_client_verify - проверять сертификат сервера назначения (используется с ssl_mitm) +
ssl_client_no_verify - не проверять сертификат сервера назначения +
ssl_server_ca_file /path/to/cafile - CA сертификат для ssl_mitm +
ssl_server_ca_key /path/to/cakey - ключ CA сертификата ssl_server_ca_file mitm +
ssl_client_ca_file, ssl_client_ca_dir, ssl_client_ca_store - расположения корневых сертификатов ssl_client_verify +
ssl_certcache /path/to/cache/ - расположение кеша сгенерированных сертификатов ssl_mitm. Кеш может содержать +файлы 3proxy.pem, 3proxy.key server.key, которые используются как ssl_server_ca_file, +ssl_server_ca_key и ssl_server_key соответственно если они не заданы. Если server.key не задан, +3proxy.key используется для генерации серверного сертификата. - -ssl_certcache - путь к кэшу сертификатов. Для транспорентной подмены сертификатов в кэше должно находиться 3 файла: 3proxy.pem - публичный -самоподписанный сертификат, 3proxy.key - ключ от этого сертификата, server.key - ключ с которым будут генерироваться подменные сертификаты. -Сгенерированные сертификаты будут помещаться в этот же каталог. -
ssl_mitm - подменять сертитфикаты для запущенных ниже сервисов. Может быть небезопасно, т.к. прокси не проверяет сертификат сервера. -
ssl_nomitm - не подменять сертитфикаты для запущенных ниже сервисов - - -

Пример:

+

Пример mitm:

 plugin /path/to/SslPlugin.dll ssl_plugin
-ssl_certcache /path/to/cache/
+ssl_server_ca_file /path/to/cafile
+ssl_server_ca_key /path/to/cakey
 ssl_mitm
 proxy -p3128
 ssl_nomitm
 proxy -p3129
 
+Перехватывается трафик в прокси на порту 3128 -

Использование для TLS шифрования трафика к прокси (с версии 0.9.5) - -ssl_srvcert - путь к файлу сертификата сервера. Сертификат должен быть аналогичен сертификату web-сервера (не должен быть самоподписанным и должен содержать AltName). -ssl_srvkey - ключ от серверного сертификата -ssl_serv - шифровать трафик TLS для сервисов ниже -ssl_noserv - не шифровать трафик TLS для сервисов ниже - -Пример: - +

Пример конфигурации https:// прокси (curl -x https://...):

 plugin /path/to/SSLPlugin.so ssl_plugin
-ssl_srvcert path_to_cert
-ssl_srvkey path_to_key
+ssl_server_cert path_to_cert
+ssl_server_key path_to_key
 ssl_serv
 proxy -p33128
 ssl_noserv
 proxy -p3128
 
-На порт 33128 https:// прокси, на порту 3128 http:// прокси +На порту 33128 создается https:// прокси (не путать с CONNECT прокси aka HTTPS over HTTP прокси), на порту 3128 +создается http:// прокси (может пропуска в т.ч. и HTTPS коннекты) - -

Загрузить:

- +© Vladimir Dubrovin, License: BSD style diff --git a/doc/html/plugins/StringsPlugin.ru.html b/doc/html/plugins/StringsPlugin.ru.html index 8f03e40..3917ae8 100644 --- a/doc/html/plugins/StringsPlugin.ru.html +++ b/doc/html/plugins/StringsPlugin.ru.html @@ -1,4 +1,4 @@ -

Плагин подмены строк 3proxy

+

Плагин подмены строк 3proxy

Используется, в частности, для руссификации сообщений выдаваемых 3proxy. Для корректной работы требуется 0.6 версия 3proxy. diff --git a/doc/html/plugins/TrafficPlugin.ru.html b/doc/html/plugins/TrafficPlugin.ru.html index 00469c2..9d52731 100644 --- a/doc/html/plugins/TrafficPlugin.ru.html +++ b/doc/html/plugins/TrafficPlugin.ru.html @@ -1,4 +1,4 @@ -

Плагин коррекции траффика 3proxy

+

Плагин коррекции траффика 3proxy

Как известно, 3proxy считает траффик не сетевой, а прикладной. Обычно прикладной траффик немного меньше (примерно на 10%) чем сетевой, однако в некоторых случаях, например когда пользователи сети играют в diff --git a/doc/html/plugins/WindowsAuthentication.ru.html b/doc/html/plugins/WindowsAuthentication.ru.html index 7c857c7..e087690 100644 --- a/doc/html/plugins/WindowsAuthentication.ru.html +++ b/doc/html/plugins/WindowsAuthentication.ru.html @@ -1,4 +1,4 @@ -

Плагин аутентификации Windows для 3proxy

+

Плагин аутентификации Windows для 3proxy

Поддерживается только аутентификация открытым текстом в домене или на локальной машине Windows.

Использование