fortinet.fortios.fortios_system_dns модуль – Настройка DNS в FortiOS и FortiGate Fortinet.

Примечание

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

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

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

Для использования в книге задач укажите: fortinet.fortios.fortios_system_dns.

Новая в fortinet.fortios 2.0.0

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

Описание

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

Требования

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

ansible>=2.15

Параметры

Параметр	Комментарии
access_token строка	Аутентификация на основе токена. Сгенерировано в графическом интерфейсе Fortigate.
enable_log логический	Включить/выключить протоколирование для задачи. Выбираемые значения: `false` ← (по умолчанию) `true`
member_path строка	Путь к атрибуту элемента для обработки. Разделяется слешем, если атрибутов несколько. Параметр, помеченный member_path, подходит для операций с элементами.
member_state строка	Добавить или удалить элемент по указанному пути атрибута. При указании member_state параметр state игнорируется. Выбираемые значения: `"present"` `"absent"`
system_dns словарь	Настройка DNS.
alt_primary строка	Альтернативный первичный DNS-сервер. Не используется как резервный DNS-сервер.
alt_secondary строка	Альтернативный вторичный DNS-сервер. Не используется как резервный DNS-сервер.
cache_notfound_responses строка	Включить/выключить ответ от DNS-сервера, когда запись отсутствует в кэше. Выбираемые значения: `"disable"` `"enable"`
dns_cache_limit целое число	Максимальное количество записей в кэше DNS.
dns_cache_ttl целое число	Время хранения информации в кэше DNS в секундах.
dns_over_tls строка	Включить/выключить/принудительно включить DNS через TLS. Выбираемые значения: `"disable"` `"enable"` `"enforce"`
domain список / элементы=словарь	Список суффиксов поиска для имени хоста.
domain строка / обязательно	Список доменов поиска DNS, разделенных пробелами (максимум 8 доменов).
fqdn_cache_ttl целое число	Время жизни кэша FQDN в секундах (0 — 86400).
fqdn_max_refresh целое число	Максимальное время обновления кэша FQDN в секундах (3600 — 86400).
fqdn_min_refresh целое число	Минимальное время обновления кэша FQDN в секундах (10 — 3600).
interface строка	Укажите интерфейс для выхода к серверу. Имя интерфейса системы.
interface_select_method строка	Укажите, как выбрать исходящий интерфейс для доступа к серверу. Выбираемые значения: `"auto"` `"sdwan"` `"specify"`
ip6_primary строка	IP-адрес первичного DNS-сервера IPv6.
ip6_secondary строка	IP-адрес вторичного DNS-сервера IPv6.
log строка	Настройка локального журнала DNS. Выбираемые значения: `"disable"` `"error"` `"all"`
primary строка	IP-адрес первичного DNS-сервера.

protocol список / элементы=строка	Протоколы передачи DNS. Варианты: `"cleartext"` `"dot"` `"doh"`
retry целое число	Количество попыток повторного подключения (0 - 5).
secondary строка	IP-адрес вторичного DNS-сервера.
server_hostname список / элементы=словарь	Список имен хостов DNS-серверов.
hostname строка / обязательно	Список имен хостов DNS-серверов, разделенных пробелами (максимум 4 домена).
server_select_method строка	Укажите, как упорядочивать настроенные серверы по приоритету. Варианты: `"least-rtt"` `"failover"`
source_ip строка	IP-адрес, используемый DNS-сервером в качестве своего IP-адреса источника.
ssl_certificate строка	Имя локального сертификата для SSL-соединений. Имя локального сертификата.local.name.
timeout целое число	Интервал ожидания запроса DNS в секундах (1 - 10).
vdom строка	Виртуальная область, определённая ранее. VDOM — это виртуальная инстанция FortiGate, которая может быть настроена и использоваться как отдельное устройство. По умолчанию: `"root"`

Примечания

Примечание

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

Примеры

- name: Configure DNS.
  fortinet.fortios.fortios_system_dns:
      vdom: "{{ vdom }}"
      system_dns:
          alt_primary: "<your_own_value>"
          alt_secondary: "<your_own_value>"
          cache_notfound_responses: "disable"
          dns_cache_limit: "5000"
          dns_cache_ttl: "1800"
          dns_over_tls: "disable"
          domain:
              -
                  domain: "<your_own_value>"
          fqdn_cache_ttl: "0"
          fqdn_max_refresh: "3600"
          fqdn_min_refresh: "60"
          interface: "<your_own_value> (source system.interface.name)"
          interface_select_method: "auto"
          ip6_primary: "<your_own_value>"
          ip6_secondary: "<your_own_value>"
          log: "disable"
          primary: "<your_own_value>"
          protocol: "cleartext"
          retry: "2"
          secondary: "<your_own_value>"
          server_hostname:
              -
                  hostname: "myhostname"
          server_select_method: "least-rtt"
          source_ip: "84.230.14.43"
          ssl_certificate: "<your_own_value> (source certificate.local.name)"
          timeout: "5"

Значения возврата

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

Ключ	Описание
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"`

Авторы

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_system_dns_module.html