fortios_endpoint_control_settings – Настройка параметров управления конечными точками в Fortinet’s FortiOS и FortiGate
Новое в версии 2.8.
Описание
- Этот модуль позволяет настраивать FortiGate или FortiOS, предоставляя пользователю возможность настройки функции endpoint_control и категории настроек. Примеры включают все варианты и требуют настройки перед использованием. Тестировалось с FOS v6.0.2
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- fortiosapi>=0.9.8
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| endpoint_control_settings - | Значение по умолчанию: null | Настройка параметров управления конечными точками. | |
| download-custom-link - | Настраиваемый URL для скачивания FortiClient. | ||
| download-location - |
| Место скачивания FortiClient (FortiGuard или настраиваемое). | |
| forticlient-avdb-update-interval - | Период времени между обновлениями базы данных FortiClient AntiVirus (0 - 24 часа, по умолчанию = 8). | ||
| forticlient-dereg-unsupported-client - |
| Включение/выключение отмены регистрации неподдерживаемых конечных точек FortiClient. | |
| forticlient-ems-rest-api-call-timeout - | Таймаут вызова FortiClient EMS в миллисекундах (500 - 30000 миллисекунд, по умолчанию = 5000). | ||
| forticlient-keepalive-interval - | Интервал между двумя сообщениями KeepAlive от FortiClient (20 - 300 сек, по умолчанию = 60). | ||
| forticlient-offline-grace - |
| Включение/выключение периода благодати для клиентов, отключенных от сети. | |
| forticlient-offline-grace-interval - | Период благодати для зарегистрированных, но отключенных от сети FortiClient (60 - 600 сек, по умолчанию = 120). | ||
| forticlient-reg-key - | Ключ регистрации FortiClient. | ||
| forticlient-reg-key-enforce - |
| Включение/выключение требования или принудительного использования ключей регистрации FortiClient. | |
| forticlient-reg-timeout - | Таймаут лицензии регистрации FortiClient (дни, min = 1, max = 180, 0 означает неограниченно). | ||
| forticlient-sys-update-interval - | Интервал между двумя сообщениями о системном обновлении от FortiClient (30 - 1440 мин, по умолчанию = 720). | ||
| forticlient-user-avatar - |
| Включение/выключение загрузки пользовательских аватаров FortiClient. | |
| forticlient-warning-interval - | Период времени между предупреждениями портала FortiClient (0 - 24 часа, по умолчанию = 1). | ||
| host - / обязательно | IP-адрес FortiOS или FortiGate. | ||
| https boolean |
| Указывает, должны ли запросы к FortiGate использовать протокол HTTPS | |
| password - | Значение по умолчанию: "" | Пароль FortiOS или FortiGate. | |
| username - / обязательно | Имя пользователя FortiOS или FortiGate. | ||
| vdom - | Значение по умолчанию: "root" | Виртуальная область, определённая ранее. vdom — виртуальная инстанция FortiGate, которая может быть настроена и использована как отдельный узел. | |
Примечания
Примечание
- Требуется библиотека fortiosapi, разработанная Fortinet
- Выполняется как local_action в вашем playbook
Примеры
- hosts: localhost
vars:
host: "192.168.122.40"
username: "admin"
password: ""
vdom: "root"
tasks:
- name: Configure endpoint control settings.
fortios_endpoint_control_settings:
host: "{{ host }}"
username: "{{ username }}"
password: "{{ password }}"
vdom: "{{ vdom }}"
endpoint_control_settings:
download-custom-link: "<your_own_value>"
download-location: "fortiguard"
forticlient-avdb-update-interval: "5"
forticlient-dereg-unsupported-client: "enable"
forticlient-ems-rest-api-call-timeout: "7"
forticlient-keepalive-interval: "8"
forticlient-offline-grace: "enable"
forticlient-offline-grace-interval: "10"
forticlient-reg-key: "<your_own_value>"
forticlient-reg-key-enforce: "enable"
forticlient-reg-timeout: "13"
forticlient-sys-update-interval: "14"
forticlient-user-avatar: "enable"
forticlient-warning-interval: "16"
Возвращаемые значения
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| 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 строка | всегда | Указание результата операции Пример: success |
| vdom строка | всегда | Используемый виртуальный домен Пример: root |
| version строка | всегда | Версия FortiGate Пример: v5.6.3 |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/fortios_endpoint_control_settings_module.html
