fortinet.fortios.fortios_wanopt_profile – Настройка профилей оптимизации WAN в FortiOS и FortiGate Fortinet.

Примечание

Этот плагин является частью коллекции fortinet.fortios (версия 1.1.8).

Для его установки используйте: ansible-galaxy collection install fortinet.fortios.

Для использования в playbook, укажите: fortinet.fortios.fortios_wanopt_profile.

Введено в версии 2.8: of fortinet.fortios

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

Обзор

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

Требования

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

ansible>=2.9.0

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
access_token строка				Аутентификация на основе токена. Сгенерировано из графического интерфейса Fortigate.
state строка добавлен в 2.9 fortinet.fortios			Варианты: present absent	Указывает, нужно ли создавать или удалять объект. Этот атрибут уже был в предыдущей версии на более глубоком уровне. Он был перенесен на этот внешний уровень.
vdom строка			Значение по умолчанию: "root"	Виртуальная область (vdom), среди тех, которые были определены ранее. Vdom — виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельную единицу.
wanopt_profile словарь				Настройка профилей оптимизации WAN.
	auth_group строка			Дополнительно добавить группу аутентификации для ограничения доступа к туннелю оптимизации WAN для узлов в группе аутентификации. Источник wanopt.auth-group.name.
	cifs словарь			Включить/выключить оптимизацию WAN CIFS (общие папки Windows) и настроить функции оптимизации CIFS WAN.
		byte_caching строка	Варианты: enable disable	Включить/выключить кэширование байтов для HTTP. Кэширование байтов уменьшает объем трафика, кэшируя данные файлов, отправляемые через WAN, и в будущем обслуживая их из кэша.
		log_traffic строка	Варианты: enable disable	Включить/выключить ведение журнала.
		port целое число		Номер одного порта или диапазон номеров портов для CIFS. Только пакеты с номером порта назначения, соответствующим этому номеру или диапазону, принимаются этим профилем.
		prefer_chunking строка	Варианты: dynamic fix	Выбор динамического или фиксированного размера фрагментации данных для оптимизации WAN HTTP.
		secure_tunnel строка	Варианты: enable disable	Включить/выключить шифрование туннеля WAN Opt с помощью SSL. Защищенные и незащищенные туннели используют один и тот же порт TCP (7810).
		status строка	Варианты: enable disable	Включить/выключить оптимизацию WAN HTTP.
		tunnel_sharing строка	Варианты: private shared express-shared	Режим совместного использования туннеля для агрессивных/неагрессивных и/или интерактивных/неинтерактивных протоколов.
	comments строка			Комментарий.
	ftp словарь			Включить/выключить оптимизацию WAN FTP и настроить функции оптимизации FTP WAN.
		byte_caching строка	Варианты: enable disable	Включить/выключить кэширование байтов для HTTP. Кэширование байтов уменьшает объем трафика, кэшируя данные файлов, отправляемые через WAN, и в будущем обслуживая их из кэша.
		log_traffic строка	Варианты: enable disable	Включить/выключить ведение журнала.
		port целое число		Номер одного порта или диапазон номеров портов для FTP. Только пакеты с номером порта назначения, соответствующим этому номеру или диапазону, принимаются этим профилем.
		prefer_chunking строка	Варианты: dynamic fix	Выбор динамического или фиксированного размера фрагментации данных для оптимизации WAN HTTP.
		secure_tunnel строка	Варианты: enable disable	Включить/выключить шифрование туннеля WAN Opt с помощью SSL. Защищенные и незащищенные туннели используют один и тот же порт TCP (7810).
		status строка	Варианты: enable disable	Включить/выключить оптимизацию WAN HTTP.
		tunnel_sharing строка	Варианты: private shared express-shared	Режим совместного использования туннеля для агрессивных/неагрессивных и/или интерактивных/неинтерактивных протоколов.
	http словарь			Включить/выключить оптимизацию WAN HTTP и настроить функции оптимизации HTTP WAN.
		byte_caching строка	Варианты: enable disable	Включить/выключить кэширование байтов для HTTP. Кэширование байтов уменьшает объем трафика, кэшируя данные файлов, отправляемые через WAN, и в будущем обслуживая их из кэша.
		log_traffic строка	Варианты: enable disable	Включить/выключить ведение журнала.
		port целое число		Номер одного порта или диапазон номеров портов для HTTP. Только пакеты с номером порта назначения, соответствующим этому номеру или диапазону, принимаются этим профилем.
		prefer_chunking строка	Варианты: dynamic fix	Выбор динамического или фиксированного размера фрагментации данных для оптимизации WAN HTTP.
		secure_tunnel строка	Варианты: enable disable	Включить/выключить шифрование туннеля WAN Opt с помощью SSL. Защищенные и незащищенные туннели используют один и тот же порт TCP (7810).
		ssl строка	Варианты: enable disable	Включить/выключить перегрузку SSL/TLS (ускорение оборудования) для трафика HTTPS в этом туннеле.
		ssl_port целое число		Порт, на котором ожидать трафика HTTPS для перегрузки SSL/TLS.
		status строка	Варианты: enable disable	Включить/выключить оптимизацию WAN HTTP.
		tunnel_non_http строка	Варианты: enable disable	Настройка обработки не-HTTP-трафика, когда профиль, настроенный для HTTP-трафика, принимает сеанс не-HTTP. Может произойти, если приложение отправляет не-HTTP-трафик с использованием порта назначения HTTP.
		tunnel_sharing строка	Варианты: private shared express-shared	Режим совместного использования туннеля для агрессивных/неагрессивных и/или интерактивных/неинтерактивных протоколов.
		unknown_http_version строка	Варианты: reject tunnel best-effort	Как обрабатывать HTTP-сеансы, которые не соответствуют HTTP 0.9, 1.0 или 1.1.
	mapi словарь			Включить/выключить оптимизацию WAN электронной почты MAPI и настроить функции оптимизации MAPI WAN.
		byte_caching строка	Варианты: enable disable	Включить/выключить кэширование байтов для HTTP. Кэширование байтов уменьшает объем трафика, кэшируя данные файлов, отправляемые через WAN, и в будущем обслуживая их из кэша.
		log_traffic строка	Варианты: enable disable	Включить/выключить ведение журнала.

	порт целое число		Номер единственного порта или диапазон портов для MAPI. Этот профиль принимает только пакеты с номером порта назначения, соответствующим этому номеру порта или диапазону.
	secure_tunnel строка	Варианты: enable disable	Включить/отключить шифрование туннеля WAN Opt с помощью SSL. Защищенные и незащищенные туннели используют один и тот же TCP-порт (7810).
	status строка	Варианты: enable disable	Включить/отключить HTTP WAN Optimization.
	tunnel_sharing строка	Варианты: private shared express-shared	Режим совместного использования туннелей для агрессивных/неагрессивных и/или интерактивных/неинтерактивных протоколов.
