Модуль fortinet.fortimanager.fmgr_firewall_accessproxy_apigateway — настройка API-шлюза.
Примечание
Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.
Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_firewall_accessproxy_apigateway.
Добавлено в 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_apigateway dictionary | Набор параметров верхнего уровня. |
|
application any |
(список) SaaS-приложение, управляемое этим Access Proxy. |
|
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 |
Включить/отключить использование внешнего браузера в качестве пользовательского агента для аутентификации пользователей 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 |
IP-адрес реального сервера. |
|
mappedport any |
(список или строка) Порт для связи с реальным сервером. |
|
port integer |
Порт для связи с реальным сервером. |
|
ssh_client_cert aliases: ssh-client-cert string |
Задать профиль сертификата SSH-клиента для Access Proxy. |
|
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-адреса виртуального сервера в имя хоста/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 в режиме full в соответствии с уровнем стойкости шифрования. Варианты:
|
|
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 |
Количество битов, используемых при обмене Diffie-Hellman для шифрования сеансов 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-map. Варианты:
|
|
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 или другие 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 (generated based on argument schema)
hosts: fortimanagers
connection: httpapi
gather_facts: false
tasks:
- name: Set API Gateway.
fortinet.fortimanager.fmgr_firewall_accessproxy_apigateway:
# 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_apigateway:
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:
# - address: <string>
# health_check: <value in [disable, enable]>
# health_check_proto: <value in [ping, http, tcp-connect]>
# http_host: <string>
# id: <integer>
# ip: <string>
# mappedport: <list or string>
# port: <integer>
# status: <value in [active, standby, disable]>
# weight: <integer>
# addr_type: <value in [fqdn, ip]>
# domain: <string>
# holddown_interval: <value in [disable, enable]>
# ssh_client_cert: <string>
# ssh_host_key: <list or string>
# ssh_host_key_validation: <value in [disable, enable]>
# type: <value in [tcp-forwarding, ssh]>
# 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_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, ...]>
# url_map: <string>
# url_map_type: <value in [sub-string, wildcard, regex]>
# virtual_host: <string>
# saml_redirect: <value in [disable, enable]>
# ssl_vpn_web_portal: <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_apigateway_module.html