Spec-Zone.ru › Ansible

fortinet.fortios.fortios_firewall_proxy_address модуль — Настройка веб-прокси-адреса в FortiOS и FortiGate Fortinet.

Примечание

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

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

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

Чтобы использовать его в плейбуке, укажите: fortinet.fortios.fortios_firewall_proxy_address.

Новый в fortinet.fortios 2.0.0

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата

Обзор

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

Требования

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

  • ansible>=2.15

Параметры

Параметр

Комментарии

access_token

string

Токенная аутентификация. Создаётся в GUI Fortigate.

enable_log

boolean

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

Варианты:

  • false ← (default)
  • true

firewall_proxy_address

dictionary

Настроить веб-прокси адрес.

application

list / elements=dictionary

SaaS приложение.

name

string / required

Имя SaaS приложения.

case_sensitivity

string

Включить, чтобы шаблон учитывал регистр.

Варианты:

  • "disable"
  • "enable"

category

list / elements=dictionary

ID категории FortiGuard.

id

integer / required

ID категории FortiGuard. Смотрите <a href=’#notes’>Примечания</a>.

color

integer

Целочисленное значение для определения цвета иконки в GUI (1 - 32).

comment

string

Дополнительные комментарии.

header

string

Имя HTTP заголовка как регулярное выражение.

header_group

list / elements=dictionary

Группа HTTP заголовков.

case_sensitivity

string

Регистрозависимость в шаблоне.

Варианты:

  • "disable"
  • "enable"

header

string

Регулярное выражение для HTTP заголовка.

header_name

string

HTTP заголовок.

id

integer / required

ID. Смотрите <a href=’#notes’>Примечания</a>.

header_name

string

Имя HTTP заголовка.

host

string

Объект адреса для хоста. Источник firewall.address.name firewall.addrgrp.name firewall.proxy-address.name.

host_regex

string

Имя хоста как регулярное выражение.

method

list / elements=string

HTTP методы запроса, которые будут использоваться.

Варианты:

  • "get"
  • "post"
  • "put"
  • "head"
  • "connect"
  • "trace"
  • "options"
  • "delete"

name

string / required

Имя адреса.

path

string

Путь URL как регулярное выражение.

query

string

Сопоставить часть запроса URL как регулярное выражение.

referrer

string

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

Варианты:

  • "enable"
  • "disable"

tagging

список / элементы=словарь

Тегирование конфигурации объекта.

category

строка

Категория тегов. Источник системы.object-tagging.category.

name

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

Имя записи тегирования.

tags

список / элементы=словарь

Теги.

name

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

Имя тега. Источник системы.object-tagging.tags.name.

type

строка

Тип прокси-адреса.

Варианты:

  • "host-regex"
  • "url"
  • "category"
  • "method"
  • "ua"
  • "header"
  • "src-advanced"
  • "dst-advanced"
  • "saas"

ua

список / элементы=строка

Названия браузеров, которые будут использоваться в качестве user agent.

Варианты:

  • "chrome"
  • "ms"
  • "firefox"
  • "safari"
  • "ie"
  • "edge"
  • "other"

ua_max_ver

строка

Максимальная версия user agent, указанная в точечной нотации. Например, используйте 120 со значением «chrome» в поле ua, чтобы потребовать, что максимальная версия Google Chrome должна быть 120.

ua_min_ver

строка

Минимальная версия user agent, указанная в точечной нотации. Например, используйте 90.0.1 со значением «chrome» в поле ua, чтобы потребовать, что минимальная версия Google Chrome должна быть 90.0.1.

uuid

строка

Универсальный уникальный идентификатор (UUID; автоматически назначается, но может быть вручную сброшен).

visibility

строка

Включить/выключить видимость объекта в графическом интерфейсе.

Варианты:

  • "enable"
  • "disable"

member_path

строка

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

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

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

member_state

строка

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

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

Варианты:

  • "present"
  • "absent"

state

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

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

Варианты:

  • "present"
  • "absent"

vdom

строка

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

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

Примечания

Примечание

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

Примеры

- name: Configure web proxy address.
  fortinet.fortios.fortios_firewall_proxy_address:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      firewall_proxy_address:
          application:
              -
                  name: "default_name_4"
          case_sensitivity: "disable"
          category:
              -
                  id: "7"
          color: "0"
          comment: "Optional comments."
          header: "<your_own_value>"
          header_group:
              -
                  case_sensitivity: "disable"
                  header: "<your_own_value>"
                  header_name: "<your_own_value>"
                  id: "15"
          header_name: "<your_own_value>"
          host: "myhostname (source firewall.address.name firewall.addrgrp.name firewall.proxy-address.name)"
          host_regex: "myhostname"
          method: "get"
          name: "default_name_20"
          path: "<your_own_value>"
          query: "<your_own_value>"
          referrer: "enable"
          tagging:
              -
                  category: "<your_own_value> (source system.object-tagging.category)"
                  name: "default_name_26"
                  tags:
                      -
                          name: "default_name_28 (source system.object-tagging.tags.name)"
          type: "host-regex"
          ua: "chrome"
          ua_max_ver: "<your_own_value>"
          ua_min_ver: "<your_own_value>"
          uuid: "<your_own_value>"
          visibility: "enable"

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

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

Ключ

Описание

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_firewall_proxy_address_module.html

Spec-Zone.ru

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