Spec-Zone.ru › Ansible

fortinet.fortios.fortios_endpoint_control_settings модуль — Настройка параметров контроля конечных точек в FortiOS и FortiGate Fortinet.

Примечание

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

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

Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля потребуются дополнительные требования, см. Требования для получения подробной информации.

Для использования в книге задач укажите: fortinet.fortios.fortios_endpoint_control_settings.

Новый в fortinet.fortios 2.0.0

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

Описание

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

Требования

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

  • ansible>=2.15

Параметры

Параметр

Комментарии

access_token

строка

Аутентификация на основе токена. Сгенерировано из графического интерфейса Fortigate.

enable_log

логическое значение

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

Варианты:

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

endpoint_control_settings

словарь

Настройка параметров управления конечными точками.

download_custom_link

строка

Настраиваемый URL для загрузки FortiClient.

download_location

строка

Расположение для загрузки FortiClient (FortiGuard или настраиваемое).

Варианты:

  • "fortiguard"
  • "custom"

forticlient_avdb_update_interval

целое число

Период времени между обновлениями базы данных антивируса FortiClient (0 - 24 часа).

forticlient_dereg_unsupported_client

строка

Включить/выключить удаление с регистрации неподдерживаемых конечных точек FortiClient.

Варианты:

  • "enable"
  • "disable"

forticlient_disconnect_unsupported_client

строка

Включить/выключить отключение неподдерживаемых конечных точек FortiClient.

Варианты:

  • "enable"
  • "disable"

forticlient_ems_rest_api_call_timeout

целое число

Таймаут вызова FortiClient EMS в миллисекундах (500 - 30000 миллисекунд).

forticlient_keepalive_interval

целое число

Интервал между двумя сообщениями KeepAlive от FortiClient (20 - 300 сек).

forticlient_offline_grace

строка

Включить/выключить период благоприятствования для оффлайн зарегистрированных клиентов.

Варианты:

  • "enable"
  • "disable"

forticlient_offline_grace_interval

целое число

Период благоприятствования для оффлайн зарегистрированных FortiClient (60 - 600 сек).

forticlient_reg_key

строка

Ключ регистрации FortiClient.

forticlient_reg_key_enforce

строка

Включить/выключить требование или принудительное использование ключей регистрации FortiClient.

Варианты:

  • "enable"
  • "disable"

forticlient_reg_timeout

целое число

Таймаут лицензии регистрации FortiClient (дни, мин = 1, макс = 180, 0 означает неограниченный).

forticlient_sys_update_interval

целое число

Интервал между двумя сообщениями о системном обновлении от FortiClient (30 - 1440 мин).

forticlient_user_avatar

строка

Включить/выключить загрузку аватаров пользователей FortiClient.

Варианты:

  • "enable"
  • "disable"

forticlient_warning_interval

целое число

Период времени между предупреждениями портала FortiClient (0 - 24 часа).

override

строка

Переопределяет глобальную таблицу EMS для данного VDOM.

Варианты:

  • "enable"
  • "disable"

member_path

строка

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

Разделяется слешем, если атрибутов несколько.

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

member_state

string

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

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

Варианты:

  • "present"
  • "absent"

vdom

string

Виртуальный домен, среди ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельный модуль.

Значение по умолчанию: "root"

Примечания

Примечание

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

Примеры

- name: Configure endpoint control settings.
  fortinet.fortios.fortios_endpoint_control_settings:
      vdom: "{{ vdom }}"
      endpoint_control_settings:
          download_custom_link: "<your_own_value>"
          download_location: "fortiguard"
          forticlient_avdb_update_interval: "12"
          forticlient_dereg_unsupported_client: "enable"
          forticlient_disconnect_unsupported_client: "enable"
          forticlient_ems_rest_api_call_timeout: "15000"
          forticlient_keepalive_interval: "150"
          forticlient_offline_grace: "enable"
          forticlient_offline_grace_interval: "300"
          forticlient_reg_key: "<your_own_value>"
          forticlient_reg_key_enforce: "enable"
          forticlient_reg_timeout: "90"
          forticlient_sys_update_interval: "720"
          forticlient_user_avatar: "enable"
          forticlient_warning_interval: "12"
          override: "enable"

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

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

Ключ

Описание

build

string

Номер сборки образа fortigate

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

Пример: "1547"

http_method

string

Последний метод, использованный для подготовки контента в FortiGate

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

Пример: "PUT"

http_status

string

Последний результат, полученный от FortiGate при последней выполненной операции

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

Пример: "200"

mkey

string

Главный ключ (id), использованный в последнем вызове FortiGate

Возвращается: при успехе

Пример: "id"

name

string

Имя таблицы, используемой для выполнения запроса

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

Пример: "urlfilter"

path

string

Путь к таблице, используемой для выполнения запроса

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

Пример: "webfilter"

revision

string

Внутренний номер ревизии

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

Пример: "17.0.2.10658"

serial

string

Серийный номер устройства

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

Пример: "FGVMEVYYQT3AB5352"

status

string

Указание результата операции

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

Пример: "success"

vdom

string

Использованный виртуальный домен

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

Пример: "root"

version

string

Версия 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_endpoint_control_settings_module.html

Spec-Zone.ru

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