check_point.mgmt.cp_mgmt_mobile_profile 模块 – 通过 Web Services API 管理 Checkpoint 上的移动配置文件对象

注意

此模块是 check_point.mgmt 集合 (版本 6.2.1) 的一部分。

如果您使用的是 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 设备上的移动配置文件对象，包括创建、更新和删除对象。

  • 所有操作均通过 Web Services API 执行。

参数

参数

注释

applications

字典

应用程序设置。

allow_caching_docsec_credentials

布尔值

允许将加密的文档凭据存储在应用程序安全存储中。

选项

  • false

  • true

allow_caching_docsec_keys

布尔值

允许将加密的文档密钥存储在应用程序安全存储中。

选项

  • false

  • true

allow_calendar_sync

布尔值

允许业务日历与设备日历同步。

选项

  • false

  • true

allow_contacts_from_global_address_list

布尔值

允许从全局地址列表中向应用添加其他联系人。

选项

  • false

  • true

allow_contacts_from_local_phone

布尔值

允许从本地电话中向应用添加其他联系人。

选项

  • false

  • true

allow_push_notification

布尔值

允许接收邮件和会议的推送通知。

选项

  • false

  • true

calendar_from_the_last

整数

从当前日期向前查看日历的时间范围 - 您可以在“calendar-from-the-last-unit”字段中选择单位（天、周、月）。

calendar_from_the_last_unit

字符串

“calendar-from-the-last” 数值的单位。

选项

  • "weeks"

  • "months"

  • "days"

calendar_to_the_following

整数

从当前日期向后查看日历的时间范围 - 您可以在“calendar-to-the-following-unit”字段中选择单位（天、周、月）。

calendar_to_the_following_unit

字符串

“calendar-to-the-following” 数值的单位。

选项

  • "weeks"

  • "months"

  • "days"

enable_print_mails

布尔值

允许打印邮件。

选项

  • false

  • true

mail_from_the_last

整数

从当前日期向前查看电子邮件的时间范围 - 在“mail-from-the-last-unit”字段中选择单位（天、周、月）。

mail_from_the_last_unit

字符串

“mail-from-the-last” 数值的单位。

选项

  • "weeks"

  • "months"

  • "days"

max_attachments_size

整数

允许下载的附件的最大大小 - 您可以在“max-attachments-unit”字段中选择单位（GB、KB、MB、字节）。

save_local_web_cache

布尔值

配置是否应保留 Web 浏览器生成的本地缓存数据。

选项

  • false

  • true

synchronize_contacts

字符串

联系人同步方法 - 从邮件服务器到设备和应用程序，反之亦然；或从邮件服务器到设备和应用程序；或从邮件服务器到应用程序。

选项

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

  • "mail srv to app and device"

  • "mail srv to app"

auto_publish_session

布尔值

如果在任务完成后进行了更改，则发布当前会话。

选项

  • false ← (默认)

  • true

client_customization

字典

客户端自定义设置。

allow_calendar

布尔值

允许将业务日历同步到设备日历。

选项

  • false

  • true

allow_contacts

布尔值

启用/禁用联系人应用程序。

选项

  • false

  • true

allow_mail

布尔值

启用/禁用电子邮件应用程序。

选项

  • false

  • true

allow_notes_sync

布尔值

允许将业务笔记同步到设备笔记。

选项

  • false

  • true

allow_saved_file_apps

布尔值

允许在应用程序列表中显示“已保存文件应用程序”。

选项

  • false

  • true

allow_secure_chat

布尔值

启用/禁用消息应用程序（取决于邮件应用程序）。

选项

  • false

  • true

allow_tasks

布尔值

启用/禁用任务应用程序。

选项

  • false

  • true

app_theme_color_dark

字符串

配置应用程序在暗模式下的显示颜色。6 个十六进制数字定义 RGB 颜色 - 与 IOS 相关。

app_theme_color_light

字符串

配置应用程序在亮模式下的显示颜色。6 个十六进制数字定义 RGB 颜色 - 与 IOS 相关。

certificate_expire_message

字符串

证书过期时显示给用户的邮件 - 供管理员填写 - 只能包含英文字符、数字、逗号、空格和句点。

color

字符串

对象的颜色。应为现有颜色之一。

选项

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

字符串

注释字符串。

data_leak_prevention

字典

数据泄露防护设置。

accept_protected_file_extensions

列表 / 元素=字符串

接受具有这些扩展名的受保护文件，从外部应用程序到您的应用程序。

选项

  • "any file"

  • "word documents"

  • "excel documents"

  • "powerpoint documents"

  • "any microsoft office documents"

  • "media files"

accept_unprotected_file_extensions

列表 / 元素=字符串

接受具有这些扩展名的不受保护的文件，从外部应用程序到您的应用程序。

选项

  • "any file"

  • "word documents"

  • "excel documents"

  • "powerpoint documents"

  • "any microsoft office documents"

  • "media files"

allow_copy_paste

布尔值

允许复制粘贴邮件内容。

选项

  • false

  • true

布尔值

允许从图库导入媒体。

选项

  • false

  • true

allow_taking_photos_and_videos

布尔值

允许从您的应用程序使用相机。

选项

  • false

  • true

allowed_domains_forward_attachment

字符串

排除允许发送附件的域，即使共享策略阻止共享这些类型的附件 - 只能包含英文字符、数字、逗号、空格和句点。

block_forward_attachments

布尔值

允许与外部邮件共享邮件附件。

选项

  • false

  • true

block_screenshot

布尔值

如果为真 - 您无法从您的应用程序截屏。

选项

  • false

  • true

offer_capsule_as_viewer

布尔值

