Merge pull request #168 from chkp-dorbe/master

minor version release 6.4.0

CHANGELOG.rst

@@ -4,6 +4,25 @@ Check_Point.Mgmt Release Notes
 
 .. contents:: Topics
 
+v6.4.0
+======
+
+Release Summary
+---------------
+
+This is release 6.4.0 of "check_point.mgmt", released on 2025-02-20.
+
+Minor Changes
+-------------
+
+- added missing parameters such as 'filter', 'domains_to_process' and 'async_response' to the relevant resources modules.
+
+New Modules
+-----------
+
+- check_point.mgmt.cp_mgmt_user_template - Manages user-template objects on Checkpoint over Web Services API
+- check_point.mgmt.cp_mgmt_user_template_facts - Get user-template objects facts on Checkpoint over Web Services API
+
 v6.3.0
 ======
 

changelogs/changelog.yaml

@@ -1283,3 +1283,19 @@ releases:
         name: cp_mgmt_user_facts
         namespace: ''
     release_date: '2025-01-03'
+  6.4.0:
+    changes:
+      minor_changes:
+        - added missing parameters such as 'filter', 'domains_to_process' and 'async_response'
+          to the relevant resources modules.
+      release_summary: This is release 6.4.0 of "check_point.mgmt", released on 2025-02-20.
+    fragments:
+      - 6.4.0.yml
+    modules:
+      - description: Manages user-template objects on Checkpoint over Web Services API
+        name: cp_mgmt_user_template
+        namespace: ''
+      - description: Get user-template objects facts on Checkpoint over Web Services API
+        name: cp_mgmt_user_template_facts
+        namespace: ''
+    release_date: '2025-02-20'

galaxy.yml

@@ -9,7 +9,7 @@ namespace: check_point
 name: mgmt
 
 # The version of the collection. Must be compatible with semantic versioning
-version: 6.3.0
+version: 6.4.0
 
 # The path to the Markdown (.md) readme file. This path is relative to the root of the collection
 readme: README.md

plugins/modules/cp_mgmt_access_layer_facts.py

@@ -50,6 +50,13 @@
         representation of the object.
     type: str
     choices: ['uid', 'standard', 'full']
+  filter:
+    description:
+      - Search expression to filter objects by. The provided text should be exactly the same as it would be given in SmartConsole Object Explorer. The
+        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
+        name, comment, tags etc.
+    type: str
+    version_added: "6.4.0"
   limit:
     description:
       - No more than that many results will be returned.
@@ -77,6 +84,13 @@
           - Sorts results by the given field in descending order.
         type: str
         choices: ['name']
+  domains_to_process:
+    description:
+      - 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
+        with ignore-warnings true. Valid values are, CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.
+    type: list
+    elements: str
+    version_added: "6.4.0"
 extends_documentation_fragment: check_point.mgmt.checkpoint_facts
 """
 
@@ -110,6 +124,7 @@ def main():
     argument_spec = dict(
         name=dict(type="str"),
         details_level=dict(type="str", choices=["uid", "standard", "full"]),
+        filter=dict(type='str'),
         limit=dict(type="int"),
         offset=dict(type="int"),
         order=dict(
@@ -120,6 +135,7 @@ def main():
                 DESC=dict(type="str", choices=["name"]),
             ),
         ),
+        domains_to_process=dict(type='list', elements="str")
     )
     argument_spec.update(checkpoint_argument_spec_for_facts)
 

plugins/modules/cp_mgmt_access_layers.py

@@ -199,7 +199,7 @@
       mobile_access: true
       shared: false
       tags:
-      - test_layer
+        - test_layer
       color: aquamarine
       comments: test description
       details_level: full
@@ -246,7 +246,7 @@
       mobile_access: true
       shared: true
       tags:
-      - test_layer_replaced
+        - test_layer_replaced
       color: cyan
       comments: test REPLACE description
       details_level: full

plugins/modules/cp_mgmt_access_role.py

@@ -144,8 +144,8 @@
 - name: set-access-role
   cp_mgmt_access_role:
     users_list:
-        - source: "Internal User Groups"
-          selection: usersGroup
+      - source: "Internal User Groups"
+        selection: usersGroup
     name: New Access Role 1
     state: present
 

plugins/modules/cp_mgmt_access_role_facts.py

@@ -50,6 +50,13 @@
         representation of the object.
     type: str
     choices: ['uid', 'standard', 'full']
+  filter:
+    description:
+      - Search expression to filter objects by. The provided text should be exactly the same as it would be given in SmartConsole Object Explorer. The
+        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
+        name, comment, tags etc.
+    type: str
+    version_added: "6.4.0"
   limit:
     description:
       - No more than that many results will be returned.
@@ -77,6 +84,13 @@
           - Sorts results by the given field in descending order.
         type: str
         choices: ['name']
+  domains_to_process:
+    description:
+      - 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
+        with ignore-warnings true. Valid values are, CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.
+    type: list
+    elements: str
+    version_added: "6.4.0"
 extends_documentation_fragment: check_point.mgmt.checkpoint_facts
 """
 
