Spec-Zone.ru › Ansible

fortinet.fortios.fortios_firewall_ippool модуль — Настройка IP-пулов IPv4 в 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_ippool.

Новое в fortinet.fortios 2.0.0

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

Описание

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

Требования

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

  • ansible>=2.15

Параметры

Параметр

Комментарии

access_token

string

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

enable_log

boolean

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

Варианты:

  • false ← (default)
  • true

firewall_ippool

dictionary

Настроить пулы IPv4 IP адресов.

add_nat64_route

string

Включить/выключить добавление маршрута NAT64.

Варианты:

  • "disable"
  • "enable"

arp_intf

string

Выберите интерфейс из доступных вариантов, который будет отвечать на ARP-запросы. (Если пусто, выбирается любой). Источник system.interface.name.

arp_reply

string

Включить/выключить ответы на ARP-запросы при добавлении пула IP-адресов к политике.

Варианты:

  • "disable"
  • "enable"

associated_interface

string

Имя связанного интерфейса. Источник system.interface.name.

block_size

integer

Количество адресов в блоке (64 - 4096).

comments

string

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

endip

string

Последний IPv4 адрес (включительно) в диапазоне для пула адресов (формат xxx.xxx.xxx.xxx).

endport

integer

Последний номер порта (включительно) в диапазоне для пула адресов.

name

string / required

Имя пула IP-адресов.

nat64

string

Включить/выключить NAT64.

Варианты:

  • "disable"
  • "enable"

num_blocks_per_user

integer

Количество блоков адресов, которые могут быть использованы пользователем (1 to 128).

pba_interim_log

integer

Интервал промежуточного логирования выделения блока портов (600 - 86400 секунд).

pba_timeout

integer

Таймаут выделения блока портов (секунды).

permit_any_host

string

Включить/выключить full cone NAT.

Варианты:

  • "disable"
  • "enable"

port_per_user

integer

Количество портов для каждого пользователя (32 - 60416).

source_endip

string

Последний IPv4 адрес (включительно) в диапазоне исходных адресов для перевода (формат xxx.xxx.xxx.xxx).

source_startip

string

Первый IPv4 адрес (включительно) в диапазоне исходных адресов для перевода (формат = xxx.xxx.xxx.xxx).

startip

string

Первый IPv4 адрес (включительно) в диапазоне для пула адресов (формат xxx.xxx.xxx.xxx).

startport

integer

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

subnet_broadcast_in_ippool

string

Включить/выключить включение адреса подсети и широковещательного IP-адреса в пул IP-адресов NAT64.

Варианты:

  • "disable"
  • "enable"

type

string

Тип IP-пула: overload, one-to-one, fixed-port-range, port-block-allocation, cgn-resource-allocation (только для гипермасштабируемого vdom)

Варианты:

  • "overload"
  • "one-to-one"
  • "fixed-port-range"
  • "port-block-allocation"

member_path

string

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

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

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

member_state

string

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

При указании member_state параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

state

string / обязательный

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

Варианты:

  • "present"
  • "absent"

vdom

string

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

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

Примечания

Примечание

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

Примеры

- name: Configure IPv4 IP pools.
  fortinet.fortios.fortios_firewall_ippool:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      firewall_ippool:
          add_nat64_route: "disable"
          arp_intf: "<your_own_value> (source system.interface.name)"
          arp_reply: "disable"
          associated_interface: "<your_own_value> (source system.interface.name)"
          block_size: "128"
          comments: "<your_own_value>"
          endip: "<your_own_value>"
          endport: "65533"
          name: "default_name_11"
          nat64: "disable"
          num_blocks_per_user: "8"
          pba_interim_log: "0"
          pba_timeout: "30"
          permit_any_host: "disable"
          port_per_user: "0"
          source_endip: "<your_own_value>"
          source_startip: "<your_own_value>"
          startip: "<your_own_value>"
          startport: "5117"
          subnet_broadcast_in_ippool: "disable"
          type: "overload"

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

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

Ключ

Описание

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

Spec-Zone.ru

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