Spec-Zone.ru › Ansible 2.8

fortios_firewall_proxy_address – Настройка адреса веб-прокси в Fortinet FortiOS и FortiGate

Новая в версии 2.8.

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

Обзор

  • Этот модуль позволяет настроить FortiGate или FortiOS, предоставив пользователю возможность настроить функцию брандмауэра и категорию proxy_address. Примеры включают все опции и должны быть адаптированы к источникам данных перед использованием. Тестировался с FOS v6.0.2

Требования

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

  • fortiosapi>=0.9.8

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
firewall_proxy_address
-
По умолчанию:
null
Настройка адреса веб-прокси.
case-sensitivity
-
    Варианты:
  • disable
  • enable
Включить для чувствительности к регистру в шаблоне.
category
-
Идентификатор категории FortiGuard.
id
- / обязательно
Идентификатор категории Fortiguard.
color
-
Целочисленное значение для определения цвета значка в графическом интерфейсе (1 - 32, по умолчанию 0, что устанавливает значение в 1).
comment
-
Дополнительные комментарии.
header
-
Имя HTTP-заголовка в виде регулярного выражения.
header-group
-
Группа HTTP-заголовков.
case-sensitivity
-
    Варианты:
  • disable
  • enable
Чувствительность к регистру в шаблоне.
header
-
Регулярное выражение HTTP-заголовка.
header-name
-
HTTP-заголовок.
id
- / обязательно
Идентификатор.
header-name
-
Имя HTTP-заголовка.
host
-
Объект адреса для хоста. Источник firewall.address.name firewall.addrgrp.name firewall.proxy-address.name.
host-regex
-
Имя хоста в виде регулярного выражения.
method
-
    Варианты:
  • get
  • post
  • put
  • head
  • connect
  • trace
  • options
  • delete
HTTP-методы запросов, которые будут использоваться.
name
- / обязательно
Имя адреса.
path
-
Путь URL в виде регулярного выражения.
query
-
Сопоставление части запроса URL в виде регулярного выражения.
referrer
-
    Варианты:
  • enable
  • disable
Включить/отключить использование поля referrer в HTTP-заголовке для сопоставления адреса.
state
-
    Варианты:
  • present
  • absent
Указывает, нужно ли создать или удалить объект.
tagging
-
Тегирование конфигурационного объекта.
category
-
Категория тега. Источник system.object-tagging.category.
name
- / обязательно
Имя записи тега.
tags
-
Теги.
name
- / обязательно
Имя тега. Источник system.object-tagging.tags.name.
type
-
    Варианты:
  • host-regex
  • url
  • category
  • method
  • ua
  • header
  • src-advanced
  • dst-advanced
Тип адреса прокси.
ua
-
    Варианты:
  • chrome
  • ms
  • firefox
  • safari
  • other
Названия браузеров, которые будут использоваться в качестве user agent.
uuid
-
Универсальный уникальный идентификатор (UUID; автоматически назначается, но может быть вручную сброшен).
visibility
-
    Варианты:
  • enable
  • disable
Включить/выключить видимость объекта в графическом интерфейсе.
host
- / обязательно
IP-адрес FortiOS или FortiGate.
https
boolean
    Варианты:
  • no
  • да ←
Указывает, должны ли запросы к FortiGate использовать протокол HTTPS.
password
-
По умолчанию:
""
Пароль FortiOS или FortiGate.
username
- / обязательно
Имя пользователя FortiOS или FortiGate.
vdom
-
По умолчанию:
"root"
Виртуальная область, среди тех, которые были определены ранее. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельный блок.

Примечания

Примечание

  • Требуется библиотека fortiosapi, разработанная Fortinet
  • Выполнять как local_action в вашем playbook

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
  tasks:
  - name: Web proxy address configuration.
    fortios_firewall_proxy_address:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      https: "False"
      firewall_proxy_address:
        state: "present"
        case-sensitivity: "disable"
        category:
         -
            id:  "5"
        color: "6"
        comment: "Optional comments."
        header: "<your_own_value>"
        header-group:
         -
            case-sensitivity: "disable"
            header: "<your_own_value>"
            header-name: "<your_own_value>"
            id:  "13"
        header-name: "<your_own_value>"
        host: "myhostname (source firewall.address.name firewall.addrgrp.name firewall.proxy-address.name)"
        host-regex: "myhostname"
        method: "get"
        name: "default_name_18"
        path: "<your_own_value>"
        query: "<your_own_value>"
        referrer: "enable"
        tagging:
         -
            category: "<your_own_value> (source system.object-tagging.category)"
            name: "default_name_24"
            tags:
             -
                name: "default_name_26 (source system.object-tagging.tags.name)"
        type: "host-regex"
        ua: "chrome"
        uuid: "<your_own_value>"
        visibility: "enable"

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

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

Ключ Возвращается Описание
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
строка
всегда
Указание результата операции

Пример:
success
vdom
строка
всегда
Используемый виртуальный домен

Пример:
root
version
строка
всегда
Версия FortiGate

Пример:
v5.6.3


Статус

  • Этот модуль не гарантирует обратную совместимость. [превью]
  • Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

  • 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.8/modules/fortios_firewall_proxy_address_module.html

Spec-Zone.ru

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