@@ -108,6 +122,7 @@ def main():
     argument_spec = dict(
         name=dict(type="str"),
         details_level=dict(type="str", choices=["uid", "standard", "full"]),
+        filter=dict(type='str'),
         limit=dict(type="int"),
         offset=dict(type="int"),
         order=dict(
@@ -118,6 +133,7 @@ def main():
                 DESC=dict(type="str", choices=["name"]),
             ),
         ),
+        domains_to_process=dict(type='list', elements="str")
     )
     argument_spec.update(checkpoint_argument_spec_for_facts)
 

plugins/modules/cp_mgmt_access_rule.py

@@ -296,8 +296,8 @@
     name: Rule 1
     position: 1
     service:
-    - SMTP
-    - AOL
+      - SMTP
+      - AOL
     vpn: All_GwToGw
     state: present
 

plugins/modules/cp_mgmt_access_rules.py

@@ -281,12 +281,12 @@
     rules:
       - name: Rule 1
         service:
-        - SMTP
-        - AOL
+          - SMTP
+          - AOL
         state: present
       - name: Rule 2
         service:
-        - SMTP
+          - SMTP
         state: present
     layer: Network
     auto_publish_session: true

plugins/modules/cp_mgmt_add_custom_trusted_ca_certificate.py

@@ -52,17 +52,17 @@
 - name: add-custom-trusted-ca-certificate
   cp_mgmt_add_custom_trusted_ca_certificate:
     base64_certificate:
