Просмотреть исходный

Настройка HTTP/HTTPS прокси-сервера

ip http proxy

Данная команда позволяет перейти в настройки указанного http/https прокси-сервера или создать новый.

Использование отрицательной формы команды (no) удаляет указанный http/https прокси-сервер.

Синтаксис

ip http proxy <NAME>
no ip http proxy <NAME>

Параметры

<NAME> – название http/https прокси-сервера, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG

Пример

vesbc(config)# ip http proxy HTTP_PROXY
vesbc(config-http-proxy)#

crypto profile

Данная команда позволяет привязать крипто-профиль к http/https прокси-серверу.

Использование отрицательной формы команды (no) убирает привязанный крипто-профиль.

Синтаксис

crypto profile <NAME>
no crypto profile

Параметры

<NAME> – название привязываемого крипто-профиля, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# crypto profile CRYPTO_PROFILE 
vesbc(config-http-proxy)#

http port

Данная команда позволяет настроить TCP-порт для входящих http-подключений.

Использование отрицательной формы команды (no) удаляет порт.

Синтаксис

http port <PORT>
no http port

Параметры

<PORT> – TCP-порт для входящих http-подключений, принимает значения от 1 до 65535.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# http port 80
vesbc(config-http-proxy)#

https port

Данная команда позволяет настроить TCP-порт для входящих https-подключений.

Использование отрицательной формы команды (no) удаляет порт.

Синтаксис

https port <PORT>
no https port

Параметры

<PORT> – TCP-порт для входящих https-подключений, принимает значения от 1 до 65535.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# https port 443
vesbc(config-http-proxy)#

ip address

Данная команда позволяет настроить IP-адрес http/https прокси-сервера.

Использование отрицательной формы команды (no) удаляет настройку IP-адреса.

Синтаксис

ip address { interface <IFACE> | <IP_ADDR> }
no ip address

Параметры

<IFACE> – интерфейс, адрес которого будет использоваться для входящих http/https-подключений;

<IP_ADDR> – IP-адрес ESBC, который будет использоваться для входящих http/https-подключений.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# ip address 10.0.0.1
vesbc(config-http-proxy)#

ipv6 address

Данная команда позволяет настроить IPv6-адрес http/https прокси-сервера.

Использование отрицательной формы команды (no) удаляет настройку IP-адреса.

Синтаксис

ipv6 address { interface <IFACE> | <IP_ADDR> }
no ip address

Параметры

<IFACE> – интерфейс, IPv6-адрес которого будет использоваться для входящих http/https-подключений;

<IP_ADDR> – IPv6-адрес ESBC, который будет использоваться для входящих http/https-подключений.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# ipv6 address interface gigabitethernet 1/0/1
vesbc(config-http-proxy)#

mod-table

Данная команда позволяет привязать таблицу модификации к http/https прокси-серверу.

Использование отрицательной формы команды (no) удаляет привязку таблицы модификации.

Синтаксис

mod-table <NAME_MODTABLE>
no mod-table

Параметры

<NAME_MODTABLE> – название таблицы модификации, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# mod-table MOD_TABLE
vesbc(config-http-proxy)#

rename

Данная команда позволяет переименовать созданный http/https прокси-сервер.

Синтаксис

rename <NEW_NAME>

Параметры

<NEW_NAME> – новое название http/https прокси-сервера, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# rename NEW_PROXY_SERVER
vesbc(config-http-proxy)#

location

Данная команда позволяет создать локацию (точку выхода запроса на вышестоящий сервер/группу серверов) в данном http/https прокси-сервере.

Использование отрицательной формы команды (no) удаляет локацию.

Синтаксис

location <INDEX>
no location <INDEX>

Параметры

<INDEX> – номер локации, принимает значения от 0 до 39.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY

Пример

vesbc(config-http-proxy)# location 0
vesbc(config-http-proxy-location)#

crypto profile

Данная команда позволяет привязать крипто-профиль к локации. Выбранный профиль будет использоваться для установления защищенного соединения с вышестоящим сервером.

Использование отрицательной формы команды (no) убирает привязанный крипто-профиль.

