Spec-Zone.ru › Ansible

Модуль fortinet.fortimanager.fmgr_firewall_profileprotocoloptions_cifs — настройка параметров протокола CIFS.

Примечание

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

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

Чтобы установить ее, используйте: ansible-galaxy collection install fortinet.fortimanager.

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

Добавлено в fortinet.fortimanager 2.1.0

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

Обзор

  • Этот модуль позволяет настроить устройство FortiManager.
  • Примеры включают все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием.

Параметры

Параметр

Комментарии

access_token

string

Токен для доступа к FortiManager без использования имени пользователя и пароля.

adom

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

Параметр (adom) в запрошенном URL.

bypass_validation

boolean

Установите значение True только в том случае, если схема модуля отличается от структуры API FortiManager; модуль продолжит выполнение без проверки параметров.

Варианты:

  • false ← (по умолчанию)
  • true

enable_log

boolean

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

Варианты:

  • false ← (по умолчанию)
  • true

firewall_profileprotocoloptions_cifs

dictionary

Заданный набор параметров верхнего уровня.

domain_controller

псевдонимы: domain-controller

string

Домен, для которого следует расшифровывать трафик CIFS.

file_filter

псевдонимы: file-filter

dictionary

Фильтр файлов.

entries

list / элементы=dictionary

Записи.

action

string

Действие, выполняемое для совпавшего файла.

Варианты:

  • "log"
  • "block"

comment

string

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

direction

string

Сопоставлять файлы, передаваемые в исходном или ответном направлении сеанса.

Варианты:

  • "any"
  • "incoming"
  • "outgoing"

file_type

псевдонимы: file-type

any

(список) Выберите тип файла.

filter

string

Добавить фильтр файлов.

protocol

list / элементы=string

Протоколы, к которым применяется фильтр.

Варианты:

  • "cifs"

log

string

Включить/отключить ведение журнала фильтра файлов.

Варианты:

  • "disable"
  • "enable"

status

string

Включить/отключить фильтр файлов.

Варианты:

  • "disable"
  • "enable"

options

list / элементы=string

Один или несколько параметров, которые можно применить к сеансу.

Варианты:

  • "oversize"

oversize_limit

псевдонимы: oversize-limit

integer

Максимальный размер файла в памяти, который можно просканировать

ports

any

(список) Порты, содержимое которых следует сканировать

scan_bzip2

псевдонимы: scan-bzip2

string

Включить/отключить сканирование файлов, сжатых с помощью BZip2.

Варианты:

  • "disable"
  • "enable"

server_credential_type

псевдонимы: server-credential-type

string

Тип учетных данных сервера CIFS.

Варианты:

  • "none"
  • "credential-replication"
  • "credential-keytab"

server_keytab

псевдонимы: server-keytab

list / элементы=dictionary

Таблица ключей сервера.

keytab

string

Файл keytab в кодировке Base64, содержащий учетные данные сервера.

password

any

(список) Пароль для keytab.

principal

string

Сервисный принципал.

status

string

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

Варианты:

  • "disable"
  • "enable"

tcp_window_maximum

псевдонимы: tcp-window-maximum

integer

Максимальный размер динамического окна TCP

tcp_window_minimum

псевдонимы: tcp-window-minimum

integer

Минимальный размер динамического окна TCP

tcp_window_size

псевдонимы: tcp-window-size

integer

Задать статический размер окна TCP

tcp_window_type

псевдонимы: tcp-window-type

string

Укажите тип окна TCP, используемого для этого протокола.

Варианты:

  • "system"
  • "static"
  • "dynamic"
  • "auto-tuning"

uncompressed_nest_limit

псевдонимы: uncompressed-nest-limit

integer

Максимальное количество вложенных уровней сжатия, которые можно распаковать и просканировать

uncompressed_oversize_limit

псевдонимы: uncompressed-oversize-limit

integer

Максимальный размер распакованного файла в памяти, который можно просканировать

forticloud_access_token

string

Аутентификация клиента Ansible с помощью токена доступа к API forticloud.

profile-protocol-options

string

Устарело, используйте “profile_protocol_options”

profile_protocol_options

string