-     "MIIEkzCCAnugAwIBAgIVAO5SRZQELwNNhWF+8st6ox9uXYgeMA0GCSqGSIb3DQEBCwUAMIGrMQswCQYDVQQGEwJJTDEPMA0GA1UECBMGSXNyYWVsMS4wLAYDVQQKEyVDaGVja1BvaW50IFNvZnR3YXJlIF
-    lY2hub2xvZ2llcyBMVEQuMQwwCgYDVQQLEwNNSVMxIjAgBgNVBAMTGUNoZWNrUG9pbnQtU1NMLUluc3BlY3Rpb24xKTAnBgkqhkiG9w0BCQEWGmlsX3NlY3VyaXR5QGNoZWNrcG9pbnQuY29tMB4XDTIzM
-    MxMzAwMDAwMFoXDTIzMDYxMTIzNTk1OVowbzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExEzARBgNVBAcTCk1lbmxvIFBhcmsxHTAbBgNVBAoTFE1ldGEgUGxhdGZvcm1zLCBJbmMuMRcw
-    QYDVQQDDA4qLndoYXRzYXBwLm5ldDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABPjo05vRHAJYYWx55SOu2b1ZIQPOOtJNipSBXf1BFBDQhrkp20YTA296MzKii2j3TgVi/1t44cW5mD1RWobfAQujgbM
-    gbAwHQYDVR0lBBYwFAYIKwYBBQUHAwEGCCsGAQUFBwMCMHQGA1UdEQRtMGuCDioud2hhdHNhcHAubmV0ghIqLmNkbi53aGF0c2FwcC5uZXSCEiouc25yLndoYXRzYXBwLm5ldIIOKi53aGF0c2FwcC5jb2
-    CBXdhLm1lggx3aGF0c2FwcC5jb22CDHdoYXRzYXBwLm5ldDAOBgNVHQ8BAf8EBAMCBaAwCQYDVR0TBAIwADANBgkqhkiG9w0BAQsFAAOCAgEAA/sIadLr9ahEVq8h9HuofHODUuzxVFulAZu8uSiyY4ACb
-    Hcvm36MYQCzYV56t4fe+I++ls8KAESZgdE0KoD5/6efzK05Ufok+y15QexAR5AxZlJqtoHIuc7iOolPbkLW77GKrbgfEgmwOCX9/86Pug4ZSrrBUPPt9i3accNkAP+SH9Lft1geS2E/q+xcRhbhDcYTYD5
-    X0MiEv0UaAzwS3adWAZbD7R42u+xNCpX8iUyiwp2UvMf0l/+Q8CAtw4D5s/8hD7Vqvrv4H/ZfV7SrZ+rPrihi01t6LlcpZ2YMucX/tSgDzkjYWmT26V2OgRklM0aQWvHD3DVpghIJfI2swAAJJ5wvqwcJe
-    WHAQb3aQZgHXjGF/LyBYCQsohTHUL7rhL8CxNlDTNhN2e+NRFGYGer157RCmM8xKroe3/X9pYifbzyEWInqQ+ycmLsQyAd7pPW+W1K1tlk9Niqk3dNQ10daYGau3IPWF5+iHtOlWjLcQrSj60Uv7Ebi0E+
-    Oe0tDabunCj6SEauGFxeJhM9xUZnOwb5wqIt+uGqPQ9WRJLehqwdFhiWOqwUfNcksn7l0M6e9Mnkh1J2kGxamQ0bvK7ftpm5O8MTAft0y882IfC++Zuk4gLhQoeE3s6877/rrHRJB/H8ZUaaBxAi2qH0NZ
-    ParXUxOkil5rVgFqI="
+      "MIIEkzCCAnugAwIBAgIVAO5SRZQELwNNhWF+8st6ox9uXYgeMA0GCSqGSIb3DQEBCwUAMIGrMQswCQYDVQQGEwJJTDEPMA0GA1UECBMGSXNyYWVsMS4wLAYDVQQKEyVDaGVja1BvaW50IFNvZnR3YXJlIF
+       lY2hub2xvZ2llcyBMVEQuMQwwCgYDVQQLEwNNSVMxIjAgBgNVBAMTGUNoZWNrUG9pbnQtU1NMLUluc3BlY3Rpb24xKTAnBgkqhkiG9w0BCQEWGmlsX3NlY3VyaXR5QGNoZWNrcG9pbnQuY29tMB4XDTIzM
+       MxMzAwMDAwMFoXDTIzMDYxMTIzNTk1OVowbzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExEzARBgNVBAcTCk1lbmxvIFBhcmsxHTAbBgNVBAoTFE1ldGEgUGxhdGZvcm1zLCBJbmMuMRcw
+       QYDVQQDDA4qLndoYXRzYXBwLm5ldDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABPjo05vRHAJYYWx55SOu2b1ZIQPOOtJNipSBXf1BFBDQhrkp20YTA296MzKii2j3TgVi/1t44cW5mD1RWobfAQujgbM
+       gbAwHQYDVR0lBBYwFAYIKwYBBQUHAwEGCCsGAQUFBwMCMHQGA1UdEQRtMGuCDioud2hhdHNhcHAubmV0ghIqLmNkbi53aGF0c2FwcC5uZXSCEiouc25yLndoYXRzYXBwLm5ldIIOKi53aGF0c2FwcC5jb2
+       CBXdhLm1lggx3aGF0c2FwcC5jb22CDHdoYXRzYXBwLm5ldDAOBgNVHQ8BAf8EBAMCBaAwCQYDVR0TBAIwADANBgkqhkiG9w0BAQsFAAOCAgEAA/sIadLr9ahEVq8h9HuofHODUuzxVFulAZu8uSiyY4ACb
+       Hcvm36MYQCzYV56t4fe+I++ls8KAESZgdE0KoD5/6efzK05Ufok+y15QexAR5AxZlJqtoHIuc7iOolPbkLW77GKrbgfEgmwOCX9/86Pug4ZSrrBUPPt9i3accNkAP+SH9Lft1geS2E/q+xcRhbhDcYTYD5
+       X0MiEv0UaAzwS3adWAZbD7R42u+xNCpX8iUyiwp2UvMf0l/+Q8CAtw4D5s/8hD7Vqvrv4H/ZfV7SrZ+rPrihi01t6LlcpZ2YMucX/tSgDzkjYWmT26V2OgRklM0aQWvHD3DVpghIJfI2swAAJJ5wvqwcJe
+       WHAQb3aQZgHXjGF/LyBYCQsohTHUL7rhL8CxNlDTNhN2e+NRFGYGer157RCmM8xKroe3/X9pYifbzyEWInqQ+ycmLsQyAd7pPW+W1K1tlk9Niqk3dNQ10daYGau3IPWF5+iHtOlWjLcQrSj60Uv7Ebi0E+
+       Oe0tDabunCj6SEauGFxeJhM9xUZnOwb5wqIt+uGqPQ9WRJLehqwdFhiWOqwUfNcksn7l0M6e9Mnkh1J2kGxamQ0bvK7ftpm5O8MTAft0y882IfC++Zuk4gLhQoeE3s6877/rrHRJB/H8ZUaaBxAi2qH0NZ
+       ParXUxOkil5rVgFqI="
 """
 
 RETURN = """

plugins/modules/cp_mgmt_add_nat_rule.py

@@ -114,7 +114,7 @@
     comments: comment example1 nat999
     enabled: false
     install_on:
