модуль fortinet.fortios.fortios_firewall_local_in_policy6 – Настройка пользовательских политик local-in IPv6 в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_firewall_local_in_policy6.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), устанавливая и изменяя параметры категории firewall local_in_policy6. В примерах приведены все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено на FOS v6.0.0
Требования
На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token строка | Аутентификация на основе токена. Токен создается в графическом интерфейсе FortiGate. |
enable_log логическое значение | Включить или отключить ведение журнала для задачи. Варианты:
|
firewall_local_in_policy6 словарь | Настройка пользовательских политик local-in IPv6. |
|
action строка |
Действие, выполняемое для трафика, соответствующего политике. Варианты:
|
|
comments строка |
Комментарий. |
|
dstaddr список / элементы=словарь |
Объект адреса назначения из доступных вариантов. |
|
name строка / обязательный |
Имя адреса. Источник: firewall.address6.name firewall.addrgrp6.name system.external-resource.name. |
|
dstaddr_negate строка |
Если параметр включен, dstaddr указывает, каким НЕ должен быть адрес назначения. Варианты:
|
|
internet_service6_src строка |
Включение или отключение использования интернет-служб IPv6 в качестве источника для этой политики local-in. Если параметр включен, исходный адрес не используется. Варианты:
|
|
internet_service6_src_custom список / элементы=словарь |
Имя пользовательской интернет-службы IPv6 для источника. |
|
name строка / обязательный |
Имя пользовательской интернет-службы. Источник: firewall.internet-service-custom.name. |
|
internet_service6_src_custom_group список / элементы=словарь |
Имя группы пользовательских интернет-служб IPv6 для источника. |
|
name строка / обязательный |
Имя группы пользовательских интернет-служб IPv6. Источник: firewall.internet-service-custom-group.name. |
|
internet_service6_src_fortiguard список / элементы=словарь |
Имя интернет-службы FortiGuard IPv6 для источника. |
|
name строка / обязательный |
Имя интернет-службы FortiGuard. Источник: firewall.internet-service-fortiguard.name. |
|
internet_service6_src_group список / элементы=словарь |
Имя группы интернет-служб IPv6 для источника. |
|
name строка / обязательный |
Имя группы интернет-служб. Источник: firewall.internet-service-group.name. |
|
internet_service6_src_name список / элементы=словарь |
Имя интернет-службы IPv6 для источника. |
|
name строка / обязательный |
Имя интернет-службы. Источник: firewall.internet-service-name.name. |
|
internet_service6_src_negate строка |
Если параметр включен, internet-service6-src указывает, какой НЕ должна быть служба. Варианты:
|
|
intf строка |
Имя входящего интерфейса из доступных вариантов. Источник: system.zone.name system.interface.name. |
|
intf_dict список / элементы=словарь |
Имя входящего интерфейса из доступных вариантов. |
|
name строка / обязательный |
Имя адреса. Источник: system.zone.name system.sdwan.zone.name system.interface.name. |
|
logtraffic строка |
Включение или отключение журналирования трафика local-in. Варианты:
|
|
policyid целое число / обязательный |
Идентификатор пользовательской политики local-in. См. <a href=’#notes’>Примечания</a>. |
|
schedule строка |
Объект расписания из доступных вариантов. Источник: firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group .name. |
|
service список / элементы=словарь |
Объект службы из доступных вариантов. Разделяйте имена пробелом. |
|
name строка / обязательный |
Имя службы. Источник: firewall.service.custom.name firewall.service.group.name. |
|
service_negate строка |
Если параметр включен, service указывает, какой НЕ должна быть служба. Варианты:
|
|
srcaddr список / элементы=словарь |
Объект исходного адреса из доступных вариантов. |
|
name строка / обязательный |
Имя адреса. Источник: firewall.address6.name firewall.addrgrp6.name system.external-resource.name. |
|
srcaddr_negate строка |
Если параметр включен, srcaddr указывает, каким НЕ должен быть исходный адрес. Варианты:
|
|
status строка |
Включение или отключение этой политики local-in. Варианты:
|
|
uuid строка |
Универсальный уникальный идентификатор (UUID; назначается автоматически, но может быть сброшен вручную). |
|
virtual_patch строка |
Включение или отключение функции виртуального исправления уязвимостей. Варианты:
|
member_path строка | Путь к атрибуту элемента, над которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр member_path можно использовать для выполнения операции над элементом. |
member_state строка | Добавить или удалить элемент по указанному пути к атрибуту. Если задан member_state, параметр state игнорируется. Варианты:
|
state строка / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
vdom строка | Виртуальный домен из числа ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Мы настоятельно рекомендуем использовать собственное значение policyid, а не 0. Значение «0» — это специальный заполнитель, который позволяет серверной части назначить объекту последний доступный номер, но у этого способа есть ограничения. Подробнее см. в разделе «Вопросы и ответы».
- Устаревший fortiosapi объявлен устаревшим; предпочтительный способ запуска плейбуков — httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Configure user defined IPv6 local-in policies.
fortinet.fortios.fortios_firewall_local_in_policy6:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
firewall_local_in_policy6:
action: "accept"
comments: "<your_own_value>"
dstaddr:
-
name: "default_name_6 (source firewall.address6.name firewall.addrgrp6.name system.external-resource.name)"
dstaddr_negate: "enable"
internet_service6_src: "enable"
internet_service6_src_custom:
-
name: "default_name_10 (source firewall.internet-service-custom.name)"
internet_service6_src_custom_group:
-
name: "default_name_12 (source firewall.internet-service-custom-group.name)"
internet_service6_src_fortiguard:
-
name: "default_name_14 (source firewall.internet-service-fortiguard.name)"
internet_service6_src_group:
-
name: "default_name_16 (source firewall.internet-service-group.name)"
internet_service6_src_name:
-
name: "default_name_18 (source firewall.internet-service-name.name)"
internet_service6_src_negate: "enable"
intf: "<your_own_value> (source system.zone.name system.interface.name)"
intf_dict:
-
name: "default_name_22 (source system.zone.name system.sdwan.zone.name system.interface.name)"
logtraffic: "enable"
policyid: "<you_own_value>"
schedule: "<your_own_value> (source firewall.schedule.onetime.name firewall.schedule.recurring.name firewall.schedule.group.name)"
service:
-
name: "default_name_27 (source firewall.service.custom.name firewall.service.group.name)"
service_negate: "enable"
srcaddr:
-
name: "default_name_30 (source firewall.address6.name firewall.addrgrp6.name system.external-resource.name)"
srcaddr_negate: "enable"
status: "enable"
uuid: "<your_own_value>"
virtual_patch: "enable"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи содержимого в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, полученный от FortiGate при выполнении последней операции Возвращается: всегда Пример: |
mkey string | Главный ключ (идентификатор), использованный при последнем вызове FortiGate Возвращается: при успехе Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер редакции Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат операции Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_firewall_local_in_policy6_module.html