Просмотр кода страницы Настройка прокси АктивногоШлюза

Ваша конфигурация подключения АктивногоШлюза позволяет вам определить один или несколько прокси-серверов для исходящих соединений: вы можете использовать один прокси-сервер для всего исходящего трафика, или вы можете указать разные прокси-серверы для разных целей, или вы даже можете определить исключения, отключив использование прокси-сервера для определенных соединения, используя прокси для других соединений.

== Свойства конфигурации прокси ==
Конфигурация прокси АктивногоШлюза состоит из следующих настроек. В зависимости от типа связи, для которой вы хотите использовать (или отключить) прокси, следующие свойства конфигурации могут появиться в разных разделах конфигурации вашей конфигурации АктивногоШлюза.
{| class="wikitable"
!Свойство
!Описание
|-
|<code>proxy-server</code>
|Адрес сервера (имя хоста или IP-адрес)
|-
|<code>proxy-port</code>
|Порт (необязательно)

Если оставить пустым, используется порт <code>8080</code> по умолчанию.
|-
|<code>proxy-user</code>
|Имя пользователя (необязательно)
|-
|<code>proxy-domain</code>
|Домен пользователя в случае аутентификации NTLM
|-
|<code>proxy-password</code>
|Пароль (необязательно)

Пароль, указанный в свойстве <code>proxy-password</code>, обфусцируется после перезапуска АктивногоШлюза, а замаскированный пароль сохраняется в свойстве <code>proxy-password-encr</code>.
|-
|<code>proxy-off</code>
|Если установлено значение <code>true</code>, прокси отключается для определенного типа связи.
|-
|<code>proxy-non-proxy-hosts</code>
|Список хостов, для связи с которыми АктивныйШлюз не должен использовать прокси

Хосты в списке должны быть разделены символом <code>|</code> персонажи. Вы также можете использовать звездочку <code>*</code> в качестве подстановочного знака для соответствия любой строке. Может быть только один подстановочный знак в начале или в конце имени хоста. Например, <code>proxy-non-proxy-hosts=*.foo.com|localhost</code> указывает, что каждый хост в домене <code>foo.com</code> и <code>localhost</code> должен быть доступен напрямую, даже если указан прокси-сервер. Полное описание допустимого синтаксиса см. в синтаксисе параметра <code>http.nonProxyHosts</code> в свойствах сети.
|}

== Укажите конфигурацию прокси для АктивногоШлюза ==
Конфигурация прокси АктивногоШлюза может быть указана во время установки АктивногоШлюза в Linux или Windows (только настройка для всех исходящих соединений), либо ее можно настроить после установки АктивногоШлюза. Чтобы настроить прокси для АктивногоШлюза:

* Отредактируйте файл <code>custom.properties</code> в каталоге конфигурации АктивногоШлюза.
* Укажите параметры прокси в соответствующем разделе конфигурации файла <code>custom.properties</code>, в зависимости от того, для каких целей вы хотите использовать прокси (см. примеры ниже). Например:

 <code>[http.client]
 proxy-server=127.0.0.1
 proxy-port=8080
 # basic authentication credentials
 proxy-user=username
 proxy-password=password</code>

* Сохраните файл <code>custom.properties</code>.
* Перезапустите основную службу АктивногоШлюза. Обратите внимание, что после перезапуска службы пароль прокси, указанный вами в конфигурации, шифруется и перемещается из свойства <code>proxy-password</code> в <code>proxy-password-encr</code>.

== Настройки прокси АктивногоШлюза для простых сценариев настройки прокси ==
Следующие простые сценарии настройки прокси для АктивногоШлюза являются наиболее распространенными и широко используемыми. Если у вас есть специальные и более сложные требования, вы также можете определить расширенную конфигурацию.

=== Настройки прокси АктивногоШлюза для всего исходящего трафика ===
[[Файл:ПроксиАктивногоШлюзаДляВсегоТрафика.png]]


Следующая конфигурация охватывает наиболее распространенный случай указания параметров прокси-сервера для исходящего соединения АктивногоШлюза как с кластером Ключ-Астром, так и с отслеживаемыми технологиями, такими как AWS, VMware или Azure.

Укажите параметры, связанные с прокси, в разделе <code>[http.client]</code> файла <code>custom.properties</code>, включая параметры, связанные с аутентификацией, если это необходимо:
 <code>[http.client]
 proxy-server=127.0.0.1
 proxy-port=8080
 # basic authentication credentials
 proxy-user=username
 proxy-password=password</code>

=== Настройки прокси АктивногоШлюза только для кластера ===
[[Файл:ПроксиАктивногоШлюзаДляКластера.png]]
Чтобы настроить прокси специально для кластера, позволяя исходящему мониторинговому трафику напрямую подключаться к отслеживаемым технологиям, задайте настройки прокси в разделе <code>[http.client.internal]</code> конфигурации АктивногоШлюза.
 <code>[http.client.internal]
 proxy-server=127.0.0.1
 proxy-port=8080
 # basic authentication credentials
 proxy-user=username
 proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Прокси-сервер АктивногоШлюза для исходящего трафика мониторинга с прямым подключением к кластеру ===