提供 Capsule 作为外部受保护文档的查看器。

选项

  • false

  • true

open_extension_with_external_app

列表 / 元素=字符串

当Capsule查看器无法打开以下扩展程序时，请使用外部应用程序从您的应用程序中打开它们。

选项

  • "any file"

  • "word documents"

  • "excel documents"

  • "powerpoint documents"

  • "any microsoft office documents"

  • "media files"

share_protected_extension

列表 / 元素=字符串

将受保护的文件扩展名共享到外部应用程序。

选项

  • "any file"

  • "word documents"

  • "excel documents"

  • "powerpoint documents"

  • "any microsoft office documents"

  • "media files"

share_unprotected_extension

列表 / 元素=字符串

将不受保护的文件扩展名共享到外部应用程序。

选项

  • "any file"

  • "word documents"

  • "excel documents"

  • "powerpoint documents"

  • "any microsoft office documents"

  • "media files"

details_level

字符串

响应中某些字段的详细级别可以有所不同，从仅显示对象的UID值到对象的完整详细表示。

选项

  • "uid"

  • "standard"

  • "full"

domains_to_process

列表 / 元素=字符串

指示在哪些域上处理命令。它不能与details-level full一起使用，必须仅从系统域运行，并且ignore-warnings为true。有效值为CURRENT_DOMAIN、ALL_DOMAINS_ON_THIS_SERVER。

harmony_mobile

字典

集成设置。

compromised_behavior

字符串

设备配置 - 对恶意行为的响应（Harmony SDK的配置）。

选项

  • "block"

  • "notify"

  • "ignore"

enable_harmony_mobile_sdk

布尔值

启用/禁用Harmony SDK - 如果启用了Harmony Mobile应用程序，则无法启用。

选项

  • false

  • true

harmony_mobile_sdk_license

字符串

Harmony Mobile Sdk许可证（Harmony SDK的配置）- 只能包含英文字符、数字、逗号、空格和点。

malware_behavior

字符串

当应用程序被识别为恶意软件时的行为（Harmony SDK的配置）。

选项

  • "block"

  • "notify"

  • "ignore"

man_in_the_middle_attack

字符串

发生网络中间人攻击时的行为（Harmony SDK的配置）。

选项

  • "block"

  • "notify"

  • "ignore"

os_integrity_compromised

字符串

设备操作系统受损时的行为（Harmony SDK的配置）。

选项

  • "block"

  • "notify"

  • "ignore"

protect_high_risk_action

字符串

如果Harmony Mobile发现高风险，则采取什么措施。

选项

  • "none"

  • "wipe"

  • "block"

protect_high_risk_message

字符串

此消息只能包含英文字符、数字、逗号、空格和点。

protect_medium_risk_action

字符串

如果Harmony Mobile发现中度风险，则采取什么措施。

选项

  • "none"

  • "wipe"

  • "block"

protect_medium_risk_message

字符串

此消息只能包含英文字符、数字、逗号、空格和点。

protect_not_activated_action

字符串

如果存在策略违规，则采取什么措施（Harmony Mobile的配置）。

选项

  • "none"

  • "wipe"

  • "block"

protect_not_activated_message

字符串

此消息只能包含英文字符、数字、逗号、空格和点。

protect_policy_enabled

布尔值

启用/禁用保护应用程序-如果启用了Harmony SDK，则无法启用。

选项

  • false

  • true

suspicious_app

字符串

当应用程序被怀疑为恶意软件时的行为（Harmony SDK的配置）。

选项

  • "block"

  • "notify"

  • "ignore"

suspicious_enterprise_certificate

字符串

当安装允许从未知来源在设备上安装应用程序的证书配置文件时的行为 - 仅限iOS（Harmony SDK的配置）。

选项

  • "block"

  • "notify"

  • "ignore"

ignore_errors

布尔值

忽略错误应用更改。您将无法发布此类更改。如果忽略ignore-warnings标志，则警告也将被忽略。

选项

  • false

  • true

ignore_warnings

布尔值

忽略警告应用更改。

选项

  • false

  • true

name

字符串 / 必需

对象名称。

security

字典

安全设置。

activate_passcode_lock

布尔值

要求应用程序使用密码。

选项

  • false

  • true

allow_store_credentials

布尔值

允许在设备上存储凭据。

选项

  • false

  • true

block_3rd_party_keyboard

布尔值

阻止第三方键盘。

选项

  • false

  • true

block_jailbroken

字符串

检测越狱设备后的操作。

选项

  • "block"

  • "none"

hide_ssl_connect_anyway_button

布尔值

隐藏关键SSL信任失败时的连接按钮。

选项

  • false

  • true

passcode_profile

字符串

由名称或UID标识的密码策略对象。

report_jailbroken

布尔值

检测到设备越狱时发出日志。

选项

  • false

  • true

session_timeout

整数

会话超时 - 您可以在“session-timeout-unit”字段中选择一个单位（天、周、月）。

session_timeout_unit

字符串

“session-timeout”数值的单位。

选项

  • "weeks"

  • "days"

  • "hours"

  • "minutes"

state

字符串

访问规则的状态（存在或不存在）。

选项

  • "present" ← (默认)

  • "absent"

tags

列表 / 元素=字符串

标签标识符集合。

version

字符串

Checkpoint的版本。如果没有给出，则采用最新版本。

wait_for_task

布尔值

等待任务结束。例如发布任务。

选项

  • false

  • true ← (默认)

wait_for_task_timeout

整数

在抛出超时错误之前等待多少分钟。

默认： 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

字典

已创建或更新的Checkpoint对象。

返回：始终返回，除非删除对象。

作者

  • Eden Brillant (@chkp-edenbr)