fortinet.fortios.fortios_dlp_fp_doc_source – Создание базы данных отпечатков DLP, разрешая FortiGate доступ к файловому серверу, содержащему файлы для создания отпечатков в Fortinet’s FortiOS и FortiGate.

Примечание

Этот плагин входит в коллекцию fortinet.fortios (версия 1.1.8).

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

Чтобы использовать его в книге задач, укажите: fortinet.fortios.fortios_dlp_fp_doc_source.

Новое в версии 2.8: fortinet.fortios

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

Обзор

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

Требования

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

ansible>=2.9.0

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
access_token строка			Аутентификация на основе токенов. Сгенерировано из графического интерфейса Fortigate.
dlp_fp_doc_source словарь			Создание базы данных отпечатков DLP, разрешая FortiGate доступ к файловому серверу, содержащему файлы для создания отпечатков.
	date целое число		День месяца, в который следует сканировать сервер (1 - 31).
	file_path строка		Путь на сервере к файлам отпечатков (максимум 119 символов).
	file_pattern строка		Файлы, соответствующие этому шаблону на сервере, будут проиндексированы. Допускается использование символов * и ?.
	keep_modified строка	Варианты: enable disable	Включить, чтобы при изменении файла на сервере FortiGate сохранял старый отпечаток и добавлял новый отпечаток в базу данных.
	name строка / обязательно		Имя базы данных отпечатков DLP.
	password строка		Пароль, необходимый для входа в файловый сервер.
	period строка	Варианты: none daily weekly monthly	Частота, с которой FortiGate проверяет сервер на наличие новых или измененных файлов.
	remove_deleted строка	Варианты: enable disable	Включить, чтобы база данных отпечатков оставалась актуальной при удалении файла с сервера.
	scan_on_creation строка	Варианты: enable disable	Включить, чтобы база данных отпечатков оставалась актуальной при добавлении или изменении файла на сервере.
	scan_subdirectories строка	Варианты: enable disable	Включить/выключить сканирование подкаталогов для поиска файлов для создания отпечатков.
	sensitivity строка		Выберите чувствительность или уровень угрозы для совпадений с этой базой данных отпечатков. Добавьте уровни чувствительности, используя fp-sensitivity. Источник dlp .fp-sensitivity.name.
	server строка		IP-адрес сервера (IPv4 или IPv6).
	server_type строка	Варианты: samba	Протокол, используемый для связи с файловым сервером. В настоящее время поддерживаются только серверы Samba (SMB).
	state строка	Варианты: present absent	Устарело Начиная с Ansible 2.9, рекомендуется использовать параметр 'state' верхнего уровня. Указывает, нужно ли создавать или удалять объект.
	tod_hour целое число		Час дня, в который следует сканировать сервер (0 - 23).
	tod_min целое число		Минута часа, в который следует сканировать сервер (0 - 59).
	username строка		Имя пользователя, необходимое для входа в файловый сервер.
	vdom строка	Варианты: mgmt current	Выберите VDOM, который может взаимодействовать с файловым сервером.
	weekday строка	Варианты: воскресенье понедельник вторник среда четверг пятница суббота	День недели, в который следует сканировать сервер.
state строка добавлен в 2.9 fortinet.fortios		Варианты: present absent	Указывает, нужно ли создавать или удалять объект. Этот атрибут уже присутствовал в предыдущих версиях на более глубоком уровне. Он был перенесен на этот внешний уровень.
vdom строка		Значение по умолчанию: "root"	Виртуальная область, среди предварительно определенных. VDOM — это виртуальная инстанция FortiGate, которую можно настроить и использовать как отдельное устройство.

Примечания

Примечание

Устаревший fortiosapi устарел, httpapi — предпочтительный способ запуска книг задач

Примеры

- hosts: fortigates
  collections:
    - fortinet.fortios
  connection: httpapi
  vars:
   vdom: "root"
   ansible_httpapi_use_ssl: yes
   ansible_httpapi_validate_certs: no
   ansible_httpapi_port: 443
  tasks:
  - name: Create a DLP fingerprint database by allowing the FortiGate to access a file server containing files from which to create fingerprints.
    fortios_dlp_fp_doc_source:
      vdom:  "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      dlp_fp_doc_source:
        date: "3"
        file_path: "<your_own_value>"
        file_pattern: "<your_own_value>"
        keep_modified: "enable"
        name: "default_name_7"
        password: "<your_own_value>"
        period: "none"
        remove_deleted: "enable"
        scan_on_creation: "enable"
        scan_subdirectories: "enable"
        sensitivity: "<your_own_value> (source dlp.fp-sensitivity.name)"
        server: "192.168.100.40"
        server_type: "samba"
        tod_hour: "16"
        tod_min: "17"
        username: "<your_own_value>"
        vdom: "mgmt"
        weekday: "sunday"

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

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

Ключ	Возвращаемое значение	Описание
build строка	всегда	Номер сборки образа fortigate Пример: 1547
http_method строка	всегда	Последний метод, использованный для подготовки контента в FortiGate Пример: PUT
http_status строка	всегда	Последний результат, предоставленный FortiGate после последней операции Пример: 200
mkey строка	успех	Главный ключ (id), использованный в последнем вызове FortiGate Пример: id
name строка	всегда	Имя таблицы, использованной для выполнения запроса Пример: urlfilter
path строка	всегда	Путь таблицы, использованной для выполнения запроса Пример: webfilter
revision строка	всегда	Внутренний номер версии Пример: 17.0.2.10658
serial строка	всегда	Серийный номер устройства Пример: FGVMEVYYQT3AB5352
status строка	всегда	Указание результата операции Пример: успех
vdom строка	всегда	Использованная виртуальная область Пример: root
version строка	всегда	Версия 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/fortinet/fortios/fortios_dlp_fp_doc_source_module.html