Модуль fortinet.fortimanager.fmgr_firewall_vip6_dynamicmapping — настройка виртуального IP-адреса для IPv6.
Примечание
Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.
Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_firewall_vip6_dynamicmapping.
Добавлено в fortinet.fortimanager 2.0.0
Обзор
- Этот модуль предназначен для настройки устройства FortiManager.
- В примерах указаны все параметры и значения, которые необходимо скорректировать в соответствии с источниками данных перед использованием.
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Токен для доступа к FortiManager без использования имени пользователя и пароля. |
adom string / обязательный | Параметр (adom) в запрошенном URL. |
bypass_validation boolean | Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. В этом случае модуль продолжит выполнение без проверки параметров. Варианты:
|
enable_log boolean | Включить/отключить ведение журнала для задачи. Варианты:
|
firewall_vip6_dynamicmapping dictionary | Набор параметров верхнего уровня. |
|
_scope list / elements=dictionary |
Область действия. |
|
name string |
Имя. |
|
vdom string |
VDOM. |
|
add_nat64_route aliases: add-nat64-route string |
Включить/отключить добавление маршрута NAT64. Варианты:
|
|
arp_reply aliases: arp-reply string |
Ответ ARP. Варианты:
|
|
client_cert aliases: client-cert string |
Включить/отключить запрос сертификата клиента. Варианты:
|
|
color integer |
Цвет. |
|
comment string |
Комментарий. |
|
embedded_ipv4_address aliases: embedded-ipv4-address string |
Включить/отключить использование младших 32 бит внешнего IPv6-адреса в качестве отображаемого IPv4-адреса. Варианты:
|
|
empty_cert_action aliases: empty-cert-action string |
Действие при пустом сертификате клиента. Варианты:
|
|
extip string |
Внешний IP-адрес. |
|
extport string |
Внешний порт. |
|
h2_support aliases: h2-support string |
Включить/отключить поддержку HTTP/2 Варианты:
|
|
h3_support aliases: h3-support string |
Включить/отключить поддержку HTTP/3 и QUIC Варианты:
|
|
http_cookie_age aliases: http-cookie-age integer |
Срок действия cookie HTTP. |
|
http_cookie_domain aliases: http-cookie-domain string |
Домен cookie HTTP. |
|
http_cookie_domain_from_host aliases: http-cookie-domain-from-host string |
Домен cookie HTTP из заголовка Host. Варианты:
|
|
http_cookie_generation aliases: http-cookie-generation integer |
Поколение cookie HTTP. |
|
http_cookie_path aliases: http-cookie-path string |
Путь cookie HTTP. |
|
http_cookie_share aliases: http-cookie-share string |
Общий доступ к cookie HTTP. Варианты:
|
|
http_ip_header aliases: http-ip-header string |
Заголовок IP HTTP. Варианты:
|
|
http_ip_header_name aliases: http-ip-header-name string |
Имя заголовка IP HTTP. |
|
http_multiplex aliases: http-multiplex string |
Мультиплексирование HTTP. Варианты:
|
|
http_redirect aliases: http-redirect string |
Перенаправление HTTP. Варианты:
|
|
https_cookie_secure aliases: https-cookie-secure string |
Защищённый cookie HTTPS. Варианты:
|
|
id integer |
Идентификатор. |
|
ipv4_mappedip aliases: ipv4-mappedip string |
Диапазон отображаемых IP-адресов. |
|
ipv4_mappedport aliases: ipv4-mappedport string |
Диапазон номеров портов IPv4 в целевой сети, на который отображается диапазон номеров внешних портов. |
|
ldb_method aliases: ldb-method string |
Метод балансировки нагрузки. Варианты:
|
|
mappedip string |
Отображаемый IP-адрес. |
|
mappedport string |
Отображаемый порт. |
|
max_embryonic_connections aliases: max-embryonic-connections integer |
Максимальное число полуоткрытых соединений. |
|
monitor any |
(список или строка) Монитор. |
|
nat64 string |
Включить/отключить DNAT64. Варианты:
|
|
nat66 string |
Включить/отключить DNAT66. Варианты:
|
|
nat_source_vip aliases: nat-source-vip string |
Исходный VIP для NAT. Варианты:
|
|
ndp_reply aliases: ndp-reply string |
Включить/отключить возможность этого устройства FortiGate отвечать на запросы NDP для данного виртуального IP-адреса. Варианты:
|
|
outlook_web_access aliases: outlook-web-access string |
Веб-доступ Outlook. Варианты:
|
|
persistence string |
Сохранение привязки. Варианты:
|
|
portforward string |
Перенаправление портов. Варианты:
|
|
protocol string |
Протокол. Варианты:
|
|
realservers list / elements=dictionary |
Реальные серверы. |
|
client_ip aliases: client-ip string |
К этому реальному серверу могут подключаться только клиенты из указанного диапазона IP-адресов. |
|
healthcheck string |
Включить проверку доступности реального сервера перед пересылкой трафика. Варианты:
|
|
holddown_interval aliases: holddown-interval integer |
Время в секундах, в течение которого монитор проверки работоспособности продолжает отслеживать неотвечающий сервер, который должен быть активен. |
|
http_host aliases: http-host string |
Доменное имя HTTP-сервера в заголовке HTTP. |
|
id integer |
Идентификатор реального сервера. |
|
ip string |
IP-адрес реального сервера. |
|
max_connections псевдонимы: max-connections integer |
Максимальное число активных подключений, которые можно направить на реальный сервер. |
|
monitor any |
(список или строка) Имя монитора проверки работоспособности, используемого при опросе для определения состояния подключения виртуального сервера. |
|
port integer |
Порт для обмена данными с реальным сервером. |
|
status string |
Установите для реального сервера состояние «активен», чтобы он мог принимать трафик, либо «резервный» или «отключён», чтобы трафик не направлялся… Варианты:
|
|
translate_host псевдонимы: translate-host string |
Включение/отключение преобразования имени хоста/IP-адреса виртуального сервера в имя хоста/IP-адрес реального сервера. Варианты:
|
|
verify_cert псевдонимы: verify-cert string |
Включение/отключение проверки сертификата реального сервера. Варианты:
|
|
weight integer |
Вес реального сервера. |
|
server_type псевдонимы: server-type string |
Тип сервера. Варианты:
|
|
src_filter псевдонимы: src-filter any |
(список) Фильтр источника. |
|
src_vip_filter псевдонимы: src-vip-filter string |
Включение/отключение использования src-filter для сопоставления адресатов правила обратного SNAT. Варианты:
|
|
ssl_accept_ffdhe_groups псевдонимы: ssl-accept-ffdhe-groups string |
Включение/отключение набора шифров FFDHE для обмена ключами SSL. Варианты:
|
|
ssl_algorithm псевдонимы: ssl-algorithm string |
Алгоритм SSL. Варианты:
|
|
ssl_certificate псевдонимы: ssl-certificate string |
Сертификат SSL. |
|
ssl_cipher_suites псевдонимы: ssl-cipher-suites list / elements=dictionary |
Наборы шифров SSL. |
|
cipher string |
Название набора шифров. Варианты:
|
|
priority integer |
Приоритет наборов шифров SSL/TLS. |
|
versions list / elements=string |
Версии SSL/TLS, с которыми можно использовать данный набор шифров. Варианты:
|
|
ssl_client_fallback псевдонимы: ssl-client-fallback string |
Резервный режим клиента SSL. Варианты:
|
|
ssl_client_rekey_count псевдонимы: ssl-client-rekey-count integer |
Количество повторных обменов ключами клиента SSL. |
|
ssl_client_renegotiation псевдонимы: ssl-client-renegotiation string |
Повторное согласование соединения клиента SSL. Варианты:
|
|
ssl_client_session_state_max псевдонимы: ssl-client-session-state-max integer |
Максимальное количество состояний сеансов клиента SSL. |
|
ssl_client_session_state_timeout псевдонимы: ssl-client-session-state-timeout integer |
Время ожидания состояния сеанса клиента SSL. |
|
ssl_client_session_state_type псевдонимы: ssl-client-session-state-type string |
Тип состояния сеанса клиента SSL. Варианты:
|
|
ssl_dh_bits псевдонимы: ssl-dh-bits string |
Разрядность DH для SSL. Варианты:
|
|
ssl_hpkp псевдонимы: ssl-hpkp string |
HPKP для SSL. Варианты:
|
|
ssl_hpkp_age псевдонимы: ssl-hpkp-age integer |
Срок действия HPKP для SSL. |
|
ssl_hpkp_backup псевдонимы: ssl-hpkp-backup string |
Резервный ключ HPKP для SSL. |
|
ssl_hpkp_include_subdomains псевдонимы: ssl-hpkp-include-subdomains string |
Включение поддоменов в HPKP для SSL. Варианты:
|
|
ssl_hpkp_primary псевдонимы: ssl-hpkp-primary string |
Основной ключ HPKP для SSL. |
|
ssl_hpkp_report_uri псевдонимы: ssl-hpkp-report-uri string |
URI для отчётов HPKP для SSL. |
|
ssl_hsts псевдонимы: ssl-hsts string |
HSTS для SSL. Варианты:
|
|
ssl_hsts_age псевдонимы: ssl-hsts-age integer |
Срок действия HSTS для SSL. |
|
ssl_hsts_include_subdomains псевдонимы: ssl-hsts-include-subdomains string |
Включение поддоменов в HSTS для SSL. Варианты:
|
|
ssl_http_location_conversion псевдонимы: ssl-http-location-conversion string |
Преобразование HTTP Location для SSL. Варианты:
|
|
ssl_http_match_host псевдонимы: ssl-http-match-host string |
Сопоставление узла HTTP для SSL. Варианты:
|
|
ssl_max_version псевдонимы: ssl-max-version string |
Максимальная версия SSL. Варианты:
|
|
ssl_min_version псевдонимы: ssl-min-version string |
Минимальная версия SSL. Варианты:
|
|
ssl_mode псевдонимы: ssl-mode string |
Режим SSL. Варианты:
|
|
ssl_pfs псевдонимы: ssl-pfs string |
PFS для SSL. Варианты:
|
|
ssl_send_empty_frags псевдонимы: ssl-send-empty-frags string |
Отправка пустых фрагментов SSL. Варианты:
|
|
ssl_server_algorithm aliases: ssl-server-algorithm string |
Алгоритм SSL-сервера. Варианты:
|
|
ssl_server_max_version aliases: ssl-server-max-version string |
Максимальная версия SSL-сервера. Варианты:
|
|
ssl_server_min_version aliases: ssl-server-min-version string |
Минимальная версия SSL-сервера. Варианты:
|
|
ssl_server_renegotiation aliases: ssl-server-renegotiation string |
Включить или отключить безопасное повторное согласование в соответствии с RFC 5746. Варианты:
|
|
ssl_server_session_state_max aliases: ssl-server-session-state-max integer |
Максимальное количество состояний сеансов SSL-сервера. |
|
ssl_server_session_state_timeout aliases: ssl-server-session-state-timeout integer |
Время ожидания состояния сеанса SSL-сервера. |
|
ssl_server_session_state_type aliases: ssl-server-session-state-type string |
Тип состояния сеанса SSL-сервера. Варианты:
|
|
type string |
Тип. Варианты:
|
|
user_agent_detect aliases: user-agent-detect string |
Включить или отключить определение типа устройства по HTTP user-agent, если сертификат клиента не предоставлен. Варианты:
|
|
uuid string |
UUID. |
|
vip_id aliases: vip-id integer |
Идентификатор VIP. |
|
weblogic_server aliases: weblogic-server string |
Сервер WebLogic. Варианты:
|
|
websphere_server aliases: websphere-server string |
Сервер WebSphere. Варианты:
|
forticloud_access_token string | Аутентификация клиента Ansible с помощью токена доступа к API FortiCloud. |
proposed_method string | Метод, переопределяющий метод базового запроса Json RPC. Варианты:
|
rc_failed list / elements=integer | Список кодов rc, переопределяющий условия сбоя. |
rc_succeeded list / elements=integer | Список кодов rc, переопределяющий условия успешного выполнения. |
revision_note string | Примечание об изменении, которое можно указать при создании или обновлении объекта. |
state string / обязательно | Указание на создание, обновление или удаление объекта. Варианты:
|
vip6 string / обязательно | Параметр (vip6) в запрошенном URL. |
workspace_locking_adom string | ADOM, который нужно заблокировать для FortiManager, работающего в режиме рабочей области. Значением может быть global или другие ADOM, включая root. |
workspace_locking_timeout integer | Максимальное время ожидания освобождения блокировки рабочей области другим пользователем, в секундах. По умолчанию: |
Примечания
Примечание
- Начиная с версии 2.4.0, все входные аргументы именуются в соответствии с соглашением об использовании подчеркиваний (snake_case). Замените такие аргументы, как «var-name», на «var_name». Старые имена аргументов по-прежнему доступны, но при их использовании будут выдаваться предупреждения об устаревании. Это предупреждение можно игнорировать, установив deprecation_warnings=False в ansible.cfg.
- Этот модуль FortiManager поддерживает работу в режиме блокировки рабочей области; для этого предназначены параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout.
- Обычно выполнение модуля может завершиться с ошибкой при возврате ненулевого значения rc. Условия сбоя или успешного выполнения также можно переопределить с помощью параметров rc_failed и rc_succeeded.
- Для создания или обновления объекта используйте директиву state present.
- Для удаления объекта используйте директиву state absent.
Примеры
- name: Example playbook
hosts: fortimanagers
gather_facts: false
connection: httpapi
vars:
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_httpapi_port: 443
tasks:
- name: Configure dynamic mappings of virtual IP for IPv6
fortinet.fortimanager.fmgr_firewall_vip6_dynamicmapping:
bypass_validation: false
adom: ansible
vip6: "ansible-test-vip6" # name
state: present
firewall_vip6_dynamicmapping:
_scope:
- name: FGT_AWS # need a valid device name
vdom: root # need a valid vdom name under the device
arp_reply: disable
color: 1
comment: "ansible-comment"
id: 1
- name: Gathering fortimanager facts
hosts: fortimanagers
gather_facts: false
connection: httpapi
vars:
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_httpapi_port: 443
tasks:
- name: Retrieve all the dynamic mappings of virtual IP for IPv6
fortinet.fortimanager.fmgr_fact:
facts:
selector: "firewall_vip6_dynamicmapping"
params:
adom: "ansible"
vip6: "ansible-test-vip6" # name
dynamic_mapping: "your_value"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
meta dictionary | Результат запроса. Возвращается: всегда |
|
request_url string |
Полный URL запроса. Возвращается: всегда Пример: |
|
response_code integer |
Статус запроса API. Возвращается: всегда Пример: |
|
response_data list / elements=string |
Ответ API. Возвращается: всегда |
|
response_message string |
Описание ответа API. Возвращается: всегда Пример: |
|
system_information dictionary |
Информация о целевой системе. Возвращается: всегда |
rc integer | Статус запроса. Возвращается: всегда Пример: |
version_check_warning list / elements=string | Предупреждение, если используемые в сценарии параметры не поддерживаются текущей версией FortiManager. Возвращается: при сложных случаях |
Ссылки на коллекцию
© 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/fortimanager/fmgr_firewall_vip6_dynamicmapping_module.html