Spec-Zone.ru › Ansible

Модуль fortinet.fortios.fortios_dlp_sensor – Настройка датчиков, используемых для блокировки DLP в FortiOS и FortiGate Fortinet.

Примечание

Этот модуль является частью коллекции fortinet.fortios (версия 2.3.7).

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

Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в плейбуке укажите: fortinet.fortios.fortios_dlp_sensor.

Добавлен в fortinet.fortios 2.0.0

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Описание

  • Этот модуль позволяет настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю устанавливать и изменять категорию функций и датчиков DLP. В примерах нужно будет настроить все параметры и значения источников данных перед использованием. Тестировался с FOS v6.0.0

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • ansible>=2.15
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

access_token

string

Токенная аутентификация. Создается в GUI Fortigate.

dlp_sensor

dictionary

Настройка датчиков, используемых блокировкой DLP.

comment

string

Дополнительные комментарии.

dlp_log

string

Включить/отключить ведение журнала DLP.

Варианты:

  • "enable"
  • "disable"

entries

list / elements=dictionary

Записи датчика DLP.

count

integer

Количество совпадений словаря для срабатывания записи датчика (словарь может срабатывать не более одного раза в зависимости от его параметра "repeat", 1 - 255).

dictionary

string

Выберите словарь DLP или точное соответствие данных. Источник dlp.dictionary.name dlp.exact-data-match.name.

id

integer / required

ID. см. <a href=’#notes’>Примечания</a>.

status

string

Включить/отключить эту запись.

Варианты:

  • "enable"
  • "disable"

eval

string

Выражение для вычисления.

extended_log

string

Включить/отключить расширенное ведение журнала для предотвращения утечки данных.

Варианты:

  • "enable"
  • "disable"

feature_set

string

Набор функций потока/прокси.

Варианты:

  • "flow"
  • "proxy"

filter

list / elements=dictionary

Настройте фильтры DLP для этого датчика.

action

string

Действие, выполняемое с содержимым, соответствующим этому датчику DLP.

Варианты:

  • "allow"
  • "log-only"
  • "block"
  • "quarantine-ip"

archive

string

Включить/отключить архивирование DLP.

Варианты:

  • "disable"
  • "enable"

company_identifier

string

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

expiry

string

Продолжительность карантина в днях, часах, минутах (формат = dddhhmm).

file_size

integer

Сопоставление файлов этого размера или больше (0 - 4294967295 Кбайт).

file_type

integer

Выберите номер таблицы шаблонов файлов DLP для сопоставления. Источник dlp.filepattern.id.

filter_by

string

Выберите тип содержимого для сопоставления.

Варианты:

  • "credit-card"
  • "ssn"
  • "regexp"
  • "file-type"
  • "file-size"
  • "fingerprint"
  • "watermark"
  • "encrypted"

fp_sensitivity

list / elements=dictionary

Выберите чувствительность шаблона файла DLP для сопоставления.

name

string / required

Выберите чувствительность DLP. Источник dlp.fp-sensitivity.name.

id

integer / required

Идентификатор. См. <a href=’#notes’>Примечания</a>.

match_percentage

integer

Процент совпадений отпечатков пальцев в базах отпечатков пальцев, назначенных с выбранной чувствительностью.

name

string

Имя фильтра.

proto

list / elements=string

Проверка сообщений или файлов по одному или нескольким из этих протоколов.

Варианты:

  • "smtp"
  • "pop3"
  • "imap"
  • "http-get"
  • "http-post"
  • "ftp"
  • "nntp"
  • "mapi"
  • "ssh"
  • "cifs"
  • "mm1"
  • "mm3"
  • "mm4"
  • "mm7"

regexp

string

Введите регулярное выражение для сопоставления (макс. 255 символов).

sensitivity

list / elements=dictionary

Выберите чувствительность шаблона файла DLP для сопоставления.

name

string / required

Выберите чувствительность DLP. Источник dlp.sensitivity.name.

severity

string

Выберите уровень серьезности или угрозы, соответствующий этому фильтру.

Варианты:

  • "info"
  • "low"
  • "medium"
  • "high"
  • "critical"

type

string

Выберите, следует ли проверять содержимое сообщений (сообщение электронной почты) или файлов (загруженные файлы или вложения электронной почты).

Варианты:

  • "file"
  • "fos_message"

flow_based

string

Включить/отключить DLP на основе потоков.

Варианты:

  • "enable"
  • "disable"

full_archive_proto

list / elements=string

Протоколы для всегда архивирования содержимого.

Варианты:

  • "smtp"
  • "pop3"
  • "imap"
  • "http-get"
  • "http-post"
  • "ftp"
  • "nntp"
  • "mapi"
  • "ssh"
  • "cifs"
  • "mm1"
  • "mm3"
  • "mm4"
  • "mm7"

