f5networks.f5_modules.bigip_ssl_key_cert – Импорт/удаление SSL-ключей и сертификатов с BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules
Для использования в плейбуке укажите: f5networks.f5_modules.bigip_ssl_key_cert
Новое в версии 1.6.0: модуля f5networks.f5_modules
Обзор
- Этот модуль импортирует/удаляет SSL-ключи и сертификаты на BIG-IP. Ключи можно импортировать из файлов ключей на локальном диске в формате PEM. Сертификаты можно импортировать из файлов сертификатов и ключей на локальном диске в формате PEM.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| cert_content строка | Устанавливает содержимое сертификата напрямую указанным значением. Это используется с плагинами поиска или для чего-либо с форматированием или content должно быть предоставлено, когда state является present. | ||
| cert_name строка | Имя SSL-сертификата. Это имя сертификата, используемое при импорте сертификата в BIG-IP. Оно также определяет имена файлов объектов на LTM. | ||
| issuer_cert строка | Сертификат издателя, используемый для мониторинга OCSP. Этот параметр действителен только для версий BIG-IP 13.0.0 и выше. | ||
| key_content строка | Устанавливает содержимое ключа напрямую указанным значением. Это используется с плагинами поиска или для чего-либо с форматированием или шаблонированием. Это должно быть предоставлено, когда state является present. | ||
| key_name строка | Имя ключа. | ||
| partition строка | По умолчанию: "Общие" | Раздел устройства для управления ресурсами. | |
| 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. | |
| state строка |
| Когда present, гарантирует загрузку ключа и/или сертификата на устройство. Когда absent, гарантирует удаление ключа и/или сертификата с устройства. Если ключ и/или сертификат в настоящее время используется, модуль не сможет удалить ключ. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 только манипулируют текущей конфигурацией продукта F5. Чтобы гарантировать сохранение конфигурации BIG-IP на диске, убедитесь, что включён хотя бы один таск, использующий модуль f5networks.f5_modules.bigip_config, для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Import both key and cert
bigip_ssl_key_cert:
key_content: "{{ lookup('file', 'key.pem') }}"
key_name: cert1
cert_content: "{{ lookup('file', 'cert.pem') }}"
cert_name: cert1
state: present
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Авторы
- Nitin Khanna (@nitinthewiz)
© 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_ssl_key_cert_module.html
