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

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.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 строка	Указывает общее имя (CN), которое встроено в сертификат сервера. Система аутентифицирует сервер на основе указанного CN.
ca_file строка	Указывает CA сервера, которому доверяет система. По умолчанию (None).
certificate строка	Указывает имя сертификата, используемого системой для обработки SSL на стороне сервера.
chain строка	Указывает цепочку сертификатов-ключей для ассоциации с профилем SSL.
cipher_group строка добавлено в f5networks.f5_modules 1.12.0	Указывает группу шифров для назначения этому профилю. Когда используется параметр `ciphers`, параметр `cipher_group` должен быть установлен либо на `none`, либо на `''`. При создании нового профиля с `cipher_group`, если родительский профиль имеет параметр `ciphers` по умолчанию, то параметр `cipher` должен быть установлен на `none` или `''` во время создания. Параметр работает только на версии TMOS 13.x и выше.
ciphers строка	Указывает список шифров, поддерживаемых системой. При создании нового профиля список шифров по умолчанию предоставляется родительским профилем. Когда используется параметр `cipher_group`, параметр `ciphers` должен быть установлен либо на `none`, либо на `''`.
key строка	Указывает имя файла SSL-ключа.
name строка / обязательно	Указывает имя профиля.
ocsp_profile строка	Указывает имя профиля OCSP для проверки статуса сертификата сервера.
options список / элементы=строка	Опции, используемые системой для обработки 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 строка	Родительская шаблон данной шаблона монитора. После установки этого значения, его изменить нельзя. По умолчанию: `"/Common/serverssl"`
partition строка	Раздел устройства для управления ресурсами. По умолчанию: `"Common"`
passphrase строка	Указывает пароль, используемый для шифрования ключа.
provider словарь добавлено в f5networks.f5_modules 1.0.0	Объект словаря, содержащий данные подключения.
auth_provider строка	Настраивает поставщика аутентификации для получения маркеров аутентификации с удалённого устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
no_f5_teem булево	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную окружения `F5_TELEMETRY_OFF`. Предыдущая переменная `F5_TEEM` устарела, так как её название вызывало путаницу. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd строка / обязательно	Пароль для учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Вы можете опустить этот параметр, установив переменную окружения `F5_PASSWORD`.
server строка / обязательно	Хост BIG-IP или хост BIG-IQ. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER`.
server_port целое число	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER_PORT`. По умолчанию: `443`

END_OF_DOCUMENT_MARKER

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 сервера, используемого в коммуникациях Server Name Indication. При создании нового профиля значение берётся из родительского профиля.
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 строка	Группа шифров, применяемая к профилю. Возвращено: изменено Пример: `"/Common/f5-secure"`
ciphers строка	Шифры, применяемые к профилю. Возвращено: изменено Пример: `"!SSLv3:!SSLv2:ECDHE+AES-GCM+SHA256:ECDHE-RSA-AES128-CBC-SHA"`
options список / элементы=строка	Список параметров для обработки SSL. Возвращено: изменено Пример: `["no-ssl", "no-sslv3"]`
renegotiation логическое значение	Переподключение SSL-сессий. Возвращено: изменено Пример: `true`
secure_renegotiation строка	Метод безопасного переподключения SSL. Возвращено: изменено Пример: `"request"`

Авторы

Tim Rupp (@caphrim007)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_profile_server_ssl_module.html