Настройка 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)#