Spec-Zone.ru › Ansible

Модуль fortinet.fortios.fortios_web_proxy_forward_server – Настройка адресов серверов-прокси в FortiOS и FortiGate Fortinet.

Примечание

Этот модуль входит в коллекцию fortinet.fortios (версия 2.3.7).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля требуются дополнительные зависимости. Подробности см. в разделе Требования.

Чтобы использовать его в книге задач, укажите: fortinet.fortios.fortios_web_proxy_forward_server.

Новая функция в fortinet.fortios 2.0.0

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Описание

  • Этот модуль позволяет настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю устанавливать и изменять функцию web_proxy и категорию forward_server. Примеры включают все параметры и значения, которые необходимо настроить в источниках данных перед использованием. Тестировалось с FOS v6.0.0

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • ansible>=2.15

Параметры

Параметр

Комментарии

access_token

строка

Аутентификация на основе токена. Сгенерировано в графическом интерфейсе Fortigate.

enable_log

логическое

Включить/выключить протоколирование для задачи.

Варианты:

  • false ← (по умолчанию)
  • true

member_path

строка

Путь к атрибуту члена для выполнения операций.

Разделяется символом косой черты, если атрибутов несколько.

Параметр, помеченный member_path, подходит для выполнения операций с членом.

member_state

строка

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

Когда указан member_state, опция state игнорируется.

Варианты:

  • "present"
  • "absent"

state

строка / обязательно

Указывает, необходимо ли создать или удалить объект.

Варианты:

  • "present"
  • "absent"

vdom

строка

Виртуальная область, определённая ранее. VDOM — виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

По умолчанию: "root"

web_proxy_forward_server

словарь

Настройка адресов серверов переадресации.

addr_type

строка

Тип адреса сервера переадресации: IP или FQDN.

Варианты:

  • "ip"
  • "ipv6"
  • "fqdn"

comment

строка

Комментарий.

fqdn

строка

Полное доменное имя (FQDN) сервера переадресации.

healthcheck

строка

Включить/выключить проверку работоспособности сервера переадресации. Попытки подключения через удалённый сервер переадресации к месту назначения для проверки нормальной работы сервера переадресации.

Варианты:

  • "disable"
  • "enable"

ip

строка

IP-адрес прокси-сервера переадресации.

ipv6

строка

IPv6-адрес прокси-сервера переадресации.

masquerade

строка

Включить/выключить использование IP-адреса исходящего интерфейса в качестве IP-адреса клиента.

Варианты:

  • "enable"
  • "disable"

monitor

строка

URL для мониторинга проверки работоспособности сервера переадресации.

name

строка / обязательно

Имя сервера.

password

строка

Пароль аутентификации HTTP.

port

целое число

Номер порта, на который сервер переадресации ожидает HTTP-сессий (1—65535).

server_down_option

строка

Действие, которое нужно выполнить, когда сервер переадресации считается нерабочим: заблокировать сессии до восстановления сервера или передать сессии их месту назначения.

Варианты:

  • "block"
  • "pass"

username

строка

Имя пользователя аутентификации HTTP.

Примечания

Примечание

  • Модуль fortiosapi устарел, httpapi — предпочтительный способ запуска playbooks
  • Модуль поддерживает режим check_mode.

Примеры

- name: Configure forward-server addresses.
  fortinet.fortios.fortios_web_proxy_forward_server:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      web_proxy_forward_server:
          addr_type: "ip"
          comment: "Comment."
          fqdn: "<your_own_value>"
          healthcheck: "disable"
          ip: "<your_own_value>"
          ipv6: "<your_own_value>"
          masquerade: "enable"
          monitor: "<your_own_value>"
          name: "default_name_11"
          password: "<your_own_value>"
          port: "3128"
          server_down_option: "block"
          username: "<your_own_value>"

Значения возврата

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

Ключ

Описание

build

строка

Номер сборки образа FortiGate

Возвращается: всегда

Пример: "1547"

http_method

строка

Последний метод, используемый для предоставления контента в FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

строка

Последний результат, полученный от FortiGate после последней операции

Возвращается: всегда

Пример: "200"

mkey

строка

Главный ключ (id), используемый в последнем вызове FortiGate

Возвращается: успешно

Пример: "id"

name

строка

Имя таблицы, используемой для выполнения запроса

Возвращается: всегда

Пример: "urlfilter"

path

строка

Путь к таблице, используемой для выполнения запроса

Возвращается: всегда

Пример: "webfilter"

revision

строка

Внутренний номер ревизии

Возвращается: всегда

Пример: "17.0.2.10658"

serial

строка

Серийный номер устройства

Возвращается: всегда

Пример: "FGVMEVYYQT3AB5352"

status

строка

Указание результата операции

Возвращается: всегда

Пример: "success"

vdom

строка

Используемый виртуальный домен

Возвращается: всегда

Пример: "root"

version

строка

Версия FortiGate

Возвращается: всегда

Пример: "v5.6.3"

Авторы

  • Link Zheng (@chillancezen)
  • Jie Xue (@JieX19)
  • Hongbin Lu (@fgtdev-hblu)
  • Frank Shen (@frankshen01)
  • Miguel Angel Munoz (@mamunozgonzalez)
  • Nicolas Thomas (@thomnico)

Ссылки на коллекцию

  • Система отслеживания ошибок
  • Главная страница
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/fortinet/fortios/fortios_web_proxy_forward_server_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API