check_point.mgmt.cp_mgmt_access_rules 模块 – 通过 Web 服务 API 管理 Check Point 上的访问规则对象

注意

此模块是 check_point.mgmt 集合 (版本 6.2.1) 的一部分。

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

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

要在剧本中使用它，请指定： check_point.mgmt.cp_mgmt_access_rules。

check_point.mgmt 2.2.0 中的新增功能

概要

• 管理 Check Point 设备上的访问规则对象，包括创建、更新和删除对象。

• 所有操作均通过 Web 服务 API 执行。

注意

此模块具有相应的 action 插件。

参数

参数	注释
auto_publish_session 布尔值	如果任务完成后已执行更改，则发布当前会话。 选项 false ← (默认) true
details_level 字符串	响应中某些字段的详细程度可以变化，从仅显示对象的 UID 值到对象的完整详细表示。 选项 "uid" "standard" "full"
layer 字符串 / 必填	规则所属的层，由名称或 UID 标识。
rules 列表 / 元素=字典 / 必填	规则列表。
action 字符串	“接受”、“丢弃”、“询问”、“通知”、“拒绝”、“用户身份验证”、“客户端身份验证”、“应用层”。
action_settings 字典	操作设置。
enable_identity_captive_portal 布尔值	N/A 选项 false true
limit 字符串	N/A
comments 字符串	注释字符串。
content 列表 / 元素=字典	此规则适用的已处理文件类型列表。
content_direction 字符串	应用文件类型处理的方向。 选项 "any" "up" "down"
content_negate 布尔值	如果为数据设置了否定，则为 True。 选项 false true
custom_fields 字典	自定义字段。
field_1 字符串	第一个自定义字段。
field_2 字符串	第二个自定义字段。
field_3 字符串	第三个自定义字段。
destination 列表 / 元素=字符串	由名称或 UID 标识的网络对象集合。
destination_negate 布尔值	如果为目标设置了否定，则为 True。 选项 false true
details_level 字符串	响应中某些字段的详细程度可以变化，从仅显示对象的 UID 值到对象的完整详细表示。 选项 "uid" "standard" "full"
enabled 布尔值	启用/禁用规则。 选项 false true
ignore_errors 布尔值	忽略错误应用更改。您将无法发布此类更改。如果忽略警告标志被忽略，则警告也将被忽略。 选项 false true
ignore_warnings 布尔值	忽略警告应用更改。 选项 false true
inline_layer 字符串	由名称或 UID 标识的内联层。仅当“操作”设置为“应用层”时才相关。
install_on 列表 / 元素=字符串	要在此处安装策略的网关（由名称或 UID 标识）。
name 字符串 / 必填	对象名称。
service 列表 / 元素=字符串	由名称或 UID 标识的网络对象集合。
service_negate 布尔值	如果为服务设置了否定，则为 True。 选项 false true
source 列表 / 元素=字符串	由名称或 UID 标识的网络对象集合。
source_negate 布尔值	如果为源设置了否定，则为 True。 选项 false true
state 字符串	访问规则的状态（存在或不存在）。默认为存在。 选项 "present" ← (默认) "absent"
time 列表 / 元素=字符串	时间对象列表。例如，“周末”、“非工作时间”、“每天”。
track 字典	跟踪设置。
accounting 布尔值	打开和关闭跟踪的会计功能。 选项 false true
alert 字符串	跟踪的警报类型。 选项 "none" "alert" "snmp" "mail" "user alert 1" "user alert 2" "user alert 3"
enable_firewall_session 布尔值	确定是否仅为防火墙连接生成会话日志。 选项 false true
per_connection 布尔值	确定是否对每个连接执行日志记录。 选项 false true
per_session 布尔值	确定是否对每个会话执行日志记录。 选项 false true
type 字符串	“日志”、“扩展日志”、“详细日志”、“无”。
user_check 字典	用户检查设置。
confirm 字符串	N/A 选项 "per rule" "per category" "per application/site" "per data type"
custom_frequency 字典	N/A
every 整数	N/A
unit 字符串	N/A 选项 "hours" "days" "weeks" "months"
frequency 字符串	N/A 选项 "once a day" "once a week" "once a month" "custom frequency..."
interaction 字符串	N/A
vpn 字符串	任意或 All_GwToGw。 选项 "Any" "All_GwToGw"
vpn_list 列表 / 元素=字典	社区或定向。
community 列表 / 元素=字符串	社区名称或 UID 列表。
directional 列表 / 元素=字典	社区定向匹配条件。
from 字符串	来自社区名称或 UID。
to 字符串	到社区名称或 UID。
version 字符串	检查点版本。如果没有给出，则采用最新版本。
wait_for_task_timeout 整数	等待超时错误之前需要等待多少分钟。 默认值： 30

示例

- name: add-access-rules
  cp_mgmt_access_rules:
    rules:
      - name: Rule 1
        service:
        - SMTP
        - AOL
        state: present
      - name: Rule 2
        service:
        - SMTP
        state: present
    layer: Network
    auto_publish_session: true

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段：

键	描述
cp_mgmt_access_rules 字典	已创建或更新的检查点对象。 返回值： 始终返回，除非删除对象。

作者

• Shiran Golzar (@chkp-shirango)

资源链接

• 问题追踪器
• 代码库（源代码）