-    - Policy Targets
+      - Policy Targets
     original_destination: All_Internet
     original_source: Any
     package: standard

plugins/modules/cp_mgmt_add_rules_batch.py

@@ -80,27 +80,26 @@
 - name: add-rules-batch
   cp_mgmt_add_rules_batch:
     objects:
-    - first_position: top
-      layer: Network
-      list:
-      - action: accept
-        name: access rule 1
-      - action: accept
-        name: access rule 2
-      type: access-rule
-    - first_position: top
-      layer: Standard
-      list:
-      - name: nat rule 1
-      - name: nat rule 2
-      type: nat-rule
-    - first_position: top
-      layer: Default Layer
-      list:
-      - name: https rule 1
-      - name: https rule 2
-      type: https-rule
-
+      - first_position: top
+        layer: Network
+        list:
+          - action: accept
+            name: access rule 1
+          - action: accept
+            name: access rule 2
+        type: access-rule
+      - first_position: top
+        layer: Standard
+        list:
+          - name: nat rule 1
+          - name: nat rule 2
+        type: nat-rule
+      - first_position: top
+        layer: Default Layer
+        list:
+          - name: https rule 1
+          - name: https rule 2
+        type: https-rule
 """
 
 RETURN = """

plugins/modules/cp_mgmt_address_range_facts.py

@@ -50,6 +50,13 @@
         representation of the object.
     type: str
     choices: ['uid', 'standard', 'full']
+  filter:
+    description:
+      - Search expression to filter objects by. The provided text should be exactly the same as it would be given in SmartConsole Object Explorer. The
+        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
+        name, comment, tags etc.
+    type: str
+    version_added: "6.4.0"
   limit:
     description:
       - No more than that many results will be returned.
@@ -81,6 +88,13 @@
     description:
       - Indicates whether to calculate and show "groups" field for every object in reply.
     type: bool
+  domains_to_process:
+    description:
+      - 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
+        with ignore-warnings true. Valid values are, CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.
+    type: list
+    elements: str
+    version_added: "6.4.0"
 extends_documentation_fragment: check_point.mgmt.checkpoint_facts
 """
 
@@ -114,6 +128,7 @@ def main():
     argument_spec = dict(
         name=dict(type="str"),
         details_level=dict(type="str", choices=["uid", "standard", "full"]),
+        filter=dict(type='str'),
         limit=dict(type="int"),
         offset=dict(type="int"),
         order=dict(
@@ -125,6 +140,7 @@ def main():
             ),
         ),
         show_membership=dict(type="bool"),
+        domains_to_process=dict(type='list', elements="str")
     )
     argument_spec.update(checkpoint_argument_spec_for_facts)
 

plugins/modules/cp_mgmt_administrator_facts.py

@@ -50,6 +50,13 @@
         representation of the object.
     type: str
     choices: ['uid', 'standard', 'full']
+  filter:
+    description:
+      - Search expression to filter objects by. The provided text should be exactly the same as it would be given in SmartConsole Object Explorer. The
+        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
+        name, comment, tags etc.
+    type: str
+    version_added: "6.4.0"
   limit:
     description:
       - The maximal number of returned results.
@@ -77,6 +84,13 @@
           - Sorts results by the given field in descending order.
         type: str
         choices: ['name']
+  domains_to_process:
+    description:
+      - 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
+        with ignore-warnings true. Valid values are, CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.
+    type: list
+    elements: str
+    version_added: "6.4.0"
 extends_documentation_fragment: check_point.mgmt.checkpoint_facts
 """
 
@@ -110,6 +124,7 @@ def main():
     argument_spec = dict(
         name=dict(type="str"),
         details_level=dict(type="str", choices=["uid", "standard", "full"]),
+        filter=dict(type='str'),
         limit=dict(type="int"),
         offset=dict(type="int"),
         order=dict(
@@ -120,6 +135,7 @@ def main():
                 DESC=dict(type="str", choices=["name"]),
             ),
         ),
+        domains_to_process=dict(type='list', elements="str")
     )
     argument_spec.update(checkpoint_argument_spec_for_facts)
 

plugins/modules/cp_mgmt_application_site.py

@@ -111,16 +111,16 @@
 - name: add-application-site
   cp_mgmt_application_site:
     additional_categories:
-    - Instant Chat
-    - Supports Streaming
-    - New Application Site Category 1
+      - Instant Chat
+      - Supports Streaming
+      - New Application Site Category 1
     description: My Application Site
     name: New Application Site 1
     primary_category: Social Networking
     state: present
     url_list:
-    - www.cnet.com
-    - www.stackoverflow.com
+      - www.cnet.com
+      - www.stackoverflow.com
     urls_defined_as_regular_expression: false
 
 - name: set-application-site