[[Файл:ПроксиАктивногоШлюзаДляКластераИТрафика.png]]

Чтобы настроить прокси специально для исходящего трафика мониторинга, но оставить прямое подключение к кластеру:

* Укажите конфигурацию прокси в разделе <code>[http.client]</code> файла <code>custom.properties</code>.
* Отключите прокси в разделе <code>[http.client.internal]</code>.

 <code>[http.client]
 proxy-server=127.0.0.1
 proxy-port=8080
 # basic authentication credentials
 proxy-user=username
 proxy-password=password
 
 [http.client.internal]
 proxy-off=true</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

== Расширенные сценарии настройки прокси для АктивногоШлюза ==
Чтобы настроить прокси '''для исходящих подключений''' из АктивногоШлюза, то есть для подключений к отслеживаемым технологиям или к кластеру, отредактируйте файл <code>custom.properties</code> и задайте свойства в соответствующем разделе. В зависимости от раздела конфигурации, в котором указаны свойства, прокси (и другие параметры связи) влияют только на выбранные типы соединений:

* <code>[http.client]</code> — настройки прокси для всех исходящих соединений АктивногоШлюза, включая кластер и все отслеживаемые технологии.
* <code>[http.client.internal]</code> — настройки прокси специально для связи с кластером. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[http.client.external]</code> — настройки прокси специально для отслеживаемых технологий: CloudFoundry, Kubernetes, приватный синтетический мониторинг. Эти настройки переопределяют настройки, указанные в <code>[http.client]</code>.
* <code>[<technology name>]</code> — настройки прокси специально для конкретной отслеживаемой технологии, например <code>cloudfoundry_monitoring</code>, <code>kubernetes_monitoring</code>, <code>synthetic</code>. Эти параметры переопределяют параметры, указанные в <code>[http.client]</code> и <code>[http.client.external]</code>. Обратите внимание, что настройки для многих из этих технологий можно указать совместно в <code>[http.client.external]</code>.

=== Прокси АктивногоШлюза для Kubernetes, CloudFoundry и частного синтетического мониторинга ===
Вы можете указать настройки прокси сразу для нескольких отслеживаемых технологий. Настройки, указанные в разделе <code>http.client.external</code>, влияют на Kubernetes, CloudFoundry и приватный синтетический мониторинг (этот набор может быть расширен в будущем):
 <code>[http.client.external]
 proxy-server=127.0.0.1
 proxy-port=8080
 # basic authentication credentials
 proxy-user=username
 proxy-password=password</code>
'''Примечание:'''

Для корректной работы связи АктивногоШлюза после указания вышеперечисленных настроек вам потребуется повторить настройки связи без прокси в <code>http.client.internal</code> или <code>http.client.external</code> и/или вам потребуется создать разделы <code>http.client.internal</code> или <code>http.client.external</code>.

=== Разные прокси для Kubernetes, CloudFoundry и частный синтетический мониторинг ===
Вы также можете указать выделенные настройки прокси для конкретной отслеживаемой технологии:

* Cloud Foundry в разделе <code>cloudfoundry_monitoring</code>
* Kubernetes в разделе <code>kubernetes_monitoring</code>
* Приватный синтетический мониторинг в разделе <code>synthetic</code>

 <code>[kubernetes_monitoring]
 proxy-server=127.0.0.1
 proxy-port=8080
 # basic authentication credentials
 proxy-user=username
 proxy-password=password</code>

== Текущие ограничения ==

=== Повторение настроек связи в <code>[http.client.internal]</code> или <code>[http.client.external]</code>. ===
При указании конфигурации прокси в <code>[http.client.internal]</code> или <code>[http.client.external]</code> обратите внимание, что эти разделы затрагивают различные аспекты связи, а не только прокси. При создании любого из этих разделов обязательно сначала скопируйте содержимое существующего раздела <code>[http.client]</code> из файла <code>configuration.properties</code> (и настройте его соответствующим образом):

* Откройте файл <code>config.properties</code> и скопируйте все свойства из раздела <code>[http.client]</code> в файл <code>custom.properties</code>, раздел <code>[http.client.internal]</code> или <code>[http.client.external]</code> (в зависимости от ситуации).
* Если в файле <code>custom.properties</code> есть раздел <code>[http.client]</code>, используйте перечисленные там значения, чтобы перезаписать указанные выше значения (значения, которые вы только что скопировали из <code>config.properties</code>).

 <code>[http.client.external]
 # proxy settings as specific to http.client.external:
 proxy-server=127.0.0.1
 proxy-port=8080
 # basic authentication credentials
 proxy-user=username
 proxy-password=password
 # communication settings copied from existing configuration:
 connection-timeout=5000
 socket-timeout=20000
 connection-request-timeout=5000
 idle-connection-timeout=15000
 max-total-connections=256
 max-connections-per-route=32
 certificate-validation=yes
 hostname-verification=yes</code>