модуль fortinet.fortimanager.fmgr_firewall_accessproxy_apigateway6 — настройка шлюза API IPv6.
Примечание
Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.
Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_firewall_accessproxy_apigateway6.
Добавлено в fortinet.fortimanager 2.1.0
Обзор
- Этот модуль позволяет настраивать устройство FortiManager.
- В примерах приведены все параметры и значения, которые необходимо скорректировать с учётом источников данных перед использованием.
Параметры
Параметр | Комментарии |
|---|---|
access-proxy string | Устарело, используйте «access_proxy» |
access_proxy string | Параметр (access-proxy) в запрошенном URL. |
access_token string | Токен для доступа к FortiManager без использования имени пользователя и пароля. |
adom string / обязательный | Параметр (adom) в запрошенном URL. |
bypass_validation boolean | Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. В этом случае модуль продолжит выполнение без проверки параметров. Варианты:
|
enable_log boolean | Включить/отключить ведение журнала для задачи. Варианты:
|
firewall_accessproxy_apigateway6 dictionary | Набор параметров верхнего уровня. |
|
application any |
(список) SaaS-приложение, контролируемое этим прокси доступа. |
|
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_cookie_domain aliases: http-cookie-domain string |
Домен, для которого должна применяться привязка HTTP cookie. |
|
http_cookie_domain_from_host aliases: http-cookie-domain-from-host string |
Включить/отключить использование домена HTTP cookie из поля host в HTTP-запросе. Варианты:
|
|
http_cookie_generation aliases: http-cookie-generation integer |
Поколение HTTP cookie, принимаемое системой. |
|
http_cookie_path aliases: http-cookie-path string |
Ограничить привязку HTTP cookie указанным путем. |
|
http_cookie_share aliases: http-cookie-share string |
Управление совместным использованием cookie в шлюзе API. Варианты:
|
|
https_cookie_secure aliases: https-cookie-secure string |
Включить/отключить проверку защищенности вставляемых HTTPS cookie. Варианты:
|
|
id integer / обязательный |
Идентификатор шлюза API. |
|
ldb_method aliases: ldb-method string |
Метод распределения сеансов между реальными серверами. Варианты:
|
|
persistence string |
Настройка способа, позволяющего гарантировать, что при каждом запросе в рамках одного и того же... клиенты будут подключаться к одному и тому же серверу. Варианты:
|
|
quic dictionary |
Параметры QUIC. |
|
ack_delay_exponent aliases: ack-delay-exponent integer |
Показатель степени задержки ACK |
|
active_connection_id_limit aliases: active-connection-id-limit integer |
Ограничение на количество активных идентификаторов соединения |
|
active_migration aliases: active-migration string |
Включить/отключить активную миграцию Варианты:
|
|
grease_quic_bit aliases: grease-quic-bit string |
Включить/отключить бит GREASE QUIC Варианты:
|
|
max_ack_delay aliases: max-ack-delay integer |
Максимальная задержка ACK в миллисекундах |
|
max_datagram_frame_size aliases: max-datagram-frame-size integer |
Максимальный размер кадра дейтаграммы в байтах |
|
max_idle_timeout aliases: max-idle-timeout integer |
Максимальный тайм-аут бездействия в миллисекундах |
|
max_udp_payload_size aliases: max-udp-payload-size integer |
Максимальный размер полезной нагрузки UDP в байтах |
|
realservers list / elements=dictionary |
Реальные серверы. |
|
addr_type aliases: addr-type string |
Тип адреса. Варианты:
|
|
address string |
Адрес или группа адресов реального сервера. |
|
domain string |
Доменное имя с подстановочными знаками реального сервера. |
|
external_auth aliases: external-auth string |
Включить/отключить использование внешнего браузера в качестве user-agent для аутентификации пользователей SAML. Варианты:
|
|
health_check aliases: health-check string |
Включить проверку работоспособности реального сервера перед перенаправлением трафика. Варианты:
|
|
health_check_proto aliases: health-check-proto string |
Протокол монитора проверки работоспособности, используемый при опросе для определения состояния подключения серверов. Варианты:
|
|
holddown_interval aliases: holddown-interval string |
Включить/отключить таймер задержки. Варианты:
|
|
http_host aliases: http-host string |
Доменное имя HTTP-сервера в заголовке HTTP. |
|
id integer |
Идентификатор реального сервера. |
|
ip string |
IPv6-адрес реального сервера. |
|
mappedport any |
(список или строка) Порт для связи с реальным сервером. |
|
port integer |
Порт для связи с реальным сервером. |
|
ssh_client_cert aliases: ssh-client-cert string |
Задать профиль сертификата SSH-клиента прокси доступа. |
|
ssh_host_key aliases: ssh-host-key any |
(список или строка) Один или несколько ключей хоста сервера. |
|
ssh_host_key_validation aliases: ssh-host-key-validation string |
Включить/отключить проверку ключа хоста SSH реального сервера. Варианты:
|
|
status string |
Установить для реального сервера активный статус, чтобы он мог принимать трафик, либо перевести его в режим ожидания или отключить, чтобы трафик не... Варианты:
|
|
translate_host aliases: translate-host string |
Включить/отключить преобразование имени хоста/IP-адреса с виртуального сервера на реальный сервер. Варианты:
|
|
tunnel_encryption aliases: tunnel-encryption string |
Шифрование туннеля. Варианты:
|
|
type string |
Тип сервера переадресации TCP. Варианты:
|
|
verify_cert псевдонимы: verify-cert string |
Включить или отключить проверку сертификата реального сервера. Варианты:
|
|
weight integer |
Вес реального сервера. |
|
saml_redirect псевдонимы: saml-redirect string |
Включить или отключить перенаправление SAML после успешной аутентификации. Варианты:
|
|
saml_server псевдонимы: saml-server string |
Конфигурация поставщика услуг SAML для аутентификации VIP. |
|
service string |
Служба. Варианты:
|
|
ssl_algorithm псевдонимы: ssl-algorithm 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_dh_bits псевдонимы: ssl-dh-bits string |
Количество битов, используемых при обмене Диффи — Хеллмана для шифрования сеансов SSL с помощью RSA. Варианты:
|
|
ssl_max_version псевдонимы: ssl-max-version string |
Максимальная допустимая версия SSL/TLS, используемая сервером. Варианты:
|
|
ssl_min_version псевдонимы: ssl-min-version string |
Минимальная допустимая версия SSL/TLS, используемая сервером. Варианты:
|
|
ssl_renegotiation псевдонимы: ssl-renegotiation string |
Включить или отключить безопасное повторное согласование в соответствии с RFC 5746. Варианты:
|
|
ssl_vpn_web_portal псевдонимы: ssl-vpn-web-portal string |
Веб-портал SSL-VPN. |
|
url_map псевдонимы: url-map string |
Шаблон URL для сопоставления. |
|
url_map_type псевдонимы: url-map-type string |
Тип сопоставления URL. Варианты:
|
|
virtual_host псевдонимы: virtual-host string |
Виртуальный хост. |
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 / обязательный | Указание на создание, обновление или удаление объекта. Варианты:
|
workspace_locking_adom string | ADOM, блокируемый для FortiManager, работающего в режиме рабочей области. Значением может быть global или другое значение, включая 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 (generated based on argument schema)
hosts: fortimanagers
connection: httpapi
gather_facts: false
tasks:
- name: Set IPv6 API Gateway.
fortinet.fortimanager.fmgr_firewall_accessproxy_apigateway6:
# workspace_locking_adom: <global or your adom name>
adom: <your own value>
access_proxy: <your own value>
state: present # <value in [present, absent]>
firewall_accessproxy_apigateway6:
id: 0 # Required variable, integer
# http_cookie_age: <integer>
# http_cookie_domain: <string>
# http_cookie_domain_from_host: <value in [disable, enable]>
# http_cookie_generation: <integer>
# http_cookie_path: <string>
# http_cookie_share: <value in [disable, same-ip]>
# https_cookie_secure: <value in [disable, enable]>
# ldb_method: <value in [static, round-robin, weighted, ...]>
# persistence: <value in [none, http-cookie]>
# realservers:
# - addr_type: <value in [fqdn, ip]>
# address: <string>
# domain: <string>
# health_check: <value in [disable, enable]>
# health_check_proto: <value in [ping, http, tcp-connect]>
# holddown_interval: <value in [disable, enable]>
# http_host: <string>
# id: <integer>
# ip: <string>
# mappedport: <list or string>
# port: <integer>
# ssh_client_cert: <string>
# ssh_host_key: <list or string>
# ssh_host_key_validation: <value in [disable, enable]>
# status: <value in [active, standby, disable]>
# type: <value in [tcp-forwarding, ssh]>
# weight: <integer>
# translate_host: <value in [disable, enable]>
# external_auth: <value in [disable, enable]>
# tunnel_encryption: <value in [disable, enable]>
# verify_cert: <value in [disable, enable]>
# saml_redirect: <value in [disable, enable]>
# saml_server: <string>
# service: <value in [http, https, tcp-forwarding, ...]>
# ssl_algorithm: <value in [high, medium, low]>
# ssl_cipher_suites:
# - cipher: <value in [TLS-RSA-WITH-RC4-128-MD5, TLS-RSA-WITH-RC4-128-SHA, TLS-RSA-WITH-DES-CBC-SHA, ...]>
# priority: <integer>
# versions: ["tls-1.0", "tls-1.1", "tls-1.2", "tls-1.3"]
# ssl_dh_bits: <value in [768, 1024, 1536, ...]>
# ssl_max_version: <value in [tls-1.0, tls-1.1, tls-1.2, ...]>
# ssl_min_version: <value in [tls-1.0, tls-1.1, tls-1.2, ...]>
# ssl_vpn_web_portal: <string>
# url_map: <string>
# url_map_type: <value in [sub-string, wildcard, regex]>
# virtual_host: <string>
# application: <list or string>
# ssl_renegotiation: <value in [disable, enable]>
# h2_support: <value in [disable, enable]>
# h3_support: <value in [disable, enable]>
# quic:
# ack_delay_exponent: <integer>
# active_connection_id_limit: <integer>
# active_migration: <value in [disable, enable]>
# grease_quic_bit: <value in [disable, enable]>
# max_ack_delay: <integer>
# max_datagram_frame_size: <integer>
# max_idle_timeout: <integer>
# max_udp_payload_size: <integer>
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
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_accessproxy_apigateway6_module.html