Spec-Zone.ru › Ansible

Модуль fortinet.fortios.fortios_system_ddns – Настройка DDNS в Fortinet’s FortiOS и FortiGate.

Примечание

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

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

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

Для использования в playbook, укажите: fortinet.fortios.fortios_system_ddns.

Новое в fortinet.fortios 2.0.0

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

Краткое описание

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

Требования

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

  • ansible>=2.15

Параметры

Параметр

Комментарии

access_token

string

Токенная аутентификация. Создается в графическом интерфейсе Fortigate.

enable_log

boolean

Включить/Выключить логирование для задачи.

Варианты:

  • false ← (default)
  • true

member_path

string

Путь к атрибуту члена для выполнения операции.

Разделяется символом слеша, если атрибутов более одного.

Параметр, отмеченный как member_path, является допустимым для выполнения операции с членом.

member_state

string

Добавить или удалить члена по указанному пути к атрибуту.

При указании member_state параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

state

string / required

Указывает, следует ли создать или удалить объект.

Варианты:

  • "present"
  • "absent"

system_ddns

dictionary

Настроить DDNS.

addr_type

string

Тип адреса интерфейса в обновлении DDNS.

Варианты:

  • "ipv4"
  • "ipv6"

bound_ip

string

Привязанный IP-адрес.

clear_text

string

Включить/выключить использование соединений с открытым текстом.

Варианты:

  • "disable"
  • "enable"

ddns_auth

string

Включить/выключить аутентификацию TSIG для вашего сервера DDNS.

Варианты:

  • "disable"
  • "tsig"

ddns_domain

string

Ваше полное доменное имя. Например, yourname.ddns.com.

ddns_key

string

Ключ обновления DDNS (кодировка base 64).

ddns_keyname

string

Имя ключа обновления DDNS.

ddns_password

string

Пароль DDNS.

ddns_server

string

Выберите поставщика услуг DDNS.

Варианты:

  • "dyndns.org"
  • "dyns.net"
  • "tzo.com"
  • "vavic.com"
  • "dipdns.net"
  • "now.net.cn"
  • "dhs.org"
  • "easydns.com"
  • "genericDDNS"
  • "FortiGuardDDNS"
  • "noip.com"

ddns_server_addr

list / elements=dictionary

Список IP-адресов/полных доменных имен универсальных серверов DDNS.

addr

string / required

IP-адрес или полное доменное имя сервера.

ddns_server_ip

string

IP-адрес универсального сервера DDNS.

ddns_sn

string

Серийный номер DDNS.

ddns_ttl

integer

Время жизни пакетов DDNS.

ddns_username

string

Имя пользователя DDNS.

ddns_zone

string

Зона вашего доменного имени (например, DDNS.com).

ddnsid

integer / required

ID DDNS. см. <a href=’#notes’>Примечания</a>.

monitor_interface

list / elements=dictionary

Мониторируемый интерфейс.

interface_name

string / required

Имя интерфейса. Источник system.interface.name.

server_type

string

Тип адреса сервера DDNS.

Choices:

  • "ipv4"
  • "ipv6"

ssl_certificate

string

Имя локального сертификата для SSL-соединений. Источник certificate.local.name.

update_interval

integer

Интервал обновления DDNS (60 - 2592000 сек, 0 означает значение по умолчанию).

use_public_ip

string

Включить/отключить использование публичного IP-адреса.

Choices:

  • "disable"
  • "enable"

vdom

string

Виртуальный домен, среди ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

Default: "root"

Примечания

Примечание

  • Мы настоятельно рекомендуем использовать собственное значение в качестве ddnsid вместо 0. Хотя «0» — это специальный заполнитель, позволяющий бэкенду назначать последний доступный номер для объекта, он имеет ограничения. Более подробную информацию см. в разделе «Вопросы и ответы».
  • Устаревший fortiosapi был заменен, httpapi — предпочтительный способ запуска playbook.
  • Модуль поддерживает check_mode.

Примеры

- name: Configure DDNS.
  fortinet.fortios.fortios_system_ddns:
      vdom: "{{ vdom }}"
      state: "present"
      access_token: "<your_own_value>"
      system_ddns:
          addr_type: "ipv4"
          bound_ip: "<your_own_value>"
          clear_text: "disable"
          ddns_auth: "disable"
          ddns_domain: "<your_own_value>"
          ddns_key: "<your_own_value>"
          ddns_keyname: "<your_own_value>"
          ddns_password: "<your_own_value>"
          ddns_server: "dyndns.org"
          ddns_server_addr:
              -
                  addr: "<your_own_value>"
          ddns_server_ip: "<your_own_value>"
          ddns_sn: "<your_own_value>"
          ddns_ttl: "300"
          ddns_username: "<your_own_value>"
          ddns_zone: "<your_own_value>"
          ddnsid: "<you_own_value>"
          monitor_interface:
              -
                  interface_name: "<your_own_value> (source system.interface.name)"
          server_type: "ipv4"
          ssl_certificate: "<your_own_value> (source certificate.local.name)"
          update_interval: "300"
          use_public_ip: "disable"

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

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

Ключ

Описание

build

string

Номер сборки образа FortiGate

Возвращается: всегда

Пример: "1547"

http_method

string

Последний метод, использованный для подготовки контента в FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

string

Последний результат, полученный от FortiGate при последней выполненной операции

Возвращается: всегда

Пример: "200"

mkey

string

Главный ключ (id), использованный в последнем вызове FortiGate

Возвращается: успех

Пример: "id"

name

string

Имя таблицы, использованной для выполнения запроса

Возвращается: всегда

Пример: "urlfilter"

path

string

Путь к таблице, использованной для выполнения запроса

Возвращается: всегда

Пример: "webfilter"

revision

string

Внутренний номер ревизии

Возвращается: всегда

Пример: "17.0.2.10658"

serial

string

Серийный номер устройства

Возвращается: всегда

Пример: "FGVMEVYYQT3AB5352"

status

string

Указание результата операции

Возвращается: всегда

Пример: "success"

vdom

string

Используемый виртуальный домен

Возвращается: всегда

Пример: "root"

version

string

Версия 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_ddns_module.html

Spec-Zone.ru

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