fortios_firewall_ssl_server – Настройка SSL-серверов в Fortinet’s FortiOS и FortiGate

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

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

Описание

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

Требования

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

fortiosapi>=0.9.8

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
firewall_ssl_server словарь		Значение по умолчанию: null	Настройка SSL-серверов.
	add_header_x_forwarded_proto строка	Варианты: включить выключить	Включить/выключить добавление заголовка X-Forwarded-Proto в пересылаемые запросы.
	ip строка		IPv4-адрес SSL-сервера.
	mapped_port целое число		Порт серверной службы (1-65535).
	name строка / обязательно		Имя сервера.
	port целое число		Порт серверной службы (1-65535).
	ssl_algorithm строка	Варианты: высокий средний низкий	Относительная сила алгоритмов шифрования, принимаемых в ходе согласования.
	ssl_cert строка		Имя сертификата для SSL-соединений с этим сервером. Источник vpn.certificate.local.name.
	ssl_client_renegotiation строка	Варианты: разрешить запретить защищенный	Разрешить или заблокировать повторное согласование клиента сервером.
	ssl_dh_bits строка	Варианты: 768 1024 1536 2048	Размер в битах простого числа Диффи-Хеллмана (DH), используемого в согласовании DHE-RSA.
	ssl_max_version строка	Варианты: tls-1.0 tls-1.1 tls-1.2	Наивысшая версия SSL/TLS для согласования.
	ssl_min_version строка	Варианты: tls-1.0 tls-1.1 tls-1.2	Наименьшая версия SSL/TLS для согласования.
	ssl_mode строка	Варианты: половина полная	Режим SSL/TLS для шифрования и дешифрования трафика.
	ssl_send_empty_frags строка	Варианты: включить выключить	Включить/выключить отправку пустых фрагментов для предотвращения атаки на CBC IV.
	state строка	Варианты: существующий отсутствующий	Устаревший Начиная с Ansible 2.9, рекомендуется использовать параметр 'state' верхнего уровня. Указывает, нужно ли создать или удалить объект.
	url_rewrite строка	Варианты: включить выключить	Включить/выключить перенаправление URL.
host строка			IP-адрес FortiOS или FortiGate.
https логическое значение		Варианты: нет да ←	Указывает, должны ли запросы к FortiGate использовать протокол HTTPS.
password строка		Значение по умолчанию: ""	Пароль FortiOS или FortiGate.
ssl_verify логическое значение добавлено в 2.9		Варианты: нет да ←	Обеспечивает, что сертификат FortiGate должен быть проверен надлежащим ЦС.
state строка добавлено в 2.9		Варианты: существующий отсутствующий	Указывает, нужно ли создать или удалить объект. Этот атрибут уже присутствовал в предыдущей версии на более глубоком уровне. Он был перемещён на этот внешний уровень.
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"
   ssl_verify: "False"
  tasks:
  - name: Configure SSL servers.
    fortios_firewall_ssl_server:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      https: "False"
      state: "present"
      firewall_ssl_server:
        add_header_x_forwarded_proto: "enable"
        ip: "<your_own_value>"
        mapped_port: "5"
        name: "default_name_6"
        port: "7"
        ssl_algorithm: "high"
        ssl_cert: "<your_own_value> (source vpn.certificate.local.name)"
        ssl_client_renegotiation: "allow"
        ssl_dh_bits: "768"
        ssl_max_version: "tls-1.0"
        ssl_min_version: "tls-1.0"
        ssl_mode: "half"
        ssl_send_empty_frags: "enable"
        url_rewrite: "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 строка	всегда	Указание результата операции Пример: успешно
vdom строка	всегда	Используемый виртуальный домен Пример: root
version строка	всегда	Версия FortiGate Пример: v5.6.3

Статус

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

Авторы

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.9/modules/fortios_firewall_ssl_server_module.html