Spec-Zone.ru › Ansible

модуль check_point.mgmt.cp_mgmt_mobile_profile — Управляет объектами мобильных профилей в 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_mobile_profile.

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

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

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

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

Параметры

Параметр

Описание

applications

dictionary

Настройки приложений.

allow_caching_docsec_credentials

boolean

Разрешить хранение учетных данных зашифрованных документов в защищенном хранилище приложения.

Варианты:

  • false
  • true

allow_caching_docsec_keys

boolean

Разрешить хранение ключей зашифрованных документов в защищенном хранилище приложения.

Варианты:

  • false
  • true

allow_calendar_sync

boolean

Разрешить синхронизацию рабочего календаря с календарем устройства.

Варианты:

  • false
  • true

allow_contacts_from_global_address_list

boolean

Разрешить добавлять в приложение дополнительные контакты из глобального списка адресов.

Варианты:

  • false
  • true

allow_contacts_from_local_phone

boolean

Разрешить добавлять в приложение дополнительные контакты из локальной телефонной книги.

Варианты:

  • false
  • true

allow_push_notification

boolean

Разрешить получать push-уведомления о письмах и встречах.

Варианты:

  • false
  • true

calendar_from_the_last

integer

За какой период назад показывать календарь относительно текущей даты — единицу измерения (день, неделя, месяц) можно выбрать в поле «calendar-from-the-last-unit».

calendar_from_the_last_unit

string

Единица измерения числового значения «calendar-from-the-last».

Варианты:

  • "weeks"
  • "months"
  • "days"

calendar_to_the_following

integer

На какой период вперед показывать календарь относительно текущей даты — единицу измерения (день, неделя, месяц) можно выбрать в поле «calendar-to-the-following-unit».

calendar_to_the_following_unit

string

Единица измерения числового значения «calendar-to-the-following».

Варианты:

  • "weeks"
  • "months"
  • "days"

enable_print_mails

boolean

Разрешить печать писем.

Варианты:

  • false
  • true

mail_from_the_last

integer

За какой период назад показывать электронные письма относительно текущей даты — единицу измерения (день, неделя, месяц) можно выбрать в поле «mail-from-the-last-unit».

mail_from_the_last_unit

string

Единица измерения числового значения «mail-from-the-last».

Варианты:

  • "weeks"
  • "months"
  • "days"

max_attachments_size

integer

Максимальный размер вложений, разрешенных для загрузки; единицу измерения (ГБ, КБ, МБ, байты) можно выбрать в поле «max-attachments-unit».

save_local_web_cache

boolean

Настройка сохранения данных локального кэша, создаваемых веб-браузером.

Варианты:

  • false
  • true

synchronize_contacts

string

Способ синхронизации контактов: с почтового сервера на устройство и в приложение и обратно, с почтового сервера на устройство и в приложение или с почтового сервера только в приложение.

Варианты:

  • "mail srv to app and device and vice versa"
  • "mail srv to app and device"
  • "mail srv to app"

auto_publish_session

boolean

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

Варианты:

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

client_customization

dictionary

Настройки персонализации клиента.

allow_calendar

boolean

Разрешить синхронизацию рабочего календаря с календарем устройства.

Варианты:

  • false
  • true

allow_contacts

boolean

Включить или отключить приложение «Контакты».

Варианты:

  • false
  • true

allow_mail

boolean

Включить или отключить приложение электронной почты.

Варианты:

  • false
  • true

allow_notes_sync

boolean

Разрешить синхронизацию рабочих заметок с заметками устройства.

Варианты:

  • false
  • true

allow_saved_file_apps

boolean

Разрешить отображение приложения «Сохраненные файлы» в списке приложений.

Варианты:

  • false
  • true

allow_secure_chat

boolean

Включить или отключить приложение «Сообщения» (зависит от приложения «Почта»).

Варианты:

  • false
  • true

allow_tasks

boolean

Включить или отключить приложение «Задачи».

