check_point.mgmt.cp_mgmt_vpn_community_meshed module – Manages vpn-community-meshed objects on Check Point over Web Services API
Note
This module is part of the check_point.mgmt collection (version 6.9.0).
You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.
To install it, use: ansible-galaxy collection install check_point.mgmt.
To use it in a playbook, specify: check_point.mgmt.cp_mgmt_vpn_community_meshed.
New in check_point.mgmt 1.0.0
Synopsis
- Manages vpn-community-meshed objects on Check Point devices including creating, updating and removing objects.
- All operations are performed over Web Services API.
- Available from R80 management version.
Parameters
Parameter | Comments |
|---|---|
advanced_properties dictionary added in check_point.mgmt 6.5.0 | Advanced properties. Available from R82 JHF management version. |
|
support_ip_compression boolean |
Indicates whether to support IP compression. Choices:
|
|
use_aggressive_mode boolean |
Indicates whether to use aggressive mode. Choices:
|
auto_publish_session boolean | Publish the current session if changes have been performed after task completes. Choices:
|
color string | Color of the object. Should be one of existing colors. Choices:
|
comments string | Comments string. |
details_level string | 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. Choices:
|
disable_nat boolean added in check_point.mgmt 6.5.0 | Indicates whether to disable NAT inside the VPN Community. Available from R82 JHF management version. Choices:
|
encrypted_traffic dictionary added in check_point.mgmt 6.5.0 | Encrypted traffic settings. Available from R82 JHF management version. |
|
enabled boolean |
Indicates whether to accept all encrypted traffic. Choices:
|
encryption_method string | The encryption method to be used. Available from R80.10 management version. Choices:
|
encryption_suite string | The encryption suite to be used. Available from R80.10 management version. Choices:
|
excluded_services list / elements=string added in check_point.mgmt 6.5.0 | Collection of services that are excluded from the community identified by the name or UID.<br> Connections with these services will not be encrypted and will not match rules specifying the community in the VPN community. Available from R82 JHF management version. |
gateways list / elements=string | Collection of Gateway objects identified by the name or UID. |
ignore_errors boolean | 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. Choices:
|
ignore_warnings boolean | Apply changes ignoring warnings. Choices:
|
ike_phase_1 dictionary | Ike Phase 1 settings. Only applicable when the encryption-suite is set to [custom]. Available from R80.10 management version. |
|
data_integrity string |
The hash algorithm to be used. Choices:
|
|
diffie_hellman_group string |
The Diffie-Hellman group to be used. Choices:
|
|
encryption_algorithm string |
The encryption algorithm to be used. Choices:
|
ike_phase_2 dictionary | Ike Phase 2 settings. Only applicable when the encryption-suite is set to [custom]. Available from R80.10 management version. |
|
data_integrity string |
The hash algorithm to be used. Choices:
|
|
encryption_algorithm string |
The encryption algorithm to be used. Choices:
|
name string / required | Object name. |
permanent_tunnels dictionary added in check_point.mgmt 6.5.0 | Permanent tunnels properties. Available from R82 JHF management version. |
|
gateways list / elements=dictionary |
List of gateways to set all their tunnels to permanent with specified track options. Will take effect only if set-permanent-tunnels-on is set to all-tunnels-of-specific-gateways. |
|
gateway string |
Gateway to set all is tunnels to permanent with specified track options.<br> Identified by name or UID. |
|
override_tunnel_down_track string |
Gateway tunnel down track option. Relevant only if the track-options is set to ‘override track options’. Choices:
|
|
override_tunnel_up_track string |
Gateway tunnel up track option. Relevant only if the track-options is set to ‘override track options’. Choices:
|
|
track_options string |
Indicates whether to use the community track options or to override track options for the permanent tunnels. Choices:
|
|
rim dictionary |
Route Injection Mechanism settings. |
|
enable_on_gateways boolean |
Indicates whether to enable automatic Route Injection Mechanism for gateways. Choices:
|
|
enabled boolean |
Indicates whether Route Injection Mechanism is enabled. Choices:
|
|
route_injection_track string |
Route injection track method. Choices:
|
|
set_permanent_tunnels string |
Indicates which tunnels to set as permanent. Choices:
|
|
tunnel_down_track string |
VPN community permanent tunnels down track option. Choices:
|
|
tunnel_up_track string |
Permanent tunnels up track option. Choices:
|
|
tunnels list / elements=dictionary |
List of tunnels to set as permanent with specified track options. Will take effect only if set-permanent-tunnels-on is set to specific-tunnels-in-the-community. |
|
first_tunnel_endpoint string |
First tunnel endpoint (center gateway). Identified by name or UID. |
|
override_tunnel_down_track string |
Gateway tunnel down track option. Relevant only if the track-options is set to ‘override track options’. Choices:
|
|
override_tunnel_up_track string |
Gateway tunnel up track option. Relevant only if the track-options is set to ‘override track options’. Choices:
|
|
second_tunnel_endpoint string |
Second tunnel endpoint (center gateway for meshed VPN community and satellite gateway for star VPN community). Identified by name or UID. |
|
track_options string |
Indicates whether to use the community track options or to override track options for the permanent tunnels. Choices:
|
routing_mode string added in check_point.mgmt 6.5.0 | VPN Community Routing Mode. Available from R82 JHF management version. Choices:
|
list / elements=dictionary | Shared secrets for external gateways. Available from R80.10 management version. |
|
string |
External gateway identified by the name or UID. |
|
string |
Shared secret. |
state string | State of the access rule (present or absent). Choices:
|
tags list / elements=string | Collection of tag identifiers. |
boolean | Indicates whether the shared secret should be used for all external gateways. Available from R80.10 management version. Choices:
|
version string | Version of checkpoint. If not given one, the latest version taken. |
wait_for_task boolean | Wait for the task to end. Such as publish task. Choices:
|
wait_for_task_timeout integer | How many minutes to wait until throwing a timeout error. Default: |
wire_mode dictionary added in check_point.mgmt 6.5.0 | VPN Community Wire mode properties. Available from R82 JHF management version. |
|
allow_uninspected_encrypted_routing boolean |
Allow members to route uninspected encrypted traffic in VPN routing configurations. Choices:
|
|
allow_uninspected_encrypted_traffic boolean |
Allow uninspected encrypted traffic between Wire mode interfaces of this Community members. Choices:
|
Examples
- name: add-vpn-community-meshed
cp_mgmt_vpn_community_meshed:
encryption_method: prefer ikev2 but support ikev1
encryption_suite: custom
ike_phase_1:
data_integrity: sha1
diffie_hellman_group: group 19
encryption_algorithm: aes-128
ike_phase_2:
data_integrity: aes-xcbc
encryption_algorithm: aes-gcm-128
name: New_VPN_Community_Meshed_1
state: present
- name: set-vpn-community-meshed
cp_mgmt_vpn_community_meshed:
encryption_method: ikev2 only
encryption_suite: custom
ike_phase_1:
data_integrity: sha1
diffie_hellman_group: group 19
encryption_algorithm: aes-128
ike_phase_2:
data_integrity: aes-xcbc
encryption_algorithm: aes-gcm-128
name: New_VPN_Community_Meshed_1
state: present
- name: delete-vpn-community-meshed
cp_mgmt_vpn_community_meshed:
name: New_VPN_Community_Meshed_1
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Description |
|---|---|
cp_mgmt_vpn_community_meshed dictionary | The checkpoint object created or updated. Returned: always, except when deleting the object. |
Collection links
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/check_point/mgmt/cp_mgmt_vpn_community_meshed_module.html