Merge pull request #53 from chkp-ameera/master

new release 6.0.0

Author: chkp-majds

CHANGELOG.rst

@@ -11,7 +11,7 @@ v6.0.0
 Release Summary
 ---------------
 
-this release 6.0.0 of ``check_point.gaia``, released on 2025-1-6.
+this release 6.0.0 of ``check_point.gaia``, released on 2025-1-22.
 
 New Modules
 -----------
@@ -30,6 +30,18 @@ New Modules
 - check_point.gaia.cp_gaia_virtual_gateway – manages virtual-gateway objects on Check Point machine over Web Services API.
 - check_point.gaia.cp_gaia_virtual_gateway_facts – get virtual-gateway objects facts on Check Point machine over Web Services API.
 - check_point.gaia.cp_gaia_virtual_vsnext_state_facts – get the VSNext state on Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_grub_password – manage grub password of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_grub_password_facts – get grub hash password of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp –  manage SNMP configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_facts –  get SNMP configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_custom_trap –  manage SNMP custom trap configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_custom_trap_facts –  get SNMP custom trap configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_pre_defined_traps –  manage SNMP pre defined traps configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_pre_defined_traps_facts –  get SNMP pre defined traps configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_trap_receiver –  manage SNMP trap receiver configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_trap_receiver_facts –  get SNMP trap receiver configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_user –  manage SNMP USM user configuration of a Check Point machine over Web Services API.
+- check_point.gaia.cp_gaia_snmp_user_facts –  get SNMP USM user configuration of a Check Point machine over Web Services API.
 
 Major Changes
 ---------------

README.md

@@ -135,6 +135,18 @@ Modules
 * `cp_gaia_alias_interface_facts` – Get information about alias interfaces of a Check Point machine over Web Services API.
 * `cp_gaia_system_group` – Manage system groups of a Check Point machine over Web Services API.
 * `cp_gaia_system_group_facts` – Get information about system groups of a Check Point machine over Web Services API.
+* `cp_gaia_grub_password` – manage grub password of a Check Point machine over Web Services API.
+* `cp_gaia_grub_password_facts` – get grub hash password of a Check Point machine over Web Services API.
+* `cp_gaia_snmp` –  manage SNMP configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_facts` –  get SNMP configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_custom_trap` –  manage SNMP custom trap configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_custom_trap_facts` –  get SNMP custom trap configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_pre_defined_traps` –  manage SNMP pre defined traps configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_pre_defined_traps_facts` –  get SNMP pre defined traps configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_trap_receiver` –  manage SNMP trap receiver configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_trap_receiver_facts` –  get SNMP trap receiver configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_user` –  manage SNMP USM user configuration of a Check Point machine over Web Services API.
+* `cp_gaia_snmp_user_facts` –  get SNMP USM user configuration of a Check Point machine over Web Services API.
 
 
 ### Code of Conduct

docs/cp_gaia_grub_password.rst

@@ -0,0 +1,87 @@
+.. _cp_gaia_grub_password_module:
+
+
+cp_gaia_grub_password -- Sets GRUB password.
+============================================
+
+.. contents::
+   :local:
+   :depth: 1
+
+
+Synopsis
+--------
+
+Sets GRUB password.
+
+
+
+Requirements
+------------
+The below requirements are needed on the host that executes this module.
+
+- supported starting from gaia\_api \>= 1.7
+
+
+
+Parameters
+----------
+
+  version (False, str, None)
+    Gaia API version for example 1.7.
+
+
+  password (False, str, None)
+    GRUB new password.
+
+
+  password_hash (False, str, None)
+    An encrypted representation of the password.
+
+
+
+
+
+Notes
+-----
+
+.. note::
+   - Supports \ :literal:`check\_mode`\ .
+
+
+
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+    
+    - name: Setting GRUB new password
+      check_point.gaia.cp_gaia_grub_password:
+        password: newpass
+
+
+
+Return Values
+-------------
+
+grub_password (always., dict, )
+  The checkpoint object updated.
+
+
+
+
+
+Status
+------
+
+
+
+
+
+Authors
+~~~~~~~
+
+- Ameer Asli (@chkp-ameera)
+

docs/cp_gaia_grub_password_facts.rst

@@ -0,0 +1,85 @@
+.. _cp_gaia_grub_password_facts_module:
+
+
+cp_gaia_grub_password_facts -- Show GRUB hash password.
+=======================================================
+
+.. contents::
+   :local:
+   :depth: 1
+
+
+Synopsis
+--------
+
+Show the GRUB hash password.
+
+
+
+Requirements
+------------
+The below requirements are needed on the host that executes this module.
+
+- supported starting from gaia\_api \>= 1.7
+
+
+
+Parameters
+----------
+
+  version (False, str, None)
+    Gaia API version for example 1.7.
+
+
+
+
+
+Notes
+-----
+
+.. note::
+   - Supports \ :literal:`check\_mode`\ .
+
+
+
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+    
+    - name: Show GRUB hash password
+      check_point.gaia.cp_gaia_grub_password_facts:
+
+
+
+
+
+Return Values
+-------------
+
+ansible_facts (always., dict, )
+  The checkpoint object facts.
+
+
+  password_hash (always, str, )
+    An encrypted representation of the password.
+
+
+
+
+
+
+Status
+------
+
+
+
+
+
+Authors
+~~~~~~~
+
+- Ameer Asli (@chkp-ameera)
+

docs/cp_gaia_snmp.rst

@@ -0,0 +1,124 @@
+.. _cp_gaia_snmp_module:
+
+
+cp_gaia_snmp -- SNMP agent configuration.
+=========================================
+
+.. contents::
+   :local:
+   :depth: 1
+
+
+Synopsis
+--------
+
+SNMP agent configuration.
+
+
+
+Requirements
+------------
+The below requirements are needed on the host that executes this module.
+
+- supported starting from gaia\_api \>= 1.6
+
+
+
+Parameters
+----------
+
+  version (False, str, None)
+    Gaia API version for example 1.6.
+
+
+  enabled (False, bool, None)
+    Enables/Disables the SNMP Agent.
+
+
+  ver (False, str, None)
+    Configures the supported SNMP version v1, v2 and v3.
+
+
+  trap_usm (False, str, None)
+    The user which will generate the SNMP traps, should be existed usm user
+
+
+  contact (False, str, None)
+    SNMP contact string
+
+
+  location (False, str, None)
+    SNMP location string Specifies a string that contains the location for the device.
+
+
+  read_only_community (False, str, None)
+    SNMP read-only community password, Where read-only lets you only read the values of SNMP objects
+
+
+  read_write_community (False, str, None)
+    SNMP read-write community password, Where read-write read and set the values as well
+
+
+  interfaces (False, str, None)
+    Adds a local interface to the list of local interfaces, on which the SNMP daemon listens
+
+
+  pre_defined_traps_settings (optional, dict, None)
+    Pre-defined traps settings.
+
+
+  custom_traps_settings (optional, dict, None)
+    Custom traps settings.
+
+
+  vsx_settings (optional, dict, None)
+    VSX settings.
+
+
+
+
+
+Notes
+-----
+
+.. note::
+   - Supports \ :literal:`check\_mode`\ .
+
+
+
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+    
+    - name: Set SNMP status
+      check_point.gaia.cp_gaia_snmp:
+        enabled: true
+
+
+
+
+Return Values
+-------------
+
+snmp (always., dict, )
+  The checkpoint object updated.
+
+
+
+
+
+Status
+------
+
+
+
+
+
+Authors
+~~~~~~~
+
+- Ameer Asli (@chkp-ameera)
+