Варианты:

  • false
  • true

app_theme_color_dark

string

Настройка цветов интерфейса приложения в темном режиме. 6 шестнадцатеричных цифр, задающих цвет RGB; применимо для iOS.

app_theme_color_light

string

Настройка цветов интерфейса приложения в светлом режиме. 6 шестнадцатеричных цифр, задающих цвет RGB; применимо для iOS.

certificate_expire_message

string

Сообщение для пользователей об истечении срока действия сертификата; заполняется администратором. Может содержать только английские буквы, цифры, запятые, пробелы и точки.

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

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

data_leak_prevention

dictionary

Настройки предотвращения утечки данных.

accept_protected_file_extensions

list / elements=string

Принимать в приложение защищенные файлы с указанными расширениями из внешних приложений.

Варианты:

  • "any file"
  • "word documents"
  • "excel documents"
  • "powerpoint documents"
  • "any microsoft office documents"
  • "media files"

accept_unprotected_file_extensions

list / elements=string

Принимать в приложение незащищенные файлы с указанными расширениями из внешних приложений.

Варианты:

  • "any file"
  • "word documents"
  • "excel documents"
  • "powerpoint documents"
  • "any microsoft office documents"
  • "media files"

allow_copy_paste

boolean

Разрешить копирование и вставку содержимого писем.

Варианты:

  • false
  • true

allow_import_from_gallery

boolean

Разрешить импорт медиафайлов из галереи.

Варианты:

  • false
  • true

allow_taking_photos_and_videos

boolean

Разрешить использовать камеру в приложении.

Варианты:

  • false
  • true

allowed_domains_forward_attachment

string

Домены-исключения, на которые разрешено отправлять вложения, даже если общая политика запрещает передачу файлов такого типа. Может содержать только английские буквы, цифры, запятые, пробелы и точки.

block_forward_attachments

boolean

Разрешить передавать вложения из писем во внешние письма.

Варианты:

  • false
  • true

block_screenshot

boolean

Если значение равно true, делать снимки экрана в приложении нельзя.

Варианты:

  • false
  • true

offer_capsule_as_viewer

boolean

Предлагать Capsule в качестве средства просмотра внешних защищенных документов.

Варианты:

  • false
  • true

open_extension_with_external_app

list / elements=string

Открывать файлы с указанными расширениями во внешних приложениях, если их невозможно открыть с помощью средства просмотра Capsule.

Варианты:

  • "any file"
  • "word documents"
  • "excel documents"
  • "powerpoint documents"
  • "any microsoft office documents"
  • "media files"

share_protected_extension

list / elements=string

Разрешить передачу во внешние приложения защищенных файлов с указанными расширениями.

Варианты:

  • "any file"
  • "word documents"
  • "excel documents"
  • "powerpoint documents"
  • "any microsoft office documents"
  • "media files"

share_unprotected_extension

list / elements=string

Разрешить передачу во внешние приложения незащищенных файлов с указанными расширениями.

Варианты:

  • "any file"
  • "word documents"
  • "excel documents"
  • "powerpoint documents"
  • "any microsoft office documents"
  • "media files"

details_level

string

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

Варианты:

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

domains_to_process

list / elements=string

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

harmony_mobile

dictionary

Настройки интеграции.

compromised_behavior

string

Конфигурация устройства — реакция на вредоносное поведение (настройка Harmony SDK).

Варианты:

  • "block"
  • "notify"
  • "ignore"

enable_harmony_mobile_sdk

boolean

Включить или отключить Harmony SDK. Нельзя включить, если включено приложение Harmony Mobile.

Варианты:

  • false
  • true

harmony_mobile_sdk_license

string

Лицензия Harmony Mobile SDK (настройка Harmony SDK) может содержать только английские символы, цифры, запятые, пробелы и точки.

malware_behavior

string

Поведение при обнаружении вредоносного приложения (настройка Harmony SDK).

Варианты:

  • "block"
  • "notify"
  • "ignore"

