fortinet.fortimanager.fmgr_application_list – Настройка списков управления приложениями.

Примечание

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

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

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

В версии 2.10: модуля fortinet.fortimanager

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

Обзор

Этот модуль позволяет настроить устройство FortiManager, позволяя пользователю [ добавить получить установить обновить ] следующие API.
/pm/config/adom/{adom}/obj/application/list
/pm/config/global/obj/application/list
Примеры включают все параметры и значения, которые необходимо настроить для использования.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
loose_validation boolean	Варианты: no yes	Проверка параметров в свободном режиме
method строка / обязательно	Варианты: add get set update	Метод запроса
params список / элементы=строка		Параметры для каждого метода Полный список параметров см. в https://ansible-galaxy-fortimanager-docs.readthedocs.io/en/latest
url_params словарь		Параметры для URL каждого API-запроса Полный список параметров URL также см. в https://ansible-galaxy-fortimanager-docs.readthedocs.io/en/latest
workspace_locking_adom строка		Имя домена для блокировки в случае работы FortiManager в режиме рабочей области Это может быть глобальный или любое другое имя настраиваемого домена
workspace_locking_timeout целое число	Значение по умолчанию: 300	Максимальное время ожидания (в секундах), пока другой пользователь не разблокирует рабочую область

Примечания

Примечание

Существует только три параметра верхнего уровня, где ‘method’ всегда требуется, а два других параметра ‘params’ и ‘url_params’ могут быть необязательными
Из-за сложности схемы API fortimanager проверка выполняется вне процедуры проверки параметров Ansible.
Синтаксис OPTIONS не соответствует стандартной спецификации аргументов Ansible, но, учитывая структуру схемы API fortimanager, нам требуется тривиальное преобразование при заполнении книги задач ansible

Примеры

- hosts: fortimanager-inventory
  collections:
    - fortinet.fortimanager
  connection: httpapi
  vars:
     ansible_httpapi_use_ssl: True
     ansible_httpapi_validate_certs: False
     ansible_httpapi_port: 443
  tasks:

   - name: REQUESTING /PM/CONFIG/OBJ/APPLICATION/LIST
     fmgr_application_list:
        loose_validation: False
        workspace_locking_adom: <value in [global, custom adom]>
        workspace_locking_timeout: 300
        method: <value in [add, set, update]>
        url_params:
           adom: <value in [none, global, custom dom]>
        params:
           -
              data:
                -
                    app-replacemsg: <value in [disable, enable]>
                    comment: <value of string>
                    deep-app-inspection: <value in [disable, enable]>
                    entries:
                      -
                          action: <value in [pass, block, reset]>
                          application:
                            - <value of integer>
                          behavior:
                            - <value of string>
                          category: <value of string>
                          id: <value of integer>
                          log: <value in [disable, enable]>
                          log-packet: <value in [disable, enable]>
                          parameters:
                            -
                                id: <value of integer>
                                value: <value of string>
                          per-ip-shaper: <value of string>
                          popularity:
                            - <value in [1, 2, 3, ...]>
                          protocols:
                            - <value of string>
                          quarantine: <value in [none, attacker]>
                          quarantine-expiry: <value of string>
                          quarantine-log: <value in [disable, enable]>
                          rate-count: <value of integer>
                          rate-duration: <value of integer>
                          rate-mode: <value in [periodical, continuous]>
                          rate-track: <value in [none, src-ip, dest-ip, ...]>
                          risk:
                            - <value of integer>
                          session-ttl: <value of integer>
                          shaper: <value of string>
                          shaper-reverse: <value of string>
                          sub-category:
                            - <value of integer>
                          technology:
                            - <value of string>
                          vendor:
                            - <value of string>
                    extended-log: <value in [disable, enable]>
                    name: <value of string>
                    options:
                      - <value in [allow-dns, allow-icmp, allow-http, ...]>
                    other-application-action: <value in [pass, block]>
                    other-application-log: <value in [disable, enable]>
                    p2p-black-list:
                      - <value in [skype, edonkey, bittorrent]>
                    replacemsg-group: <value of string>
                    unknown-application-action: <value in [pass, block]>
                    unknown-application-log: <value in [disable, enable]>

   - name: REQUESTING /PM/CONFIG/OBJ/APPLICATION/LIST
     fmgr_application_list:
        loose_validation: False
        workspace_locking_adom: <value in [global, custom adom]>
        workspace_locking_timeout: 300
        method: <value in [get]>
        url_params:
           adom: <value in [none, global, custom dom]>
        params:
           -
              attr: <value of string>
              fields:
                -
                   - <value in [app-replacemsg, comment, deep-app-inspection, ...]>
              filter:
                - <value of string>
              get used: <value of integer>
              loadsub: <value of integer>
              option: <value in [count, object member, datasrc, ...]>
              range:
                - <value of integer>
              sortings:
                -
                    varidic.attr_name: <value in [1, -1]>

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

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

Ключ	Возвращаемое значение	Описание
data словарь	всегда	Полезная нагрузка, возвращенная в запросе
status словарь	всегда	Статус запроса API
url строка	всегда	Полный запрашиваемый URL Пример: /sys/login/user

Авторы

Frank Shen (@fshen01)
Link Zheng (@zhengl)

© 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/fortimanager/fmgr_application_list_module.html