Skip to content

Commit d17e647

Browse files
chkp-dorbechkp-dorbe
authored
new collection release 6.9.0 (#196)
* new collection release 6.9.0
1 parent 21fd0d2 commit d17e647

10 files changed

Lines changed: 746 additions & 2 deletions

‎CHANGELOG.rst‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,29 @@ Check_Point.Mgmt Release Notes
44

55
.. contents:: Topics
66

7+
v6.9.0
8+
======
9+
10+
Release Summary
11+
---------------
12+
13+
This is release 6.9.0 of ``check_point.mgmt``, released on 2026-03-16.
14+
15+
Minor Changes
16+
-------------
17+
18+
- added new parameter 'enable_https_inspection' to 'cp_mgmt_simple_cluster' and 'cp_mgmt_simple_gateway' modules.
19+
- added new parameters 'advanced_dns_settings', 'scan_malicious_links', 'threat_extraction' and 'zero_phishing' to 'cp_mgmt_threat_profile' module.
20+
21+
New Modules
22+
-----------
23+
24+
- check_point.mgmt.cp_mgmt_add_data_center_query - Adds data-center-query object on Checkpoint over Web Services API
25+
- check_point.mgmt.cp_mgmt_set_data_center_query - Edits data-center-query object on Checkpoint over Web Services API
26+
- check_point.mgmt.cp_mgmt_delete_data_center_query - Deletes data-center-query object on Checkpoint over Web Services API
27+
- check_point.mgmt.cp_mgmt_data_center_query_facts - Get data-center-query objects facts on Checkpoint over Web Services API
28+
- check_point.mgmt.cp_mgmt_export_access_rulebase - Export access rulebase on Checkpoint over Web Services API
29+
730
v6.8.0
831
======
932

‎galaxy.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ namespace: check_point
99
name: mgmt
1010

1111
# The version of the collection. Must be compatible with semantic versioning
12-
version: 6.8.0
12+
version: 6.9.0
1313

1414
# The path to the Markdown (.md) readme file. This path is relative to the root of the collection
1515
readme: README.md

‎plugins/modules/cp_mgmt_add_data_center_query.py‎

Lines changed: 199 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,199 @@
1+
#!/usr/bin/python
2+
# -*- coding: utf-8 -*-
3+
#
4+
# Ansible module to manage CheckPoint Firewall (c) 2019
5+
#
6+
# Ansible is free software: you can redistribute it and/or modify
7+
# it under the terms of the GNU General Public License as published by
8+
# the Free Software Foundation, either version 3 of the License, or
9+
# (at your option) any later version.
10+
#
11+
# Ansible is distributed in the hope that it will be useful,
12+
# but WITHOUT ANY WARRANTY; without even the implied warranty of
13+
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14+
# GNU General Public License for more details.
15+
#
16+
# You should have received a copy of the GNU General Public License
17+
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
18+
#
19+
20+
from __future__ import absolute_import, division, print_function
21+
22+
__metaclass__ = type
23+
24+
ANSIBLE_METADATA = {
25+
"metadata_version": "1.1",
26+
"status": ["preview"],
27+
"supported_by": "community",
28+
}
29+
30+
DOCUMENTATION = """
31+
---
32+
module: cp_mgmt_add_data_center_query
33+
short_description: Adds data-center-query objects on Checkpoint over Web Services API
34+
description:
35+
- Adds data-center-query objects on Checkpoint devices.
36+
- All operations are performed over Web Services API.
37+
- Available from R81 management version.
38+
version_added: "6.9.0"
39+
author: "Dor Berenstein (@chkp-dorbe)"
40+
options:
41+
name:
42+
description:
43+
- Object name.
44+
type: str
45+
required: True
46+
query_rules:
47+
description:
48+
- Data Center Query Rules.<br>There is an 'AND' operation between multiple Query Rules.
49+
type: list
50+
elements: dict
51+
suboptions:
52+
key_type:
53+
description:
54+
- The type of the "key" parameter.<br>Use "predefined" for these keys, type-in-data-center, name-in-data-center, and ip-address.<br>Use
55+
"tag" to query the Data Center tag's property.
56+
type: str
57+
choices: ['predefined', 'tag']
58+
key:
59+
description:
60+
- Defines in which Data Center property to query.<br>For key-type "predefined", use these keys, type-in-data-center,
61+
name-in-data-center, and ip-address.<br>For key-type "tag", use the Data Center tag key to query.<br>Keys are case-insensitive.
62+
type: str
63+
values:
64+
description:
65+
- The value(s) of the Data Center property to match the Query Rule.<br>Values are case-insensitive.<br>There is an 'OR' operation
66+
between multiple values.<br>For key-type "predefined" and key 'ip-address', the values must be an IPv4 or IPv6 address.<br>For key-type "tag", the
67+
values must be the Data Center tag values.
68+
type: list
69+
elements: str
70+
data_centers:
71+
description:
72+
- Collection of Data Center servers identified by the name or UID. use "All" to select all data centers.
73+
type: list
74+
elements: str
75+
color:
76+
description:
77+
- Color of the object. Should be one of existing colors.
78+
type: str
79+
choices: ['aquamarine', 'black', 'blue', 'crete blue', 'burlywood', 'cyan', 'dark green', 'khaki', 'orchid', 'dark orange', 'dark sea green',
80+
'pink', 'turquoise', 'dark blue', 'firebrick', 'brown', 'forest green', 'gold', 'dark gold', 'gray', 'dark gray', 'light green', 'lemon chiffon',
81+
'coral', 'sea green', 'sky blue', 'magenta', 'purple', 'slate blue', 'violet red', 'navy blue', 'olive', 'orange', 'red', 'sienna', 'yellow']
82+
comments:
83+
description:
84+
- Comments string.
85+
type: str
86+
details_level:
87+
description:
88+
- The level of detail for some of the fields in the response can vary from showing only the UID value of the object to a fully detailed
89+
representation of the object.
90+
type: str
91+
choices: ['uid', 'standard', 'full']
92+
tags:
93+
description:
94+
- Collection of tag identifiers.
95+
type: list
96+
elements: str
97+
ignore_warnings:
98+
description:
99+
- Apply changes ignoring warnings.
100+
type: bool
101+
ignore_errors:
102+
description:
103+
- Apply changes ignoring errors. You won't be able to publish such a changes. If ignore-warnings flag was omitted - warnings will also be ignored.
104+
type: bool
105+
extends_documentation_fragment: check_point.mgmt.checkpoint_commands
106+
"""
107+
108+
EXAMPLES = """
109+
- name: add-data-center-query
110+
cp_mgmt_add_data_center_query:
111+
name: data-center-query1
112+
"""
113+
114+
RETURN = """
115+
cp_mgmt_add_data_center_query:
116+
description: The checkpoint add-data-center-query output.
117+
returned: always.
118+
type: dict
119+
"""
120+
121+
from ansible.module_utils.basic import AnsibleModule
122+
from ansible_collections.check_point.mgmt.plugins.module_utils.checkpoint import (
123+
checkpoint_argument_spec_for_commands,
124+
api_command,
125+
)
126+
127+
128+
def main():
129+
argument_spec = dict(
130+
name=dict(type="str", required=True),
131+
query_rules=dict(
132+
type="list",
133+
elements="dict",
134+
options=dict(
135+
key_type=dict(type="str", choices=["predefined", "tag"]),
136+
key=dict(type="str", no_log=False),
137+
values=dict(type="list", elements="str"),
138+
),
139+
),
140+
data_centers=dict(type="list", elements="str"),
141+
color=dict(
142+
type="str",
143+
choices=[
144+
"aquamarine",
145+
"black",
146+
"blue",
147+
"crete blue",
148+
"burlywood",
149+
"cyan",
150+
"dark green",
151+
"khaki",
152+
"orchid",
153+
"dark orange",
154+
"dark sea green",
155+
"pink",
156+
"turquoise",
157+
"dark blue",
158+
"firebrick",
159+
"brown",
160+
"forest green",
161+
"gold",
162+
"dark gold",
163+
"gray",
164+
"dark gray",
165+
"light green",
166+
"lemon chiffon",
167+
"coral",
168+
"sea green",
169+
"sky blue",
170+
"magenta",
171+
"purple",
172+
"slate blue",
173+
"violet red",
174+
"navy blue",
175+
"olive",
176+
"orange",
177+
"red",
178+
"sienna",
179+
"yellow",
180+
],
181+
),
182+
comments=dict(type="str"),
183+
details_level=dict(type="str", choices=["uid", "standard", "full"]),
184+
tags=dict(type="list", elements="str"),
185+
ignore_warnings=dict(type="bool"),
186+
ignore_errors=dict(type="bool"),
187+
)
188+
argument_spec.update(checkpoint_argument_spec_for_commands)
189+
190+
module = AnsibleModule(argument_spec=argument_spec)
191+
192+
command = "add-data-center-query"
193+
194+
result = api_command(module, command)
195+
module.exit_json(**result)
196+
197+
198+
if __name__ == "__main__":
199+
main()

‎plugins/modules/cp_mgmt_data_center_query_facts.py‎

Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
#!/usr/bin/python
2+
# -*- coding: utf-8 -*-
3+
#
4+
# Ansible module to manage CheckPoint Firewall (c) 2019
5+
#
6+
# Ansible is free software: you can redistribute it and/or modify
7+
# it under the terms of the GNU General Public License as published by
8+
# the Free Software Foundation, either version 3 of the License, or
9+
# (at your option) any later version.
10+
#
11+
# Ansible is distributed in the hope that it will be useful,
12+
# but WITHOUT ANY WARRANTY; without even the implied warranty of
13+
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14+
# GNU General Public License for more details.
15+
#
16+
# You should have received a copy of the GNU General Public License
17+
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
18+
#
19+
20+
from __future__ import (absolute_import, division, print_function)
21+
22+
__metaclass__ = type
23+
24+
ANSIBLE_METADATA = {'metadata_version': '1.1',
25+
'status': ['preview'],
26+
'supported_by': 'community'}
27+
28+
DOCUMENTATION = """
29+
---
30+
module: cp_mgmt_data_center_query_facts
31+
short_description: Get data-center-query objects facts on Checkpoint over Web Services API
32+
description:
33+
- Get data-center-query objects facts on Checkpoint devices.
34+
- All operations are performed over Web Services API.
35+
- This module handles both operations, get a specific object and get several objects,
36+
For getting a specific object use the parameter 'name'.
37+
- Available from R81 management version.
38+
version_added: "6.9.0"
39+
author: "Dor Berenstein (@chkp-dorbe)"
40+
options:
41+
name:
42+
description:
43+
- Object name.
44+
This parameter is relevant only for getting a specific object.
45+
type: str
46+
details_level:
47+
description:
48+
- The level of detail for some of the fields in the response can vary from showing only the UID value of the object to a fully detailed
49+
representation of the object.
50+
type: str
51+
choices: ['uid', 'standard', 'full']
52+
filter:
53+
description:
54+
- Search expression to filter objects by. The provided text should be exactly the same as it would be given in SmartConsole Object Explorer. The
55+
logical operators in the expression ('AND', 'OR') should be provided in capital letters. The search involves both a IP search and a textual search in
56+
name, comment, tags etc.
57+
type: str
58+
limit:
59+
description:
60+
- The maximal number of returned results.
61+
This parameter is relevant only for getting few objects.
62+
type: int
63+
offset:
64+
description:
65+
- Number of the results to initially skip.
66+
This parameter is relevant only for getting few objects.
67+
type: int
68+
order:
69+
description:
70+
- Sorts the results by search criteria. Automatically sorts the results by Name, in the ascending order.
71+
This parameter is relevant only for getting few objects.
72+
type: list
73+
elements: dict
74+
suboptions:
75+
ASC:
76+
description:
77+
- Sorts results by the given field in ascending order.
78+
type: str
79+
choices: ['name']
80+
DESC:
81+
description:
82+
- Sorts results by the given field in descending order.
83+
type: str
84+
choices: ['name']
85+
show_membership:
86+
description:
87+
- Indicates whether to calculate and show "groups" field for every object in reply.
88+
type: bool
89+
domains_to_process:
90+
description:
91+
- Indicates which domains to process the commands on. It cannot be used with the details-level full, must be run from the System Domain only and
92+
with ignore-warnings true. Valid values are, CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.
93+
type: list
94+
elements: str
95+
extends_documentation_fragment: check_point.mgmt.checkpoint_facts
96+
"""
97+
98+
EXAMPLES = """
99+
- name: show-data-center-query
100+
cp_mgmt_data_center_query_facts:
101+
name: data-center-query1
102+
103+
- name: show-data-center-queries
104+
cp_mgmt_data_center_query_facts:
105+
"""
106+
107+
RETURN = """
108+
ansible_facts:
109+
description: The checkpoint object facts.
110+
returned: always.
111+
type: dict
112+
"""
113+
114+
from ansible.module_utils.basic import AnsibleModule
115+
from ansible_collections.check_point.mgmt.plugins.module_utils.checkpoint import checkpoint_argument_spec_for_facts, api_call_facts
116+
117+
118+
def main():
119+
argument_spec = dict(
120+
name=dict(type='str'),
121+
details_level=dict(type='str', choices=['uid', 'standard', 'full']),
122+
filter=dict(type='str'),
123+
limit=dict(type='int'),
124+
offset=dict(type='int'),
125+
order=dict(type='list', elements="dict", options=dict(
126+
ASC=dict(type='str', choices=['name']),
127+
DESC=dict(type='str', choices=['name'])
128+
)),
129+
show_membership=dict(type='bool'),
130+
domains_to_process=dict(type='list', elements="str")
131+
)
132+
argument_spec.update(checkpoint_argument_spec_for_facts)
133+
134+
module = AnsibleModule(argument_spec=argument_spec, supports_check_mode=True)
135+
136+
api_call_object = "data-center-query"
137+
api_call_object_plural_version = "data-center-queries"
138+
139+
result = api_call_facts(module, api_call_object, api_call_object_plural_version)
140+
module.exit_json(ansible_facts=result)
141+
142+
143+
if __name__ == '__main__':
144+
main()

0 commit comments

Comments
 (0)