man_in_the_middle_attack

string

Поведение при сетевой атаке типа «человек посередине» (настройка Harmony SDK).

Варианты:

  • "block"
  • "notify"
  • "ignore"

os_integrity_compromised

string

Поведение при компрометации ОС устройства (настройка Harmony SDK).

Варианты:

  • "block"
  • "notify"
  • "ignore"

protect_high_risk_action

string

Действие при обнаружении высокого уровня риска с помощью Harmony Mobile.

Варианты:

  • "none"
  • "wipe"
  • "block"

protect_high_risk_message

string

Сообщение может содержать только английские символы, цифры, запятые, пробелы и точки.

protect_medium_risk_action

string

Действие при обнаружении среднего уровня риска с помощью Harmony Mobile.

Варианты:

  • "none"
  • "wipe"
  • "block"

protect_medium_risk_message

string

Сообщение может содержать только английские символы, цифры, запятые, пробелы и точки.

protect_not_activated_action

string

Действие при нарушении политики (настройка Harmony Mobile).

Варианты:

  • "none"
  • "wipe"
  • "block"

protect_not_activated_message

string

Сообщение может содержать только английские символы, цифры, запятые, пробелы и точки.

protect_policy_enabled

boolean

Включить или отключить приложение Protect. Нельзя включить, если включён Harmony SDK.

Варианты:

  • false
  • true

suspicious_app

string

Поведение при подозрении на вредоносное приложение (настройка Harmony SDK).

Варианты:

  • "block"
  • "notify"
  • "ignore"

suspicious_enterprise_certificate

string

Поведение при установке профиля сертификата, позволяющего устанавливать на устройство приложения из неизвестного источника; только iOS (настройка Harmony SDK).

Варианты:

  • "block"
  • "notify"
  • "ignore"

ignore_errors

boolean

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

Варианты:

  • false
  • true

ignore_warnings

boolean

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

Варианты:

  • false
  • true

name

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

Имя объекта.

security

dictionary

Параметры безопасности.

activate_passcode_lock

boolean

Требовать код-пароль для доступа к приложению.

Варианты:

  • false
  • true

allow_store_credentials

boolean

Разрешить сохранение учётных данных на устройстве.

Варианты:

  • false
  • true

block_3rd_party_keyboard

boolean

Блокировать сторонние клавиатуры.

Варианты:

  • false
  • true

block_jailbroken

string

Действие при обнаружении взломанных устройств.

Варианты:

  • "block"
  • "none"

hide_ssl_connect_anyway_button

boolean

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

Варианты:

  • false
  • true

passcode_profile

string

Объект политики код-пароля, указанный по имени или UID.

report_jailbroken

boolean

Создавать запись журнала при обнаружении взломанного устройства.

Варианты:

  • false
  • true

session_timeout

integer

Тайм-аут сеанса. Единицу измерения (день, неделя, месяц) можно выбрать в поле «session-timeout-unit».

session_timeout_unit

string

Единица измерения числового значения «session-timeout».

Варианты:

  • "weeks"
  • "days"
  • "hours"
  • "minutes"

state

string

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

Варианты:

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

tags

list / элементы=string

Набор идентификаторов тегов.

version

string

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

wait_for_task

boolean

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

Варианты:

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

wait_for_task_timeout

integer

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

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

Примеры

- name: add-mobile-profile
  cp_mgmt_mobile_profile:
    name: New Mobile Profile
    state: present

- name: set-mobile-profile
  cp_mgmt_mobile_profile:
    data_leak_prevention:
      share_protected_extension: word documents
    name: New Mobile Profile
    state: present

- name: delete-mobile-profile
  cp_mgmt_mobile_profile:
    name: New Mobile Profile
    state: absent

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

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

Ключ

Описание

cp_mgmt_mobile_profile

dictionary

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

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

Авторы

  • Eden Brillant (@chkp-edenbr)

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

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

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

Spec-Zone.ru

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