name строка / обязательно			Имя профиля.
state строка		Варианты: present absent	Устаревшее Начиная с Ansible 2.9, рекомендуется использовать параметр «state» верхнего уровня. Указывает, нужно ли создать или удалить объект.
tcp словарь			Включить/отключить TCP WAN Optimization и настроить функции TCP WAN Optimization.
	byte_caching строка	Варианты: enable disable	Включить/отключить кэширование байтов для HTTP. Кэширование байтов уменьшает объем трафика, кэшируя данные файлов, отправляемые через WAN, и в будущем, если нужно, получая их из кэша.
	byte_caching_opt строка	Варианты: mem-only mem-disk	Выберите, использует ли TCP кэширование байтов только системную память или и память, и дисковое пространство.
	log_traffic строка	Варианты: enable disable	Включить/отключить ведение журнала.
	port строка		Номер единственного порта или диапазон портов для TCP. Этот профиль принимает только пакеты с номером порта назначения, соответствующим этому номеру порта или диапазону.
	secure_tunnel строка	Варианты: enable disable	Включить/отключить шифрование туннеля WAN Opt с помощью SSL. Защищенные и незащищенные туннели используют один и тот же TCP-порт (7810).
	ssl строка	Варианты: enable disable	Включить/отключить offloading SSL/TLS.
	ssl_port целое число		Порт, на котором ожидается HTTPS-трафик для SSL/TLS offloading.
	status строка	Варианты: enable disable	Включить/отключить HTTP WAN Optimization.
	tunnel_sharing строка	Варианты: private shared express-shared	Режим совместного использования туннелей для агрессивных/неагрессивных и/или интерактивных/неинтерактивных протоколов.
transparent строка		Варианты: enable disable	Включить/отключить прозрачный режим.

Примечания

Примечание

Устаревший модуль fortiosapi устарел, предпочтительным способом запуска playbooks является httpapi

Примеры

- hosts: fortigates
  collections:
    - fortinet.fortios
  connection: httpapi
  vars:
   vdom: "root"
   ansible_httpapi_use_ssl: yes
   ansible_httpapi_validate_certs: no
   ansible_httpapi_port: 443
  tasks:
  - name: Configure WAN optimization profiles.
    fortios_wanopt_profile:
      vdom:  "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      wanopt_profile:
        auth_group: "<your_own_value> (source wanopt.auth-group.name)"
        cifs:
            byte_caching: "enable"
            log_traffic: "enable"
            port: "7"
            prefer_chunking: "dynamic"
            secure_tunnel: "enable"
            status: "enable"
            tunnel_sharing: "private"
        comments: "<your_own_value>"
        ftp:
            byte_caching: "enable"
            log_traffic: "enable"
            port: "16"
            prefer_chunking: "dynamic"
            secure_tunnel: "enable"
            status: "enable"
            tunnel_sharing: "private"
        http:
            byte_caching: "enable"
            log_traffic: "enable"
            port: "24"
            prefer_chunking: "dynamic"
            secure_tunnel: "enable"
            ssl: "enable"
            ssl_port: "28"
            status: "enable"
            tunnel_non_http: "enable"
            tunnel_sharing: "private"
            unknown_http_version: "reject"
        mapi:
            byte_caching: "enable"
            log_traffic: "enable"
            port: "36"
            secure_tunnel: "enable"
            status: "enable"
            tunnel_sharing: "private"
        name: "default_name_40"
        tcp:
            byte_caching: "enable"
            byte_caching_opt: "mem-only"
            log_traffic: "enable"
            port: "<your_own_value>"
            secure_tunnel: "enable"
            ssl: "enable"
            ssl_port: "48"
            status: "enable"
            tunnel_sharing: "private"
        transparent: "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 строка	всегда	Указание результата операции Пример: успех
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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/fortinet/fortios/fortios_wanopt_profile_module.html