Spec-Zone.ru › Ansible

модуль check_point.mgmt.cp_mgmt_resource_tcp — управление объектами resource-tcp на Checkpoint через API веб-служб

Примечание

Этот модуль входит в коллекцию check_point.mgmt (версия 6.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install check_point.mgmt.

Чтобы использовать её в плейбуке, укажите: check_point.mgmt.cp_mgmt_resource_tcp.

Добавлено в check_point.mgmt 6.5.0

  • Краткое описание
  • Параметры
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управление объектами resource-tcp на устройствах Checkpoint, включая создание, обновление и удаление объектов.
  • Все операции выполняются через API веб-служб.
  • Доступно начиная с версии управления R82 JHF.

Параметры

Параметр

Комментарии

auto_publish_session

boolean

Опубликовать текущий сеанс после выполнения задачи, если были внесены изменения.

Варианты:

  • false ← (по умолчанию)
  • true

color

string

Цвет объекта. Должен быть одним из существующих цветов.

Варианты:

  • "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"

comments

string

Строка комментария.

cvp_settings

dictionary

Параметры CVP.

allowed_to_modify_content

boolean

Настраивает сервер CVP на проверку содержимого без его изменения.

Варианты:

  • false
  • true

reply_order

string

Определяет, когда сервер CVP возвращает данные серверу безопасности Security Gateway.

Варианты:

  • "return_data_after_content_is_approved"
  • "return_data_before_content_is_approved"

server

string

Сервер CVP, определяемый именем или UID. Сервер CVP должен быть предварительно определён как приложение OPSEC.

details_level

string

Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до его полного подробного представления.

Варианты:

  • "uid"
  • "standard"
  • "full"

domains_to_process

list / elements=string

Указывает, в каких доменах выполнять команды. Нельзя использовать вместе с полным уровнем детализации (details-level full); запускать можно только из системного домена и при значении ignore-warnings true. Допустимые значения: CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.

exception_track

string

Настраивает отслеживание соединений, соответствующих этому правилу, но не прошедших проверки безопасности содержимого. Пример исключения — соединение с неподдерживаемой схемой или методом.

Варианты:

  • "none"
  • "exception log"
  • "exception alert"

ignore_errors

boolean

Применить изменения, игнорируя ошибки. Опубликовать такие изменения будет невозможно. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться.

Варианты:

  • false
  • true

ignore_warnings

boolean

Применить изменения, игнорируя предупреждения.

Варианты:

  • false
  • true

name

string / обязательный

Имя объекта.

resource_type

string

Тип ресурса TCP.

Варианты:

  • "cvp"
  • "ufp"

state

string

Состояние правила доступа (присутствует или отсутствует).

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

list / elements=string

Коллекция идентификаторов тегов.

ufp_settings

dictionary

Параметры UFP.

caching_control

string

Указывает, следует ли включить кэширование и каким образом.

Варианты:

  • "security_gateway_one_request"
  • "security_gateway_two_requests"
  • "no_caching"
  • "ufp_server"

ignore_ufp_server_after_failure

boolean

Сервер UFP будет игнорироваться после нескольких неудачных попыток подключения к нему.

Варианты:

  • false
  • true

number_of_failures_before_ignore

integer

Указывает количество сбоев, после которого сервер UFP следует игнорировать. Применяется только при включённом параметре «ignore after fail».

server

string

Сервер UFP, определяемый именем или UID. Сервер UFP должен быть предварительно определён как приложение OPSEC.

timeout_before_reconnecting

integer

Время в секундах, которое должно пройти перед попыткой подключения к серверу UFP. Применяется только при включённом параметре «ignore after fail».

version

string

Версия Checkpoint. Если не указана, используется последняя версия.

wait_for_task

boolean

Дождаться завершения задачи, например задачи публикации.

Варианты:

  • false
  • true ← (по умолчанию)

wait_for_task_timeout

integer

Сколько минут ожидать до возникновения ошибки превышения времени ожидания.

По умолчанию: 30

Примеры

- name: add-resource-tcp
  cp_mgmt_resource_tcp:
    name: newTcpResource
    state: present
    ufp_settings:
      caching_control: security_gateway_one_request
      ignore_ufp_server_after_failure: true
      number_of_failures_before_ignore: 3
      server: ufpServer

- name: set-resource-tcp
  cp_mgmt_resource_tcp:
    cvp_settings:
      server: cvpServer
    name: newTcpResource
    state: present
    ufp_settings:
      caching_control: ufp_server
      ignore_ufp_server_after_failure: false
      number_of_failures_before_ignore: 0

- name: delete-resource-tcp
  cp_mgmt_resource_tcp:
    name: tcpResource
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

cp_mgmt_resource_tcp

dictionary

Созданный или обновлённый объект Checkpoint.

Возвращается: всегда, кроме случая удаления объекта.

Авторы

  • Dor Berenstein (@chkp-dorbe)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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_resource_tcp_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API