match_type

string

Логическое отношение между записями.

Варианты:

  • "match-all"
  • "match-any"
  • "match-eval"

nac_quar_log

string

Включить/отключить ведение журнала карантина NAC.

Варианты:

  • "enable"
  • "disable"

name

string / required

Имя таблицы, содержащей датчик.

options

string

Настроить параметры DLP.

replacemsg_group

string

Группа сообщений замены, используемая этим датчиком DLP. Источник system.replacemsg-group.name.

summary_proto

list / elements=string

Протоколы для всегда ведения журнала сводки.

Варианты:

  • "smtp"
  • "pop3"
  • "imap"
  • "http-get"
  • "http-post"
  • "ftp"
  • "nntp"
  • "mapi"
  • "ssh"
  • "cifs"
  • "mm1"
  • "mm3"
  • "mm4"
  • "mm7"

enable_log

boolean

Включить/отключить ведение журнала для задачи.

Варианты:

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

member_path

string

Путь к атрибуту члена, с которым нужно работать.

Разделяется символом слеша, если атрибутов более одного.

Параметр, помеченный как member_path, является допустимым для выполнения операции с членом.

member_state

string

Добавить или удалить члена по указанному пути к атрибуту.

При указании member_state параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

state

string / required

Указывает, следует ли создать или удалить объект.

Варианты:

  • "present"
  • "absent"

vdom

string

Виртуальный домен, среди тех, которые были определены ранее. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельный блок.

Значение по умолчанию: "root"

Примечания

Примечание

  • Устаревшее fortiosapi было признано устаревшим, httpapi является предпочтительным способом запуска playbooks
  • Модуль поддерживает check_mode.

Примеры

- name: Configure sensors used by DLP blocking.
  fortinet.fortios.fortios_dlp_sensor:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      dlp_sensor:
          comment: "Optional comments."
          dlp_log: "enable"
          entries:
              -
                  count: "1"
                  dictionary: "<your_own_value> (source dlp.dictionary.name dlp.exact-data-match.name)"
                  id: "8"
                  status: "enable"
          eval: "<your_own_value>"
          extended_log: "enable"
          feature_set: "flow"
          filter:
              -
                  action: "allow"
                  archive: "disable"
                  company_identifier: "myId_16"
                  expiry: "<your_own_value>"
                  file_size: "10"
                  file_type: "0"
                  filter_by: "credit-card"
                  fp_sensitivity:
                      -
                          name: "default_name_22 (source dlp.fp-sensitivity.name)"
                  id: "23"
                  match_percentage: "10"
                  name: "default_name_25"
                  proto: "smtp"
                  regexp: "<your_own_value>"
                  sensitivity:
                      -
                          name: "default_name_29 (source dlp.sensitivity.name)"
                  severity: "info"
                  type: "file"
          flow_based: "enable"
          full_archive_proto: "smtp"
          match_type: "match-all"
          nac_quar_log: "enable"
          name: "default_name_36"
          options: "<your_own_value>"
          replacemsg_group: "<your_own_value> (source system.replacemsg-group.name)"
          summary_proto: "smtp"

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

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

Ключ

Описание

build

string

Номер сборки образа fortigate

Возвращается: всегда

Пример: "1547"

http_method

string

Последний метод, использованный для размещения содержимого в FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

string

Последний результат, полученный от FortiGate при последней применённой операции

Возвращается: всегда

Пример: "200"

mkey

string

Главный ключ (идентификатор), использованный в последнем вызове FortiGate

Возвращается: при успехе

Пример: "id"

name

string

Имя таблицы, использованной для выполнения запроса

Возвращается: всегда

Пример: "urlfilter"

path

string

Путь к таблице, использованной для выполнения запроса

Возвращается: всегда

Пример: "webfilter"

revision

string

Внутренний номер ревизии

Возвращается: всегда

Пример: "17.0.2.10658"

serial

string

Серийный номер устройства

Возвращается: всегда

Пример: "FGVMEVYYQT3AB5352"

status

string

Указание результата операции

Возвращается: всегда

Пример: "success"

vdom

string

Использованный виртуальный домен

Возвращается: всегда

Пример: "root"

version

string

Версия FortiGate

Возвращается: всегда

Пример: "v5.6.3"

Авторы

  • Link Zheng (@chillancezen)
  • Jie Xue (@JieX19)
  • Hongbin Lu (@fgtdev-hblu)
  • Frank Shen (@frankshen01)
  • Miguel Angel Munoz (@mamunozgonzalez)
  • Nicolas Thomas (@thomnico)

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

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

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/fortinet/fortios/fortios_dlp_sensor_module.html

Spec-Zone.ru

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