fortinet.fortios.fortios_endpoint_control_fctems 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置 FortiClient 企业管理服务器 (EMS) 条目。
注意
此模块是 fortinet.fortios 集合（版本 2.3.8）的一部分。
如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install fortinet.fortios。您需要更多要求才能使用此模块，有关详细信息，请参阅要求。
要在 playbook 中使用它，请指定：fortinet.fortios.fortios_endpoint_control_fctems。
fortinet.fortios 2.0.0 中的新增功能
概要
此模块能够通过允许用户设置和修改 endpoint_control 功能和 fctems 类别来配置 FortiGate 或 FortiOS (FOS) 设备。示例包括所有参数，并且需要在使用前将值调整为数据源。已使用 FOS v6.0.0 测试。
要求
执行此模块的主机需要满足以下要求。
ansible>=2.15
参数
参数 |
注释 |
|---|---|
基于令牌的身份验证。从 FortiGate 的 GUI 生成。 |
|
启用/禁用任务的日志记录。 选择
|
|
配置 FortiClient 企业管理服务器 (EMS) 条目。 |
|
FortiClient EMS 管理员密码。 |
|
FortiClient EMS 管理员用户名。 |
|
FortiClient EMS 调用超时（秒）（1 - 180 秒）。 |
|
EMS 功能列表。 选择
|
|
FortiClient EMS 证书。源 certificate.remote.name。 |
|
FortiClient EMS 云多租户访问密钥 |
|
云服务器类型。 选择
|
|
FortiClient EMS 的脏原因。 选择
|
|
EMS ID（顺序为 1 - 7）。请参阅 <a href=’#notes’>备注</a>。 |
|
通过 FortiCloud 帐户启用/禁用 FortiClient EMS 云的身份验证。 选择
|
|
FortiClient EMS HTTPS 访问端口号。(1 - 65535)。 |
|
指定用于到达服务器的传出接口。源 system.interface.name。 |
|
指定如何选择用于到达服务器的传出接口。 选择
|
|
FortiClient 企业管理服务器 (EMS) 名称。 |
|
过时资源阈值（秒）（10 - 3600）。 |
|
启用/禁用 EMS SSL 会话连接的保留。警告，大多数用户不应触碰此设置。 选择
|
|
启用/禁用从 EMS 拉取头像。 选择
|
|
启用/禁用从 EMS 拉取 FortiClient 恶意软件哈希。 选择
|
|
启用/禁用从 EMS 拉取 SysInfo。 选择
|
|
启用/禁用从 EMS 拉取 FortiClient 用户标签。 选择
|
|
启用/禁用从 EMS 拉取漏洞。 选择
|
|
放宽对标签的限制，将所有 EMS 标签发送到所有 VDOM 选择
|
|
EMS 序列号。 |
|
FortiClient EMS FQDN 或 IPv4 地址。 |
|
REST API 调用源 IP。 |
|
启用或禁用此 EMS 配置。 选择
|
|
FortiClient EMS 调用超时（秒）（1 - 120 秒）。 |
|
EMS 租户 ID。 |
|
启用/禁用对 EMS 证书颁发者 (CA) 和公共名称 (CN) 的信任，以便进行证书自动续订。 选择
|
|
FortiGate 上已验证的 EMS 证书链中的最低 CA 证书。源 certificate.ca.name vpn.certificate.ca.name。 |
|
启用/禁用覆盖此 FortiGate 单元如何使用 WebSocket 连接到 EMS 的行为。 选择
|
|
要操作的成员属性路径。 如果存在多个属性，则用斜杠字符分隔。 用 member_path 标记的参数对于执行成员操作是合法的。 |
|
在指定的属性路径下添加或删除成员。 当指定 member_state 时，将忽略 state 选项。 选择
|
|
指示是创建还是删除对象。 选择
|
|
虚拟域，在之前定义的域中。vdom 是 FortiGate 的虚拟实例，可以配置并用作不同的单元。 默认值： |
备注
注意
我们强烈建议使用您自己的值作为 ems_id，而不是 0，而“0”是一个特殊的占位符，允许后端为对象分配最新的可用编号，但它确实存在限制。请在问答中查找更多详细信息。
旧版 fortiosapi 已弃用，httpapi 是运行 playbook 的首选方式
该模块支持 check_mode。
示例
- name: Configure FortiClient Enterprise Management Server (EMS) entries.
fortinet.fortios.fortios_endpoint_control_fctems:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
endpoint_control_fctems:
admin_password: "<your_own_value>"
admin_username: "<your_own_value>"
call_timeout: "30"
capabilities: "fabric-auth"
certificate: "<your_own_value> (source certificate.remote.name)"
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_16"
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"
status_check_interval: "90"
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"
返回值
常见的返回值记录在此处，以下是此模块独有的字段
键 |
描述 |
|---|---|
FortiGate 映像的内部版本号 返回：总是 示例： |
|
上次用于将内容配置到 FortiGate 的方法 返回：总是 示例: |
|
FortiGate 在上次操作后给出的最后结果 返回：总是 示例: |
|
上次调用 FortiGate 时使用的主键 (id) 返回: success 示例: |
|
用于满足请求的表名 返回：总是 示例: |
|
用于满足请求的表的路径 返回：总是 示例: |
|
内部修订号 返回：总是 示例: |
|
设备的序列号 返回：总是 示例: |
|
操作结果的指示 返回：总是 示例: |
|
使用的虚拟域 返回：总是 示例: |
|
FortiGate 的版本 返回：总是 示例: |