Синтаксис

crypto profile <NAME>
no crypto profile

Параметры

<NAME> – название привязываемого крипто-профиля, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# crypto profile CRYPTO_PROFILE
vesbc(config-http-proxy-location)#

ip address

Данная команда позволяет настроить IPv4-адрес или интерфейс с IPv4-адресом, с которого будет осуществляться передача HTTP/HTTPS-запросов на вышестоящий сервер/группу серверов.

Использование отрицательной формы команды (no) удаляет настройку IP-адреса.

Синтаксис

ip address { interface <IFACE> | <IP_ADDR> }
no ip address

Параметры

<IFACE> – интерфейс, с которого будет осуществляться передача HTTP/HTTPS-запросов на вышестоящий сервер/группу серверов;

<IP_ADDR> – IP-адрес ESBC, с которого будет осуществляться передача HTTP/HTTPS-запросов на вышестоящий сервер/группу серверов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# ip address 192.168.1.1
vesbc(config-http-proxy-location)#

ipv6 address

Данная команда позволяет настроить IPv6-адрес или интерфейс с IPv6-адресом, с которого будет осуществляться передача HTTP/HTTPS-запросов на вышестоящий сервер/группу серверов.

Использование отрицательной формы команды (no) удаляет настройку IP-адреса.

Синтаксис

ipv6 address { interface <IFACE> | <IP_ADDR> }
no ip address

Параметры

<IFACE> – интерфейс, с которого будет осуществляться передача HTTP/HTTPS-запросов на вышестоящий сервер/группу серверов;

<IP_ADDR> – IPv6-адрес ESBC, с которого будет осуществляться передача HTTP/HTTPS-запросов на вышестоящий сервер/группу серверов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# ipv6 address interface gigabitethernet 1/0/2
vesbc(config-http-proxy-location)#

mod-table

Данная команда позволяет привязать таблицу модификации к локации.

Использование отрицательной формы команды (no) удаляет привязку таблицы модификации.

Синтаксис

mod-table <NAME_MODTABLE>
no mod-table

Параметры

<NAME_MODTABLE> – название таблицы модификации, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# mod-table MOD_TABLE
vesbc(config-http-proxy-location)#

upstream group

Данная команда позволяет назначить группу вышестоящих серверов, на которую будет перенаправлен входящий HTTP/HTTPS запрос, обработанный данной локацией.

Использование отрицательной формы команды (no) удаляет назначенную группу.

Синтаксис

upstream group <NAME>
no upstream group

Параметры

<NAME> – название группы вышестоящих серверов задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# upstream group UPSTREAM_GROUP
vesbc(config-http-proxy-location)#

upstream path

Данная команда позволяет настроить путь URL, на который будет заменяться путь из входящих HTTP/HTTPS-запросов, обрабатываемых данной локацией при проксировании их через upstream group.

Использование отрицательной формы команды (no) удаляет путь URL.

Синтаксис

upstream path <PATH>
no upstream path

Параметры

<PATH> – путь должен начинаться с символа '/' и может состоять из латинских букв (A-Z,a-z), цифр и символов '.', ',', '?', "'", '"', '/', '+', '&', '%', '$', '#', '=', '~', '_', '-', '@'. Максимальная длина — 127 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# upstream path /test_path
vesbc(config-http-proxy-location)#

upstream scheme

Данная команда позволяет настроить выбор протокола HTTP или HTTPS для исходящих запросов, обрабатываемых данной локацией для передачи их на вышестоящий сервер.

Использование отрицательной формы команды (no) устанавливает протокол по умолчанию.

Синтаксис

upstream scheme { http | https}
no upstream scheme

Параметры

http – использование протокола HTTP для исходящих запросов, обрабатываемых данной локацией для передачи их на вышестоящий сервер;

https – использование протокола HTTPS для исходящих запросов, обрабатываемых данной локацией для передачи их на вышестоящий сервер.

Значение по умолчанию

http

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# upstream scheme https
vesbc(config-http-proxy-location)#

url-pattern

