cisco.meraki.meraki_mr_l3_firewall 模块 – 在 Meraki 云中管理 MR 接入点第 3 层防火墙

注意

此模块是 cisco.meraki 集合（版本 2.18.3）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.meraki。

要在 playbook 中使用它，请指定：cisco.meraki.meraki_mr_l3_firewall。

已弃用

在以下版本中删除:

版本 3.0.0

原因:

更新的模块发布，具有增强的功能

替代方案:

cisco.meraki.networks_appliance_firewall_l3_firewall_rules

概要

  • 允许创建、管理和查看在 Meraki MR 接入点上实施的第 3 层防火墙。

  • 截至当前版本，模块不是幂等的。

参数

参数

注释

allow_lan_access

布尔值

设置设备是否可以与同一 LAN 上的其他设备通信。

选择

  • false

  • true ← (默认)

auth_key

字符串 / 必需

仪表板提供的身份验证密钥。如果未设置环境变量 MERAKI_KEY，则为必需。

host

字符串

Meraki 仪表板的主机名。

可用于访问区域性 Meraki 环境，例如中国。

默认值: "api.meraki.com"

internal_error_retry_time

整数

如果服务器返回内部服务器错误，则重试的秒数。

默认值: 60

net_id

字符串

包含接入点的网络的 ID。

net_name

字符串

包含接入点的网络的名称。

number

别名: ssid_number

字符串

应用防火墙规则的 SSID 编号。

org_id

字符串

组织的 ID。

org_name

别名: organization

字符串

组织的名称。

output_format

字符串

指示模块响应键应采用蛇形命名法（例如，net_id）还是驼峰命名法（例如，netId）。

选择

  • "snakecase" ← (默认)

  • "camelcase"

output_level

字符串

设置模块执行期间的调试输出量。

选择

  • "debug"

  • "normal" ← (默认)

rate_limit_retry_time

整数

如果触发速率限制器，则重试的秒数。

默认值: 165

rules

列表 / 元素=字典

防火墙规则列表。

comment

字符串

描述防火墙规则的可选注释。

dest_cidr

字符串

要匹配的 CIDR 表示法网络的逗号分隔列表。

dest_port

字符串

要匹配的目标端口的逗号分隔列表。

policy

字符串

指定在命中规则时应采取的操作。

选择

  • "allow"

  • "deny"

protocol

字符串

指定要匹配的协议。

选择

  • "any"

  • "icmp"

  • "tcp"

  • "udp"

ssid_name

别名: ssid

字符串

应用防火墙规则的 SSID 名称。

state

字符串

创建或修改组织。

选择

  • "present" ← (默认)

  • "query"

timeout

整数

HTTP 请求的超时时间。

默认值: 30

use_https

布尔值

如果为 no，则将使用 HTTP。否则将使用 HTTPS。

仅对 Meraki 内部开发人员有用。

选择

  • false

  • true ← (默认)

use_proxy

布尔值

如果为 no，即使目标主机上的环境变量中定义了代理，也不会使用代理。

选择

  • false ←（默认）

  • true

validate_certs

布尔值

是否验证 HTTP 证书。

选择

  • false

  • true ← (默认)

注释

注意

  • 有关 Meraki API 的更多信息，请访问 https://dashboard.meraki.com/api_docs。

  • 某些选项可能仅供 Meraki 内部的开发人员使用。

  • 从 Ansible 2.9 开始，Meraki 模块输出的键使用蛇形命名法。要使用驼峰命名法，请将 ANSIBLE_MERAKI_FORMAT 环境变量设置为 camelcase。

  • Ansible 的 Meraki 模块将在 Ansible 2.13 中停止支持驼峰式输出。请更新您的 playbook。

  • 检查模式从仪表板下载当前配置，然后将更改与此下载进行比较。如果配置存在差异，检查模式将报告已更改，但不会将更改提交到 API 进行更改验证。

示例

- name: Create single firewall rule
  meraki_mr_l3_firewall:
    auth_key: abc123
    state: present
    org_name: YourOrg
    net_id: 12345
    number: 1
    rules:
      - comment: Integration test rule
        policy: allow
        protocol: tcp
        dest_port: 80
        dest_cidr: 192.0.2.0/24
    allow_lan_access: no
  delegate_to: localhost

- name: Enable local LAN access
  meraki_mr_l3_firewall:
    auth_key: abc123
    state: present
    org_name: YourOrg
    net_id: 123
    number: 1
    rules:
    allow_lan_access: yes
  delegate_to: localhost

- name: Query firewall rules
  meraki_mr_l3_firewall:
    auth_key: abc123
    state: query
    org_name: YourOrg
    net_name: YourNet
    number: 1
  delegate_to: localhost

状态

  • 此模块将在 3.0.0 版本中移除。[已弃用]

  • 有关更多信息，请参阅已弃用。

作者

  • Kevin Breit (@kbreit)