Модуль fortinet.fortios.fortios_system_dhcp_server — настройка DHCP-серверов в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_system_dhcp_server.
Добавлено в fortinet.fortios 2.0.0
Обзор
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя функцию system_dhcp и категорию server. В примерах приведены все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено с FOS v6.0.0
Требования
На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Создаётся в графическом интерфейсе Fortigate. |
enable_log boolean | Включить/отключить ведение журнала для задачи. Варианты:
|
member_path string | Путь к атрибуту элемента, над которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр с пометкой member_path можно использовать для выполнения операции с элементом. |
member_state string | Добавить или удалить элемент по указанному пути к атрибуту. Если задан member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
system_dhcp_server dictionary | Настройка DHCP-серверов. |
|
auto_configuration string |
Включить/отключить автоматическую настройку. Варианты:
|
|
auto_managed_status string |
Включить/отключить использование этого DHCP-сервера после назначения IP-адреса этому интерфейсу из FortiIPAM. Варианты:
|
|
conflicted_ip_timeout integer |
Время в секундах, в течение которого нужно ждать после удаления конфликтующего IP-адреса из диапазона DHCP, прежде чем его можно будет использовать повторно. |
|
ddns_auth string |
Режим аутентификации DDNS. Варианты:
|
|
ddns_key string |
Ключ обновления DDNS (кодировка Base64). |
|
ddns_keyname string |
Имя ключа обновления DDNS. |
|
ddns_server_ip string |
IP-адрес сервера DDNS. |
|
ddns_ttl integer |
TTL. |
|
ddns_update string |
Включить/отключить обновление DDNS для DHCP. Варианты:
|
|
ddns_update_override string |
Включить/отключить переопределение обновления DDNS для DHCP. Варианты:
|
|
ddns_zone string |
Зона доменного имени (например, DDNS.com). |
|
default_gateway string |
IP-адрес шлюза по умолчанию, назначаемый DHCP-сервером. |
|
dhcp_settings_from_fortiipam string |
Включить/отключить получение настроек DHCP-сервера из FortiIPAM. Варианты:
|
|
dns_server1 string |
DNS-сервер 1. |
|
dns_server2 string |
DNS-сервер 2. |
|
dns_server3 string |
DNS-сервер 3. |
|
dns_server4 string |
DNS-сервер 4. |
|
dns_service string |
Параметры назначения DNS-серверов клиентам DHCP. Варианты:
|
|
domain string |
Суффикс доменного имени для IP-адресов, которые DHCP-сервер назначает клиентам. |
|
exclude_range list / elements=dictionary |
Исключить один или несколько диапазонов IP-адресов из числа назначаемых клиентам. |
|
end_ip string |
Конец диапазона IP-адресов. |
|
id integer / обязательный |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
lease_time integer |
Время аренды в секундах; 0 означает время аренды по умолчанию. |
|
start_ip string |
Начало диапазона IP-адресов. |
|
uci_match string |
Включить/отключить сопоставление идентификатора класса пользователя (UCI). Если этот параметр включён, адреса из данного диапазона назначаются только в ответ на запросы DHCP с соответствующим UCI. Варианты:
|
|
uci_string list / elements=dictionary |
Одна или несколько строк UCI в кавычках, разделённых пробелами. |
|
uci_string string / обязательный |
Строки UCI. |
|
vci_match string |
Включить/отключить сопоставление идентификатора класса производителя (VCI). Если этот параметр включён, адреса из данного диапазона назначаются только в ответ на запросы DHCP с соответствующим VCI. Варианты:
|
|
vci_string list / elements=dictionary |
Одна или несколько строк VCI в кавычках, разделённых пробелами. |
|
vci_string string / обязательный |
Строки VCI. |
|
filename string |
Имя файла загрузки на сервере TFTP. |
|
forticlient_on_net_status string |
Включить/отключить службу FortiClient-On-Net для этого DHCP-сервера. Варианты:
|
|
id integer / обязательный |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
interface string |
DHCP-сервер может назначать IP-конфигурации клиентам, подключённым к этому интерфейсу. Источник: system.interface.name. |
|
ip_mode string |
Метод назначения IP-адреса клиенту. Варианты:
|
|
ip_range list / elements=dictionary |
Настройка диапазона IP-адресов DHCP. |
|
end_ip string |
Конец диапазона IP-адресов. |
|
id integer / обязательный |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
lease_time integer |
Время аренды в секундах; 0 означает время аренды по умолчанию. |
|
start_ip string |
Начало диапазона IP-адресов. |
|
uci_match string |
Включить/отключить сопоставление идентификатора класса пользователя (UCI). Если этот параметр включён, адреса из данного диапазона назначаются только в ответ на запросы DHCP с соответствующим UCI. Варианты:
|
|
uci_string list / elements=dictionary |
Одна или несколько строк UCI в кавычках, разделённых пробелами. |
|
uci_string string / обязательный |
Строки UCI. |
|
vci_match string |
Включить/отключить сопоставление идентификатора класса производителя (VCI). Если этот параметр включён, адреса из данного диапазона назначаются только в ответ на запросы DHCP с соответствующим VCI. Варианты:
|
|
vci_string list / elements=dictionary |
Одна или несколько строк VCI в кавычках, разделённых пробелами. |
|
vci_string string / обязательный |
Строки VCI. |
|
ipsec_lease_hold integer |
Срок аренды DHCP через IPsec истекает через указанное количество секунд после разрыва туннеля (0 отключает принудительное истечение срока действия). |
|
lease_time integer |
Время аренды в секундах; 0 означает неограниченный срок. |
|
mac_acl_default_action string |
Действие по умолчанию для управления доступом по MAC-адресу (разрешить или запретить назначение IP-параметров). Варианты:
|
|
netmask string |
Маска подсети, назначаемая DHCP-сервером. |
|
next_server string |
IP-адрес сервера (например, TFTP-сервера), с которого клиенты DHCP могут загрузить файл загрузки. |
|
ntp_server1 string |
NTP-сервер 1. |
|
ntp_server2 string |
NTP-сервер 2. |
|
ntp_server3 string |
NTP-сервер 3. |
|
ntp_service string |
Параметры назначения серверов Network Time Protocol (NTP) клиентам DHCP. Варианты:
|
|
options list / elements=dictionary |
Параметры DHCP. |
|
code integer |
Код параметра DHCP. |
|
id integer / обязательный |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
ip list / elements=string |
IP-адреса параметра DHCP. |
|
type string |
Тип параметра DHCP. Варианты:
|
|
uci_match string |
Включить или отключить сопоставление идентификатора класса пользователя (UCI). Если параметр включен, этот параметр предоставляется только в ответ на запросы DHCP с совпадающим UCI. Варианты:
|
|
uci_string list / elements=dictionary |
Одна или несколько строк UCI в кавычках, разделенных пробелами. |
|
uci_string string / обязательный |
Строки UCI. |
|
value string |
Значение параметра DHCP. |
|
vci_match string |
Включить или отключить сопоставление идентификатора класса производителя (VCI). Если параметр включен, этот параметр предоставляется только в ответ на запросы DHCP с совпадающим VCI. Варианты:
|
|
vci_string list / elements=dictionary |
Одна или несколько строк VCI в кавычках, разделенных пробелами. |
|
vci_string string / обязательный |
Строки VCI. |
|
relay_agent string |
IP-адрес агента ретрансляции. |
|
reserved_address list / elements=dictionary |
Параметры, позволяющие DHCP-серверу назначать настройки IP-адреса определенным MAC-адресам. |
|
action string |
Параметры настройки клиента DHCP-сервером с зарезервированным MAC-адресом. Варианты:
|
|
circuit_id string |
Идентификатор канала Circuit-ID параметра 82 для клиента, которому будет назначен зарезервированный IP-адрес. |
|
circuit_id_type string |
Тип параметра DHCP. Варианты:
|
|
description string |
Описание. |
|
id integer / обязательный |
Идентификатор. См. <a href=’#notes’>Примечания</a>. |
|
ip string |
IP-адрес, который будет зарезервирован для MAC-адреса. |
|
mac string |
MAC-адрес клиента, которому будет назначен зарезервированный IP-адрес. |
|
remote_id string |
Идентификатор Remote-ID параметра 82 для клиента, которому будет назначен зарезервированный IP-адрес. |
|
remote_id_type string |
Тип параметра DHCP. Варианты:
|
|
type string |
Тип зарезервированного адреса DHCP. Варианты:
|
|
server_type string |
DHCP-сервер может быть обычным DHCP-сервером или DHCP-сервером IPsec. Варианты:
|
|
string |
Включить или отключить общую подсеть. Варианты:
|
|
status string |
Включить или отключить эту конфигурацию DHCP. Варианты:
|
|
tftp_server list / elements=dictionary |
Одно или несколько имен узлов или IP-адресов TFTP-серверов в кавычках, разделенных пробелами. |
|
tftp_server string / обязательный |
TFTP-сервер. |
|
timezone string |
Выберите часовой пояс, назначаемый клиентам DHCP. Источник: system.timezone.name. Варианты:
|
|
timezone_option string |
Параметры, с помощью которых DHCP-сервер задает часовой пояс клиента. Варианты:
|
|
vci_match string |
Включить или отключить сопоставление идентификатора класса производителя (VCI). Если параметр включен, обслуживаются только запросы DHCP с совпадающим VCI. Варианты:
|
|
vci_string list / elements=dictionary |
Одна или несколько строк VCI в кавычках, разделенных пробелами. |
|
vci_string string / обязательный |
Строки VCI. |
|
wifi_ac1 string |
IP-адрес контроллера беспроводного доступа WiFi 1 (параметр DHCP 138, RFC 5417). |
|
wifi_ac2 string |
IP-адрес контроллера беспроводного доступа WiFi 2 (параметр DHCP 138, RFC 5417). |
|
wifi_ac3 string |
IP-адрес контроллера беспроводного доступа WiFi 3 (параметр DHCP 138, RFC 5417). |
|
wifi_ac_service string |
Параметры назначения контроллеров беспроводного доступа WiFi клиентам DHCP. Варианты:
|
|
wins_server1 string |
Сервер WINS 1. |
|
wins_server2 string |
Сервер WINS 2. |
vdom string | Виртуальный домен из числа ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Настоятельно рекомендуем использовать собственное значение для id вместо 0. Значение «0» — это специальный заполнитель, который позволяет серверной части назначить объекту последний доступный номер, однако у него есть ограничения. Подробнее см. в разделе «Вопросы и ответы».
- Устаревший fortiosapi объявлен нерекомендуемым; предпочтительный способ запуска плейбуков — httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Configure DHCP servers.
fortinet.fortios.fortios_system_dhcp_server:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
system_dhcp_server:
auto_configuration: "disable"
auto_managed_status: "disable"
conflicted_ip_timeout: "1800"
ddns_auth: "disable"
ddns_key: "<your_own_value>"
ddns_keyname: "<your_own_value>"
ddns_server_ip: "<your_own_value>"
ddns_ttl: "300"
ddns_update: "disable"
ddns_update_override: "disable"
ddns_zone: "<your_own_value>"
default_gateway: "<your_own_value>"
dhcp_settings_from_fortiipam: "disable"
dns_server1: "<your_own_value>"
dns_server2: "<your_own_value>"
dns_server3: "<your_own_value>"
dns_server4: "<your_own_value>"
dns_service: "local"
domain: "<your_own_value>"
exclude_range:
-
end_ip: "<your_own_value>"
id: "24"
lease_time: "0"
start_ip: "<your_own_value>"
uci_match: "disable"
uci_string:
-
uci_string: "<your_own_value>"
vci_match: "disable"
vci_string:
-
vci_string: "<your_own_value>"
filename: "<your_own_value>"
forticlient_on_net_status: "disable"
id: "35"
interface: "<your_own_value> (source system.interface.name)"
ip_mode: "range"
ip_range:
-
end_ip: "<your_own_value>"
id: "40"
lease_time: "0"
start_ip: "<your_own_value>"
uci_match: "disable"
uci_string:
-
uci_string: "<your_own_value>"
vci_match: "disable"
vci_string:
-
vci_string: "<your_own_value>"
ipsec_lease_hold: "60"
lease_time: "604800"
mac_acl_default_action: "assign"
netmask: "<your_own_value>"
next_server: "<your_own_value>"
ntp_server1: "<your_own_value>"
ntp_server2: "<your_own_value>"
ntp_server3: "<your_own_value>"
ntp_service: "local"
options:
-
code: "0"
id: "60"
ip: "<your_own_value>"
type: "hex"
uci_match: "disable"
uci_string:
-
uci_string: "<your_own_value>"
value: "<your_own_value>"
vci_match: "disable"
vci_string:
-
vci_string: "<your_own_value>"
relay_agent: "<your_own_value>"
reserved_address:
-
action: "assign"
circuit_id: "<your_own_value>"
circuit_id_type: "hex"
description: "<your_own_value>"
id: "76"
ip: "<your_own_value>"
mac: "<your_own_value>"
remote_id: "<your_own_value>"
remote_id_type: "hex"
type: "mac"
server_type: "regular"
shared_subnet: "disable"
status: "disable"
tftp_server:
-
tftp_server: "<your_own_value>"
timezone: "01"
timezone_option: "disable"
vci_match: "disable"
vci_string:
-
vci_string: "<your_own_value>"
wifi_ac_service: "specify"
wifi_ac1: "<your_own_value>"
wifi_ac2: "<your_own_value>"
wifi_ac3: "<your_own_value>"
wins_server1: "<your_own_value>"
wins_server2: "<your_own_value>"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи содержимого в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, возвращённый FortiGate для последней выполненной операции Возвращается: всегда Пример: |
mkey string | Главный ключ (идентификатор), использованный при последнем обращении к FortiGate Возвращается: при успешном выполнении Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер ревизии Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат операции Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_system_dhcp_server_module.html