Данная команда позволяет настроить отбор URL входящего сообщения для обработки этого сообщения данной локацией.

Использование отрицательной формы команды (no) удаляет отбор URL.

Синтаксис

url-pattern <WORD>
no url-pattern

Параметры

<WORD> – PCRE-шаблон от 1 до 127 символов для отбора URL входящего сообщения.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-PROXY-LOCATION

Пример

vesbc(config-http-proxy-location)# url-pattern .*
vesbc(config-http-proxy-location)#

Настройка группы вышестоящих серверов

ip http upstream-group

Данная команда позволяет перейти в настройки указанной группы вышестоящих серверов или создать новую.

Использование отрицательной формы команды (no) удаляет указанную группу вышестоящих серверов.

Синтаксис

ip http upstream-group <NAME>
no ip http upstream-group <NAME>

Параметры

<NAME> – название группы вышестоящих серверов, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG

Пример

vesbc(config)# ip http upstream-group UPSTREAM_GROUP
vesbc(config-http-upstream)#

balancing

Данная команда позволяет настроить режим балансировки исходящих http/https-запросов до вышестоящих серверов.

Использование отрицательной формы команды (no) устанавливает значение по умолчанию.

Синтаксис

balancing {carp | round-robin | sourcehash| weighted-round-robin}
no balancing

Параметры

carp – балансировка на основе хэширования URL;
round-robin – алгоритм циклического распределения нагрузки, при котором каждый новый запрос передается следующему хосту в списке по очереди. После достижения конца списка процесс возобновляется с первого хоста;
sourcehash – алгоритм балансировки нагрузки, при котором выбор целевого хоста осуществляется на основе хэширования IP-адреса источника (клиента) запроса. Это гарантирует, что все запросы от одного и того же пользователя будут направляться на один и тот же хост в течение всей сессии;
weighted-round-robin – алгоритм циклического распределения нагрузки с учетом весовых коэффициентов. Каждому хосту назначается вес (командой weight в настройках хоста), пропорционально которому он получает долю запросов. Чем выше вес хоста, тем больше запросов на него направляется в рамках одного цикла.

Значение по умолчанию

round-robin

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM

Пример

vesbc(config-http-upstream)# balancing weighted-round-robin
vesbc(config-http-upstream)#

rename

Данная команда позволяет переименовать группу вышестоящих серверов.

Синтаксис

rename <NEW_NAME>

Параметры

<NEW_NAME> – новое название группы вышестоящих серверов, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM

Пример

vesbc(config-http-upstream)# rename NEW_UPSTREAM_GROUP
vesbc(config-http-upstream)#

host

Данная команда позволяет создать вышестоящий сервер или выбрать созданный сервер для редактирования.

Использование отрицательной формы команды (no) удаляет вышестоящий сервер.

Синтаксис

host <INDEX>
no host <INDEX>

Параметры

<INDEX> – номер вышестоящего сервера, принимает значения от 0 до 49.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM

Пример

vesbc(config-http-upstream)# host 0
vesbc(config-http-upstream-host)#

address

Данная команда позволяет настроить IPv4/IPv6-адрес или доменное имя сервера, на который будут направляться исходящие http/https-запросы через данную группу вышестоящих серверов.

Использование отрицательной формы команды (no) удаляет настройку IP-адреса.

Синтаксис

address <ADDR>
no address

Параметры

<ADDR> – IPv4/IPv6-адрес или доменное имя вышестоящего сервера.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM-HOST

Пример

vesbc(config-http-upstream-host)# address 172.16.1.1
vesbc(config-http-upstream-host)#

http port

Данная команда позволяет настроить порт для обработки входящих HTTP-соединений вышестоящего сервера.

Использование отрицательной формы команды (no) удаляет настройку порта.

Синтаксис

http port <PORT>
no http port

Параметры

<PORT> – TCP-порт вышестоящего сервера, принимает значения от 1 до 65535.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM-HOST

Пример

vesbc(config-http-upstream-host)# http port 8080
vesbc(config-http-upstream-host)#

https port

