ansible.builtin.cp_mgmt_service_other (v2.9.17) — module

Install Ansible via pip

Install with pip install ansible==2.9.17

Description

Manages service-other objects on Check Point devices including creating, updating and removing objects.

All operations are performed over Web Services API.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: add-service-other
  cp_mgmt_service_other:
    aggressive_aging:
      enable: true
      timeout: 360
      use_default_timeout: false
    ip_protocol: 51
    keep_connections_open_after_policy_installation: false
    match_for_any: true
    name: New_Service_1
    session_timeout: 0
    state: present
    sync_connections_on_cluster: true

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: set-service-other
  cp_mgmt_service_other:
    aggressive_aging:
      default_timeout: 3600
    color: green
    name: New_Service_1
    state: present

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: delete-service-other
  cp_mgmt_service_other:
    name: New_Service_2
    state: absent

Inputs

    
name:
    description:
    - Object name.
    required: true
    type: str

tags:
    description:
    - Collection of tag identifiers.
    type: list

color:
    choices:
    - aquamarine
    - black
    - blue
    - crete blue
    - burlywood
    - cyan
    - dark green
    - khaki
    - orchid
    - dark orange
    - dark sea green
    - pink
    - turquoise
    - dark blue
    - firebrick
    - brown
    - forest green
    - gold
    - dark gold
    - gray
    - dark gray
    - light green
    - lemon chiffon
    - coral
    - sea green
    - sky blue
    - magenta
    - purple
    - slate blue
    - violet red
    - navy blue
    - olive
    - orange
    - red
    - sienna
    - yellow
    description:
    - Color of the object. Should be one of existing colors.
    type: str

match:
    description:
    - Contains an INSPECT expression that defines the matching criteria. The connection
      is examined against the expression during the first packet. Example, tcp, dport
      = 21, direction = 0 matches incoming FTP control connections.
    type: str

state:
    choices:
    - present
    - absent
    default: present
    description:
    - State of the access rule (present or absent).
    type: str

action:
    description:
    - Contains an INSPECT expression that defines the action to take if a rule containing
      this service is matched. Example, set r_mhandler &open_ssl_handler sets a handler
      on the connection.
    type: str

groups:
    description:
    - Collection of group identifiers.
    type: list

version:
    description:
    - Version of checkpoint. If not given one, the latest version taken.
    type: str

comments:
    description:
    - Comments string.
    type: str

ip_protocol:
    description:
    - IP protocol number.
    type: int

details_level:
    choices:
    - uid
    - standard
    - full
    description:
    - 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 representation of the object.
    type: str

ignore_errors:
    description:
    - 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.
    type: bool

match_for_any:
    description:
    - Indicates whether this service is used when 'Any' is set as the rule's service and
      there are several service objects with the same source port and protocol.
    type: bool

wait_for_task:
    default: true
    description:
    - Wait for the task to end. Such as publish task.
    type: bool

accept_replies:
    description:
    - Specifies whether Other Service replies are to be accepted.
    type: bool

ignore_warnings:
    description:
    - Apply changes ignoring warnings.
    type: bool

session_timeout:
    description:
    - Time (in seconds) before the session times out.
    type: int

aggressive_aging:
    description:
    - Sets short (aggressive) timeouts for idle connections.
    suboptions:
      default_timeout:
        description:
        - Default aggressive aging timeout in seconds.
        type: int
      enable:
        description:
        - N/A
        type: bool
      timeout:
        description:
        - Aggressive aging timeout in seconds.
        type: int
      use_default_timeout:
        description:
        - N/A
        type: bool
    type: dict

auto_publish_session:
    default: false
    description:
    - Publish the current session if changes have been performed after task completes.
    type: bool

wait_for_task_timeout:
    default: 30
    description:
    - How many minutes to wait until throwing a timeout error.
    type: int

override_default_settings:
    description:
    - Indicates whether this service is a Data Domain service which has been overridden.
    type: bool

sync_connections_on_cluster:
    description:
    - Enables state-synchronized High Availability or Load Sharing on a ClusterXL or OPSEC-certified
      cluster.
    type: bool

use_default_session_timeout:
    description:
    - Use default virtual session timeout.
    type: bool

keep_connections_open_after_policy_installation:
    description:
    - Keep connections open after policy has been installed even if they are not allowed
      under the new policy. This overrides the settings in the Connection Persistence
      page. If you change this property, the change will not affect open connections,
      but only future connections.
    type: bool

Outputs

cp_mgmt_service_other:
  description: The checkpoint object created or updated.
  returned: always, except when deleting the object.
  type: dict