Модуль fortinet.fortios.fortios_endpoint_control_fctems_override — настройка записей FortiClient Enterprise Management Server (EMS) в FortiOS и FortiGate от Fortinet.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_endpoint_control_fctems_override.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функции endpoint_control и категории fctems_override. Примеры содержат все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Тестирование выполнено с FOS v6.0.0.
Требования
На узле, выполняющем этот модуль, необходимы следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Токен создается в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
endpoint_control_fctems_override dictionary | Настройка записей FortiClient Enterprise Management Server (EMS). |
|
call_timeout integer |
Время ожидания вызова FortiClient EMS в секундах (от 1 до 180 секунд). |
|
capabilities list / elements=string |
Список возможностей EMS. Варианты:
|
|
cloud_authentication_access_key string |
Ключ доступа для многопользовательского режима облачного FortiClient EMS |
|
cloud_server_type string |
Тип облачного сервера. Варианты:
|
|
dirty_reason string |
Причина состояния Dirty для FortiClient EMS. Варианты:
|
|
ems_id integer / обязательный |
Порядковый номер EMS (от 1 до 7). См. <a href=’#notes’>Примечания</a>. |
|
fortinetone_cloud_authentication string |
Включить или отключить аутентификацию облачного FortiClient EMS через учетную запись FortiCloud. Варианты:
|
|
https_port integer |
Номер порта HTTPS для доступа к FortiClient EMS (от 1 до 65535). |
|
interface string |
Укажите исходящий интерфейс для связи с сервером. Источник: system.interface.name. |
|
interface_select_method string |
Укажите способ выбора исходящего интерфейса для связи с сервером. Варианты:
|
|
name string |
Имя FortiClient Enterprise Management Server (EMS). |
|
out_of_sync_threshold integer |
Порог устаревания ресурса в секундах (от 10 до 3600). |
|
preserve_ssl_session string |
Включить или отключить сохранение SSL-сеанса EMS. Предупреждение: большинству пользователей не следует изменять этот параметр. Варианты:
|
|
pull_avatars string |
Включить или отключить получение аватаров из EMS. Варианты:
|
|
pull_malware_hash string |
Включить или отключить получение хешей вредоносных программ FortiClient из EMS. Варианты:
|
|
pull_sysinfo string |
Включить или отключить получение системной информации (SysInfo) из EMS. Варианты:
|
|
pull_tags string |
Включить или отключить получение пользовательских тегов FortiClient из EMS. Варианты:
|
|
pull_vulnerabilities string |
Включить или отключить получение сведений об уязвимостях из EMS. Варианты:
|
|
send_tags_to_all_vdoms string |
Снять ограничения на теги, чтобы отправлять все теги EMS во все VDOM Варианты:
|
|
serial_number string |
Серийный номер EMS. |
|
server string |
Полное доменное имя (FQDN) или IPv4-адрес FortiClient EMS. |
|
source_ip string |
Исходный IP-адрес вызова REST API. |
|
status string |
Включить или отключить эту конфигурацию EMS. Варианты:
|
|
tenant_id string |
Идентификатор клиента EMS. |
|
trust_ca_cn string |
Включить или отключить доверие к издателю сертификата EMS (CA) и общему имени (CN) для автоматического продления сертификата. Варианты:
|
|
verifying_ca string |
Сертификат CA нижнего уровня на FortiGate в проверенной цепочке сертификатов EMS. Источник: certificate.ca.name vpn.certificate.ca.name. |
|
websocket_override string |
Включить или отключить переопределение способа подключения этого устройства FortiGate к EMS через WebSocket-соединение. Варианты:
|
member_path string | Путь к атрибуту элемента, с которым нужно выполнить операцию. Если атрибутов несколько, они разделяются символом косой черты. Параметр с указанием member_path используется для выполнения операций с элементами. |
member_state string | Добавить или удалить элемент по указанному пути к атрибуту. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
vdom string | Виртуальный домен из числа ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Мы настоятельно рекомендуем указывать собственное значение ems_id вместо 0. Значение «0» — специальный заполнитель, позволяющий серверной части назначить объекту последний доступный номер, но у него есть ограничения. Дополнительные сведения см. в разделе «Вопросы и ответы».
- Устаревшая fortiosapi объявлена устаревшей; для запуска плейбуков рекомендуется использовать httpapi
- Модуль поддерживает check_mode.
Примеры
- name: Configure FortiClient Enterprise Management Server (EMS) entries.
fortinet.fortios.fortios_endpoint_control_fctems_override:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
endpoint_control_fctems_override:
call_timeout: "30"
capabilities: "fabric-auth"
cloud_authentication_access_key: "<your_own_value>"
cloud_server_type: "production"
dirty_reason: "none"
ems_id: "<you_own_value>"
fortinetone_cloud_authentication: "enable"
https_port: "443"
interface: "<your_own_value> (source system.interface.name)"
interface_select_method: "auto"
name: "default_name_13"
out_of_sync_threshold: "180"
preserve_ssl_session: "enable"
pull_avatars: "enable"
pull_malware_hash: "enable"
pull_sysinfo: "enable"
pull_tags: "enable"
pull_vulnerabilities: "enable"
send_tags_to_all_vdoms: "enable"
serial_number: "<your_own_value>"
server: "192.168.100.40"
source_ip: "84.230.14.43"
status: "enable"
tenant_id: "<your_own_value>"
trust_ca_cn: "enable"
verifying_ca: "<your_own_value> (source certificate.ca.name vpn.certificate.ca.name)"
websocket_override: "enable"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
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_endpoint_control_fctems_override_module.html