Данная команда позволяет настроить порт для обработки входящих HTTPS-соединений вышестоящего сервера.

Использование отрицательной формы команды (no) удаляет настройку порта.

Синтаксис

https port <PORT>
no https port

Параметры

<PORT> – TCP-порт вышестоящего сервера, принимает значения от 1 до 65535.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM-HOST

Пример

vesbc(config-http-upstream-host)# https port 4443
vesbc(config-http-upstream-host)#

max connections

Данная команда позволяет настроить количество возможных одновременных TCP-соединений до вышестоящего сервера.

Использование отрицательной формы команды (no) устанавливает значение по умолчанию.

Синтаксис

max-connections <CONN>
no max-connections

Параметры

<CONN> – количество возможных одновременных TCP-соединений до вышестоящего сервера, принимает значения от 0 до 65535.

Значение по умолчанию

Без ограничений.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM-HOST

Пример

vesbc(config-http-upstream-host)# max-connections 100
vesbc(config-http-upstream-host)#

weight

Данная команда позволяет настроить вес вышестоящего сервера. Используется при режиме балансировки weighted-round-robin в группе вышестоящих серверов.

Использование отрицательной формы команды (no) устанавливает значение по умолчанию.

Синтаксис

weight <WEIGHT>
no weight

Параметры

<WEIGHT> – вес вышестоящего сервера, принимает значения от 0 до 65535.

Значение по умолчанию

100

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-UPSTREAM-HOST

Пример

vesbc(config-http-upstream-host)# weight 10000
vesbc(config-http-upstream-host)#

Настройка таблиц модификации ответов

ip http mod-table

Данная команда позволяет перейти в настройки указанной таблицы модификации или создать новую.

Использование отрицательной формы команды (no) удаляет указанную таблицу модификации.

Синтаксис

ip http mod-table <NAME>
no ip http mod-table <NAME>

Параметры

<NAME> – название таблицы модификации, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG

Пример

vesbc(config)# ip http mod-table MOD_TABLE
vesbc(config-http-mod-table)#

rename

Данная команда позволяет переименовать созданную таблицу модификации.

Синтаксис

rename <NEW_NAME>

Параметры

<NEW_NAME> – новое название таблицы модификации, задается строкой до 63 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-MOD-TABLE

Пример

vesbc(config-http-mod-table)# rename NEW_MOD_TABLE
vesbc(config-http-mod-table)#

modification

Данная команда позволяет создать модификацию в текущей таблице.

Использование отрицательной формы команды (no) удаляет модификацию.

Синтаксис

modification <INDEX>
no modification <INDEX>

Параметры

<INDEX> – номер модификации, принимает значения от 0 до 63.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-MOD-TABLE

Пример

vesbc(config-http-mod-table)# modification 0 
vesbc(config-http-mod-table-modification)#

value-pattern

Данная команда позволяет настроить отбор содержимого тела http/https-ответа для выполнения замены по PCRE-шаблону.

Использование отрицательной формы команды (no) удаляет отбор.

Синтаксис

value-pattern <WORD>
no value-pattern

Параметры

<WORD> – PCRE-шаблон от 1 до 127 символов для отбора какого-либо текста в теле (body) http/https-ответа.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-MOD-TABLE-MODIFICATION

Пример

vesbc(config-http-mod-table-modification)# value-pattern some_value
vesbc(config-http-mod-table-modification)#

replacement

Данная команда позволяет указать текст, на который будет заменено содержимое, выбранное параметром "value-pattern".

Использование отрицательной формы команды (no) удаляет текст для замены. Если не указывать параметр "replacement", то содержимое, отобранное параметром "value-pattern", будет удалено из тела ответа.

Синтаксис

replacement <WORD>
no replacement

Параметры

<WORD> – латинские буквы, цифры и символы, длина от 1 до 127 символов.

Значение по умолчанию

Отсутствует.

Необходимый уровень привилегий

15

Командный режим

CONFIG-HTTP-MOD-TABLE-MODIFICATION

Пример

vesbc(config-http-mod-table-modification)# replacement "new word" 
vesbc(config-http-mod-table-modification)#