Модуль f5networks.f5_modules.bigip_profile_server_ssl — управление профилями SSL сервера на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

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

Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать коллекцию в плейбуке, укажите: f5networks.f5_modules.bigip_profile_server_ssl.

Добавлено в f5networks.f5_modules 1.0.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управляет профилями SSL сервера в системе BIG-IP.

Параметры

Параметр	Комментарии
authenticate_name string	Указывает общее имя (CN), встроенное в сертификат сервера. Система аутентифицирует сервер на основе указанного CN.
ca_file string	Указывает CA сервера, которому доверяет система. Значение по умолчанию — (None).
certificate string	Указывает имя сертификата, который система использует для обработки SSL на стороне сервера.
chain string	Указывает цепочку сертификатов и ключей, связываемую с профилем SSL.
cipher_group string добавлено в f5networks.f5_modules 1.12.0	Указывает группу шифров, назначаемую этому профилю. Если используется параметр `ciphers`, для параметра `cipher_group` необходимо задать значение `none` или `''`. При создании нового профиля с помощью `cipher_group`, если для родительского профиля по умолчанию задано `ciphers`, во время создания параметру `cipher` необходимо присвоить значение `none` или `''`. Параметр работает только в TMOS версии 13.x и более поздних.
ciphers string	Указывает список шифров, поддерживаемых системой. При создании нового профиля используется список шифров родительского профиля. Если используется параметр `cipher_group`, для параметра `ciphers` необходимо задать значение `none` или `''`.
key string	Указывает имя файла ключа SSL.
name string / обязательный	Указывает имя профиля.
ocsp_profile string	Указывает имя профиля OCSP, используемого для проверки статуса сертификата сервера.
options list / elements=string	Список параметров, используемых системой для обработки SSL. При создании нового профиля список берётся из родительского профиля. При значении `''` или `none` все параметры обработки SSL отключены. Возможные значения: `"dont-insert-empty-fragments"` `"no-ssl"` `"no-dtls"` `"no-session-resumption-on-renegotiation"` `"no-tlsv1.1"` `"no-tlsv1.2"` `"no-tlsv1.3"` `"single-dh-use"` `"tls-rollback-bug"` `"no-sslv3"` `"no-tls"` `"no-tlsv1"` `"none"`
parent any	Родительский шаблон этого шаблона монитора. После задания этого значения изменить его нельзя. По умолчанию: `"/Common/serverssl"`
partition string	Раздел устройства, в котором будут управляться ресурсы. По умолчанию: `"Common"`
passphrase string	Указывает парольную фразу, используемую для шифрования ключа.
provider dictionary добавлено в f5networks.f5_modules 1.0.0	Объект dict, содержащий сведения о подключении.
auth_provider string	Настраивает поставщика аутентификации, используемого для получения токенов аутентификации с удалённого устройства. Этот параметр фактически используется при работе с устройствами BIG-IQ.
no_f5_teem boolean	Если задано `yes`, телеметрические данные TEEM не отправляются в F5. Этот параметр можно не указывать, задав переменную среды `F5_TELEMETRY_OFF`. Ранее использовавшаяся переменная `F5_TEEM` устарела, поскольку её имя было неоднозначным. Возможные значения: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd string / обязательный	Пароль учётной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_PASSWORD`.
server string / обязательный	Узел BIG-IP или BIG-IQ. Этот параметр можно не указывать, задав переменную среды `F5_SERVER`.
server_port integer	Порт сервера BIG-IP. Этот параметр можно не указывать, задав переменную среды `F5_SERVER_PORT`. По умолчанию: `443`
timeout integer	Задаёт время ожидания в секундах при подключении к сетевому устройству или отправке команд. Если время ожидания истечёт до завершения операции, модуль завершится с ошибкой.
transport string	Настраивает транспортное соединение, используемое при подключении к удалённому устройству. Возможные значения: `"rest"` ← (по умолчанию)
user string / обязательный	Имя пользователя для подключения к BIG-IP или BIG-IQ. У этого пользователя должны быть права администратора на устройстве. Этот параметр можно не указывать, задав переменную среды `F5_USER`.
validate_certs boolean	Если задано `no`, сертификаты SSL не проверяются. Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами. Этот параметр можно не указывать, задав переменную среды `F5_VALIDATE_CERTS`. Возможные значения: `false` `true` ← (по умолчанию)
renegotiation boolean	Включает или отключает повторное согласование SSL. При создании нового профиля значение берётся из родительского профиля. Возможные значения: `false` `true`
secure_renegotiation string	Указывает метод безопасного повторного согласования для SSL-соединений. При создании нового профиля значение берётся из родительского профиля. Если задано `request`, система запрашивает безопасное повторное согласование SSL-соединений. Значение `require` используется по умолчанию: система разрешает начальное SSL-рукопожатие с клиентами, но прерывает повторное согласование с клиентами, для которых не установлены исправления. При значении `require-strict` система требует строгого повторного согласования SSL-соединений. В этом режиме система отклоняет соединения с небезопасными серверами и прерывает существующие SSL-соединения с ними. Возможные значения: `"require"` `"require-strict"` `"request"`
server_certificate string	Указывает способ обработки системой сертификатов сервера. Если задано `ignore`, система игнорирует сертификаты серверных систем. Если задано `require`, сервер должен предоставить действительный сертификат. Возможные значения: `"ignore"` `"require"`
server_name string	Указывает полное DNS-имя сервера, используемое при обмене данными с помощью индикации имени сервера (SNI). При создании нового профиля значение берётся из родительского профиля.
sni_default boolean	Указывает, что система использует этот профиль как профиль SSL по умолчанию, если имя сервера не совпадает или клиент не поддерживает расширение SNI. При создании нового профиля значение берётся из родительского профиля. Только для одного профиля SSL можно включить этот параметр. Возможные значения: `false` `true`
sni_require boolean	Требует, чтобы сетевые узлы также поддерживали SNI. Этот параметр действует только при значении `sni_default`, равном `true`. При создании нового профиля значение берётся из родительского профиля. Возможные значения: `false` `true`
state string	При значении `present` обеспечивает наличие профиля. При значении `absent` обеспечивает удаление профиля. Возможные значения: `"present"` ← (по умолчанию) `"absent"`
update_password string	Параметр `always` позволяет пользователям обновлять пароли по своему усмотрению. Параметр `on_create` задаёт пароль только для вновь созданных профилей. Возможные значения: `"always"` ← (по умолчанию) `"on_create"`

Примечания

Примечание

Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
Требуется BIG-IP версии >= 12.
Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы обеспечить сохранение специфичной для BIG-IP конфигурации на диске, включите как минимум одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Инструкции по правильному использованию модуля для сохранения текущей конфигурации см. в его документации.

Примеры

- name: Create a new server SSL profile
  bigip_profile_server_ssl:
    name: foo
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Create server SSL profile with specific cipher group
  bigip_profile_server_ssl:
    state: present
    name: foo_group
    ciphers: "none"
    cipher_group: "/Common/f5-secure"
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

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

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

Ключ	Описание
cipher_group string	Группа шифров, применённая к профилю. Возвращается: changed Пример: `"/Common/f5-secure"`
ciphers string	Шифры, применённые к профилю. Возвращается: changed Пример: `"!SSLv3:!SSLv2:ECDHE+AES-GCM+SHA256:ECDHE-RSA-AES128-CBC-SHA"`
options list / elements=string	Список параметров обработки SSL. Возвращается: changed Пример: `["no-ssl", "no-sslv3"]`
renegotiation boolean	Повторное согласование SSL-сеансов. Возвращается: changed Пример: `true`
secure_renegotiation string	Метод безопасного повторного согласования SSL. Возвращается: changed Пример: `"request"`

Авторы

Tim Rupp (@caphrim007)

Ссылки на коллекцию

© 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/f5networks/f5_modules/bigip_profile_server_ssl_module.html