f5networks.f5_modules.bigip_profile_server_ssl – Управляет профилями SSL сервера на BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_profile_server_ssl.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Обзор
- Управляет профилями SSL сервера на системе BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| certificate строка | Указывает имя сертификата, используемого системой для обработки SSL на стороне сервера. | ||
| chain строка | Указывает цепочку сертификатов-ключей для ассоциации с профилем SSL. | ||
| ciphers строка | Указывает список шифров, поддерживаемых системой. При создании нового профиля список шифров по умолчанию предоставляется родительским профилем. | ||
| key строка | Указывает имя файла SSL-ключа. | ||
| name строка / обязательно | Указывает имя профиля. | ||
| ocsp_profile строка | Указывает имя профиля OCSP для целей проверки статуса сертификата сервера. | ||
| parent строка | По умолчанию: "/Common/serverssl" | Родительская шаблон данного шаблона монитора. После установки этого значения, его нельзя изменить. | |
| partition строка | По умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| passphrase строка | Указывает пароль, используемый для шифрования ключа. | ||
| provider словарь добавлен в 1.0.0 f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика авторизации для получения маркеров аутентификации с удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem логическое значение |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную окружения F5_TEEM. | |
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_SERVER_PORT. | |
| timeout целое число | Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль вернет ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для использования при подключении к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную окружения F5_USER. | ||
| validate_certs логическое значение |
| Если no, сертификаты SSL не проверяются. Используйте это только на сайтах, контролируемых лично, использующих самозаверяющие сертификаты.Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS. | |
| renegotiation логическое значение |
| Включает или отключает переподключение SSL. При создании нового профиля значение задается родительским профилем. | |
| secure_renegotiation строка |
| Указывает метод безопасного переподключения для SSL-соединений. При создании нового профиля значение задается родительским профилем. Когда request установлено, система запрашивает безопасное переподключение SSL-соединений.require – значение по умолчанию, при установке которого система разрешает начальные SSL-handshake от клиентов, но прерывает переподключения от неисправленных клиентов.С настройкой require-strict, система требует строгого переподключения SSL-соединений. В этом режиме система отказывается от подключений к небезопасным серверам и прерывает существующие SSL-соединения с небезопасными серверами. | |
| server_certificate строка |
| Указывает способ обработки системой сертификатов сервера. Когда ignore, указывает, что система игнорирует сертификаты от систем серверов.Когда require, указывает, что система требует, чтобы сервер представил действительный сертификат. | |
| server_name строка | Указывает полное доменное имя сервера, используемое в сообщениях Server Name Indication. При создании нового профиля значение задается родительским профилем. | ||
| sni_default логическое значение |
| Указывает, что система использует этот профиль в качестве профиля SSL по умолчанию, когда нет совпадения с именем сервера или клиент не поддерживает расширение SNI. При создании нового профиля значение задается родительским профилем. Может быть только один профиль SSL с включенным этим параметром. | |
| sni_require логическое значение |
| Требует, чтобы сетевые узлы также поддерживали SNI. Это значение действует только когда sni_default равно yes.При создании нового профиля значение задается родительским профилем. | |
| state строка |
| Когда present, гарантирует существование профиля.Когда absent, гарантирует удаление профиля. | |
| update_password строка |
| 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
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| ciphers строка | изменённое | Шифры, применяемые к профилю. Пример: !SSLv3:!SSLv2:ECDHE+AES-GCM+SHA256:ECDHE-RSA-AES128-CBC-SHA |
| renegotiation булево | изменённое | Переустановление сессий SSL. Пример: True |
| secure_renegotiation строка | изменённое | Метод безопасного переустановления сессий SSL. Пример: request |
Авторы
- Tim Rupp (@caphrim007)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_profile_server_ssl_module.html