fortinet.fortios.fortios_endpoint_control_forticlient_ems module – Configure FortiClient Enterprise Management Server (EMS) entries in Fortinet’s FortiOS and FortiGate.

Примечание

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

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

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

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

Новое в fortinet.fortios 2.0.0

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

Краткое описание

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

Требования

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

ansible>=2.15

Параметры

Параметр	Комментарии
access_token string	Токенная аутентификация. Создается в GUI Fortigate.
enable_log boolean	Включить/Выключить логирование для задачи. Варианты: `false` ← (по умолчанию) `true`
endpoint_control_forticlient_ems dictionary	Настройка записей сервера управления FortiClient Enterprise Management Server (EMS).
address string	Имя адреса брандмауэра. Источник firewall.address.name.
admin_password string	Пароль администратора FortiClient EMS.
admin_type string	Тип администратора FortiClient EMS. Варианты: `"Windows"` `"LDAP"`
admin_username string	Имя пользователя администратора FortiClient EMS.
https_port integer	Номер порта доступа HTTPS FortiClient EMS. (1 - 65535).
listen_port integer	Номер порта прослушивания телеметрии FortiClient EMS. (1 - 65535).
name string / required	Имя сервера управления FortiClient Enterprise Management Server (EMS).
rest_api_auth string	Аутентификация REST API FortiClient EMS. Варианты: `"disable"` `"userpass"`
serial_number string	Серийный номер FortiClient EMS.
upload_port integer	Номер порта загрузки телеметрии FortiClient EMS. (1 - 65535).
member_path string	Путь к атрибуту элемента для выполнения операции. Разделяется символом слеша, если атрибутов больше одного. Параметр, помеченный member_path, является допустимым для выполнения операции с элементом.
member_state string	Добавить или удалить элемент под указанным путем к атрибуту. Когда указан member_state, параметр state игнорируется. Варианты: `"present"` `"absent"`
state string / required	Указывает, следует ли создать или удалить объект. Варианты: `"present"` `"absent"`
vdom string	Виртуальный домен, среди тех, которые были определены ранее. Vdom — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельную единицу. По умолчанию: `"root"`

Примечания

Примечание

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

Примеры

- name: Configure FortiClient Enterprise Management Server (EMS) entries.
  fortinet.fortios.fortios_endpoint_control_forticlient_ems:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      endpoint_control_forticlient_ems:
          address: "<your_own_value> (source firewall.address.name)"
          admin_password: "<your_own_value>"
          admin_type: "Windows"
          admin_username: "<your_own_value>"
          https_port: "32767"
          listen_port: "32767"
          name: "default_name_9"
          rest_api_auth: "disable"
          serial_number: "<your_own_value>"
          upload_port: "32767"

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

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

Ключ	Описание
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_forticlient_ems_module.html