Модуль fortinet.fortios.fortios_firewall_profile_protocol_options — настройка параметров протоколов в 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_profile_protocol_options.
Добавлено в fortinet.fortios 2.0.0
Обзор
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функций межсетевого экрана и категорию profile_protocol_options. В примерах приведены все параметры и значения, которые необходимо скорректировать с учетом источников данных перед использованием. Проверено на FOS v6.0.0
Требования
На хосте, на котором выполняется этот модуль, должны быть установлены следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Создается в графическом интерфейсе Fortigate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
firewall_profile_protocol_options dictionary | Настройка параметров протоколов. |
|
cifs dictionary |
Настройка параметров протокола CIFS. |
|
domain_controller string |
Домен, для которого необходимо расшифровывать трафик CIFS. Источник: user.domain-controller.name, credential-store.domain-controller.server-name. |
|
options list / elements=string |
Один или несколько параметров, которые можно применить к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, который можно проверить (МБ). |
|
ports list / elements=integer |
Порты для проверки содержимого (1–65535). |
|
scan_bzip2 string |
Включить или отключить проверку файлов, сжатых с помощью BZip2. Варианты:
|
|
server_credential_type string |
Тип учетных данных сервера CIFS. Варианты:
|
|
server_keytab list / elements=dictionary |
Таблица ключей сервера. |
|
keytab string |
Файл keytab в кодировке Base64, содержащий учетные данные сервера. |
|
principal string / обязательный |
Имя субъекта-службы. Например, host/cifsserver.example.com@example.com. |
|
status string |
Включить или отключить активное сканирование этого протокола. Варианты:
|
|
tcp_window_maximum integer |
Максимальный динамический размер окна TCP. |
|
tcp_window_minimum integer |
Минимальный динамический размер окна TCP. |
|
tcp_window_size integer |
Задать статический размер окна TCP. |
|
tcp_window_type string |
Тип окна TCP для этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальная глубина вложенности сжатия, которое можно распаковать и проверить (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, который можно проверить (МБ). |
|
comment string |
Необязательные комментарии. |
|
dns dictionary |
Настройка параметров протокола DNS. |
|
ports list / elements=integer |
Порты для проверки содержимого (1–65535). |
|
status string |
Включить или отключить активное сканирование этого протокола. Варианты:
|
|
ftp dictionary |
Настройка параметров протокола FTP. |
|
comfort_amount integer |
Количество байтов, отправляемых при каждой передаче для поддержания активности клиента (байты). |
|
comfort_interval integer |
Интервал между последовательными передачами данных для поддержания активности клиента (секунды). |
|
explicit_ftp_tls string |
Включить или отключить перенаправление FTP для явного FTPS. Варианты:
|
|
inspect_all string |
Включить или отключить проверку всех портов этого протокола. Варианты:
|
|
options list / elements=string |
Один или несколько параметров, которые можно применить к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, который можно проверить (МБ). |
|
ports list / elements=integer |
Порты для проверки содержимого (1–65535). |
|
scan_bzip2 string |
Включить или отключить проверку файлов, сжатых с помощью BZip2. Варианты:
|
|
ssl_offloaded string |
Расшифровка и шифрование SSL выполняются внешним устройством. Варианты:
|
|
status string |
Включить или отключить активное сканирование этого протокола. Варианты:
|
|
stream_based_uncompressed_limit integer |
Максимальный размер распакованных данных в потоке, подлежащих проверке, в мегабайтах. Распаковка в потоке используется только при определенных условиях (неограниченный размер = 0). |
|
tcp_window_maximum integer |
Максимальный динамический размер окна TCP. |
|
tcp_window_minimum integer |
Минимальный динамический размер окна TCP. |
|
tcp_window_size integer |
Задать статический размер окна TCP. |
|
tcp_window_type string |
Тип окна TCP для этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальная глубина вложенности сжатия, которое можно распаковать и проверить (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, который можно проверить (МБ). |
|
http dictionary |
Настройка параметров протокола HTTP. |
|
address_ip_rating string |
Включить или отключить оценку URL на основе IP-адреса. Варианты:
|
|
block_page_status_code integer |
Код, возвращаемый для заблокированных HTTP-страниц (только для страниц, не использующих FortiGuard) (100–599). |
|
comfort_amount integer |
Количество байтов, отправляемых при каждой передаче для поддержания активности клиента (байты). |
|
comfort_interval integer |
Интервал между последовательными передачами данных для поддержания активности клиента (секунды). |
|
domain_fronting string |
Настройка маскировки домена HTTP. Варианты:
|
|
fortinet_bar string |
Включить или отключить панель Fortinet в HTML-содержимом. Варианты:
|
|
fortinet_bar_port integer |
Порт для панели Fortinet (1–65535). |
|
h2c string |
Включить или отключить обновление HTTP-соединения до h2c. Варианты:
|
|
http_policy string |
Включить или отключить проверку политики HTTP. Варианты:
|
|
inspect_all string |
Включить или отключить проверку всех портов этого протокола. Варианты:
|
|
options list / elements=string |
Один или несколько параметров, которые можно применить к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, который можно проверить (МБ). |
|
ports list / elements=integer |
Порты для сканирования содержимого (1–65535). |
|
post_lang list / elements=string |
Коды ID наборов символов, используемых для преобразования в UTF-8 при проверке HTTP-запросов POST на запрещённые слова и утечки данных DLP (не более 5 наборов символов). Варианты:
|
|
proxy_after_tcp_handshake string |
Проксировать трафик после установки трёхэтапного TCP-соединения (не до этого). Варианты:
|
|
range_block string |
Включить или отключить блокировку частичных загрузок. Варианты:
|
|
retry_count integer |
Количество попыток повторного подключения по HTTP (0–100). |
|
scan_bzip2 string |
Включить или отключить сканирование файлов, сжатых с помощью BZip2. Варианты:
|
|
set_http_0dot9 string |
Настроить действие при получении запроса HTTP 0.9. Варианты:
|
|
ssl_offloaded string |
Расшифрование и шифрование SSL выполняются внешним устройством. Варианты:
|
|
status string |
Включить или отключить активное сканирование этого протокола. Варианты:
|
|
stream_based_uncompressed_limit integer |
Максимальный размер распакованных данных в потоке, подлежащих сканированию, в мегабайтах. Распаковка в потоке используется только при определённых условиях (0 означает отсутствие ограничений). |
|
streaming_content_bypass string |
Включить или отключить пропуск потокового содержимого без буферизации. Варианты:
|
|
strip_x_forwarded_for string |
Включить или отключить удаление заголовка HTTP X-Forwarded-For. Варианты:
|
|
switching_protocols string |
Исключить соединение из сканирования или заблокировать его, если оно пытается переключить протокол. Варианты:
|
|
tcp_window_maximum integer |
Максимальный размер динамического окна TCP. |
|
tcp_window_minimum integer |
Минимальный размер динамического окна TCP. |
|
tcp_window_size integer |
Задать статический размер окна TCP. |
|
tcp_window_type string |
Тип окна TCP для этого протокола. Варианты:
|
|
tunnel_non_http string |
Настроить обработку не-HTTP-трафика, когда профиль, настроенный для HTTP-трафика, принимает сеанс, не использующий HTTP. Такое может произойти, если приложение отправляет не-HTTP-трафик через порт назначения HTTP. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, подлежащего сканированию (МБ). |
|
unknown_content_encoding string |
Настроить действие устройства FortiGate при обнаружении неизвестного кодирования содержимого. Варианты:
|
|
unknown_http_version string |
Способ обработки сеансов HTTP, не соответствующих версиям HTTP 0.9, 1.0 или 1.1. Варианты:
|
|
verify_dns_for_policy_matching string |
Включить или отключить проверку DNS при сопоставлении с политиками. Варианты:
|
|
imap dictionary |
Настроить параметры протокола IMAP. |
|
inspect_all string |
Включить или отключить проверку всех портов протокола. Варианты:
|
|
options list / elements=string |
Один или несколько параметров, применяемых к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, подлежащего сканированию (МБ). |
|
ports list / elements=integer |
Порты для сканирования содержимого (1–65535). |
|
proxy_after_tcp_handshake string |
Проксировать трафик после установки трёхэтапного TCP-соединения (не до этого). Варианты:
|
|
scan_bzip2 string |
Включить или отключить сканирование файлов, сжатых с помощью BZip2. Варианты:
|
|
ssl_offloaded string |
Расшифрование и шифрование SSL выполняются внешним устройством. Варианты:
|
|
status string |
Включить или отключить активное сканирование этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, подлежащего сканированию (МБ). |
|
mail_signature dictionary |
Настроить подпись электронной почты. |
|
signature string |
Подпись, добавляемая к исходящим электронным письмам (если подпись содержит пробелы, заключите её в кавычки). |
|
status string |
Включить или отключить добавление подписи к сообщениям электронной почты SMTP при прохождении через FortiGate. Варианты:
|
|
mapi dictionary |
Настроить параметры протокола MAPI. |
|
options list / elements=string |
Один или несколько параметров, применяемых к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, подлежащего сканированию (МБ). |
|
ports list / elements=integer |
Порты для сканирования содержимого (1–65535). |
|
scan_bzip2 string |
Включить или отключить сканирование файлов, сжатых с помощью BZip2. Варианты:
|
|
status string |
Включить или отключить активное сканирование этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, подлежащего сканированию (МБ). |
|
name string / обязательный |
Имя. |
|
nntp dictionary |
Настроить параметры протокола NNTP. |
|
inspect_all string |
Включить или отключить проверку всех портов протокола. Варианты:
|
|
options list / elements=string |
Один или несколько параметров, применяемых к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, подлежащего сканированию (МБ). |
|
ports list / elements=integer |
Порты для сканирования содержимого (1–65535). |
|
proxy_after_tcp_handshake string |
Проксировать трафик после установления трехэтапного рукопожатия TCP (не до него). Варианты:
|
|
scan_bzip2 string |
Включить или отключить сканирование файлов, сжатых с помощью BZip2. Варианты:
|
|
status string |
Включить или отключить активное сканирование для этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, который можно просканировать (МБ). |
|
oversize_log string |
Включить или отключить ведение журнала при блокировке антивирусом слишком больших файлов. Варианты:
|
|
pop3 dictionary |
Настройка параметров протокола POP3. |
|
inspect_all string |
Включить или отключить проверку всех портов протокола. Варианты:
|
|
options list / elements=string |
Один или несколько параметров, которые можно применить к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, который можно просканировать (МБ). |
|
ports list / elements=integer |
Порты для сканирования содержимого (1–65535). |
|
proxy_after_tcp_handshake string |
Проксировать трафик после установления трехэтапного рукопожатия TCP (не до него). Варианты:
|
|
scan_bzip2 string |
Включить или отключить сканирование файлов, сжатых с помощью BZip2. Варианты:
|
|
ssl_offloaded string |
Расшифровка и шифрование SSL выполняются внешним устройством. Варианты:
|
|
status string |
Включить или отключить активное сканирование для этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, который можно просканировать (МБ). |
|
replacemsg_group string |
Имя группы сообщений для замены. Источник: system.replacemsg-group.name. |
|
rpc_over_http string |
Включить или отключить проверку RPC через HTTP. Варианты:
|
|
smtp dictionary |
Настройка параметров протокола SMTP. |
|
inspect_all string |
Включить или отключить проверку всех портов протокола. Варианты:
|
|
options list / elements=string |
Один или несколько параметров, которые можно применить к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, который можно просканировать (МБ). |
|
ports list / elements=integer |
Порты для сканирования содержимого (1–65535). |
|
proxy_after_tcp_handshake string |
Проксировать трафик после установления трехэтапного рукопожатия TCP (не до него). Варианты:
|
|
scan_bzip2 string |
Включить или отключить сканирование файлов, сжатых с помощью BZip2. Варианты:
|
|
server_busy string |
Включить или отключить сообщение о занятости SMTP-сервера, когда сервер недоступен. Варианты:
|
|
ssl_offloaded string |
Расшифровка и шифрование SSL выполняются внешним устройством. Варианты:
|
|
status string |
Включить или отключить активное сканирование для этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, который можно просканировать (МБ). |
|
ssh dictionary |
Настройка параметров протоколов SFTP и SCP. |
|
comfort_amount integer |
Количество байтов, отправляемых при каждой передаче для поддержания активности клиента (байты). |
|
comfort_interval integer |
Интервал между последовательными передачами данных для поддержания активности клиента (секунды). |
|
options list / elements=string |
Один или несколько параметров, которые можно применить к сеансу. Варианты:
|
|
oversize_limit integer |
Максимальный размер файла в памяти, который можно просканировать (МБ). |
|
scan_bzip2 string |
Включить или отключить сканирование файлов, сжатых с помощью BZip2. Варианты:
|
|
ssl_offloaded string |
Расшифровка и шифрование SSL выполняются внешним устройством. Варианты:
|
|
stream_based_uncompressed_limit integer |
Максимальный размер распакованных данных в потоковом режиме, который будет просканирован (МБ). Распаковка в потоковом режиме используется только при определенных условиях (0 означает отсутствие ограничения). |
|
tcp_window_maximum integer |
Максимальный динамический размер окна TCP. |
|
tcp_window_minimum integer |
Минимальный динамический размер окна TCP. |
|
tcp_window_size integer |
Задать статический размер окна TCP. |
|
tcp_window_type string |
Тип окна TCP для этого протокола. Варианты:
|
|
uncompressed_nest_limit integer |
Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать (2–100). |
|
uncompressed_oversize_limit integer |
Максимальный размер распакованного файла в памяти, который можно просканировать (МБ). |
|
switching_protocols_log string |
Включить или отключить ведение журнала для протоколов переключения HTTP/HTTPS. Варианты:
|
member_path string | Путь к атрибуту элемента, с которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр member_path предназначен для выполнения операций с элементами. |
member_state string | Добавить или удалить элемент по указанному пути атрибута. Если указан member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
vdom string | Виртуальный домен из числа предварительно определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Устаревший fortiosapi объявлен нерекомендуемым; для запуска плейбуков предпочтительно использовать httpapi
- Модуль поддерживает режим check_mode.
Примеры
- name: Configure protocol options.
fortinet.fortios.fortios_firewall_profile_protocol_options:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
firewall_profile_protocol_options:
cifs:
domain_controller: "<your_own_value> (source user.domain-controller.name credential-store.domain-controller.server-name)"
options: "oversize"
oversize_limit: "10"
ports: "<your_own_value>"
scan_bzip2: "enable"
server_credential_type: "none"
server_keytab:
-
keytab: "<your_own_value>"
principal: "<your_own_value>"
status: "enable"
tcp_window_maximum: "8388608"
tcp_window_minimum: "131072"
tcp_window_size: "262144"
tcp_window_type: "auto-tuning"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
comment: "Optional comments."
dns:
ports: "<your_own_value>"
status: "enable"
ftp:
comfort_amount: "1"
comfort_interval: "10"
explicit_ftp_tls: "enable"
inspect_all: "enable"
options: "clientcomfort"
oversize_limit: "10"
ports: "<your_own_value>"
scan_bzip2: "enable"
ssl_offloaded: "no"
status: "enable"
stream_based_uncompressed_limit: "0"
tcp_window_maximum: "8388608"
tcp_window_minimum: "131072"
tcp_window_size: "262144"
tcp_window_type: "auto-tuning"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
http:
address_ip_rating: "enable"
block_page_status_code: "403"
comfort_amount: "1"
comfort_interval: "10"
domain_fronting: "allow"
fortinet_bar: "enable"
fortinet_bar_port: "32767"
h2c: "enable"
set_http_0dot9: "allow"
http_policy: "disable"
inspect_all: "enable"
options: "clientcomfort"
oversize_limit: "10"
ports: "<your_own_value>"
post_lang: "jisx0201"
proxy_after_tcp_handshake: "enable"
range_block: "disable"
retry_count: "0"
scan_bzip2: "enable"
ssl_offloaded: "no"
status: "enable"
stream_based_uncompressed_limit: "0"
streaming_content_bypass: "enable"
strip_x_forwarded_for: "disable"
switching_protocols: "bypass"
tcp_window_maximum: "8388608"
tcp_window_minimum: "131072"
tcp_window_size: "262144"
tcp_window_type: "auto-tuning"
tunnel_non_http: "enable"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
unknown_content_encoding: "block"
unknown_http_version: "reject"
verify_dns_for_policy_matching: "enable"
imap:
inspect_all: "enable"
options: "fragmail"
oversize_limit: "10"
ports: "<your_own_value>"
proxy_after_tcp_handshake: "enable"
scan_bzip2: "enable"
ssl_offloaded: "no"
status: "enable"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
mail_signature:
signature: "<your_own_value>"
status: "disable"
mapi:
options: "fragmail"
oversize_limit: "10"
ports: "<your_own_value>"
scan_bzip2: "enable"
status: "enable"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
name: "default_name_100"
nntp:
inspect_all: "enable"
options: "oversize"
oversize_limit: "10"
ports: "<your_own_value>"
proxy_after_tcp_handshake: "enable"
scan_bzip2: "enable"
status: "enable"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
oversize_log: "disable"
pop3:
inspect_all: "enable"
options: "fragmail"
oversize_limit: "10"
ports: "<your_own_value>"
proxy_after_tcp_handshake: "enable"
scan_bzip2: "enable"
ssl_offloaded: "no"
status: "enable"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
replacemsg_group: "<your_own_value> (source system.replacemsg-group.name)"
rpc_over_http: "enable"
smtp:
inspect_all: "enable"
options: "fragmail"
oversize_limit: "10"
ports: "<your_own_value>"
proxy_after_tcp_handshake: "enable"
scan_bzip2: "enable"
server_busy: "enable"
ssl_offloaded: "no"
status: "enable"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
ssh:
comfort_amount: "1"
comfort_interval: "10"
options: "oversize"
oversize_limit: "10"
scan_bzip2: "enable"
ssl_offloaded: "no"
stream_based_uncompressed_limit: "0"
tcp_window_maximum: "8388608"
tcp_window_minimum: "131072"
tcp_window_size: "262144"
tcp_window_type: "auto-tuning"
uncompressed_nest_limit: "12"
uncompressed_oversize_limit: "10"
switching_protocols_log: "disable"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
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_profile_protocol_options_module.html