Параметр (profile-protocol-options) в запрошенном URL.

proposed_method

string

Переопределенный метод для базового запроса Json RPC.

Варианты:

  • "update"
  • "set"
  • "add"

rc_failed

list / элементы=integer

Список кодов rc, переопределяющий условия, при которых выполнение считается неудачным.

rc_succeeded

list / элементы=integer

Список кодов rc, переопределяющий условия, при которых выполнение считается успешным.

revision_note

string

Примечание об изменении, которое можно указать при создании или обновлении объекта.

workspace_locking_adom

string

ADOM, который нужно заблокировать для FortiManager, работающего в режиме рабочей области; значением может быть global или другие ADOM, включая root.

workspace_locking_timeout

integer

Максимальное время в секундах ожидания освобождения блокировки рабочей области другим пользователем.

По умолчанию: 300

Примечания

Примечание

  • Начиная с версии 2.4.0, все входные аргументы именуются с использованием соглашения об именовании через подчеркивание (snake_case). Замените аргументы, например “var-name”, на “var_name”. Старые имена аргументов по-прежнему доступны, но при их использовании будут выдаваться предупреждения об устаревании. Это предупреждение можно отключить, задав deprecation_warnings=False в ansible.cfg.
  • Этот модуль FortiManager поддерживает работу в режиме блокировки рабочей области; параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout позволяют управлять этим режимом.
  • Обычно выполнение одного модуля может завершиться ошибкой при возврате ненулевого кода rc. Условия завершения с ошибкой или успехом также можно переопределить с помощью параметров rc_failed и rc_succeeded

Примеры

- name: Example playbook (generated based on argument schema)
  hosts: fortimanagers
  connection: httpapi
  gather_facts: false
  tasks:
    - name: Configure CIFS protocol options.
      fortinet.fortimanager.fmgr_firewall_profileprotocoloptions_cifs:
        # workspace_locking_adom: <global or your adom name>
        adom: <your own value>
        profile_protocol_options: <your own value>
        firewall_profileprotocoloptions_cifs:
          # ports: <list or integer>
          # status: <value in [disable, enable]>
          # options: ["oversize"]
          # oversize_limit: <integer>
          # scan_bzip2: <value in [disable, enable]>
          # tcp_window_maximum: <integer>
          # tcp_window_minimum: <integer>
          # tcp_window_size: <integer>
          # tcp_window_type: <value in [system, static, dynamic, ...]>
          # uncompressed_nest_limit: <integer>
          # uncompressed_oversize_limit: <integer>
          # domain_controller: <string>
          # file_filter:
          #   entries:
          #     - action: <value in [log, block]>
          #       comment: <string>
          #       direction: <value in [any, incoming, outgoing]>
          #       file_type: <list or string>
          #       filter: <string>
          #       protocol: ["cifs"]
          #   log: <value in [disable, enable]>
          #   status: <value in [disable, enable]>
          # server_credential_type: <value in [none, credential-replication, credential-keytab]>
          # server_keytab:
          #   - keytab: <string>
          #     password: <list or string>
          #     principal: <string>

Возвращаемые значения

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

Ключ

Описание

meta

словарь

Результат запроса.

Возвращается: всегда

request_url

строка

Полный URL запроса.

Возвращается: всегда

Пример: "/sys/login/user"

response_code

целое число

Статус запроса API.

Возвращается: всегда

Пример: 0

response_data

список / elements=string

Ответ API.

Возвращается: всегда

response_message

строка

Описание ответа API.

Возвращается: всегда

Пример: "OK."

system_information

словарь

Информация о целевой системе.

Возвращается: всегда

rc

целое число

Статус запроса.

Возвращается: всегда

Пример: 0

version_check_warning

список / elements=string

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

Возвращается: сложное значение

Авторы

  • Xinwei Du (@dux-fortinet)
  • Xing Li (@lix-fortinet)
  • Jie Xue (@JieX19)
  • Link Zheng (@chillancezen)
  • Frank Shen (@fshen01)
  • Hongbin Lu (@fgtdev-hblu)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 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/fortimanager/fmgr_firewall_profileprotocoloptions_cifs_module.html

Spec-Zone.ru

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