f5networks.f5_modules.bigip_ssl_certificate – Импорт/удаление сертификатов с BIG-IP

Примечание

Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).

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

Для использования в книге задач укажите: f5networks.f5_modules.bigip_ssl_certificate.

Новое в версии 1.0.0: of f5networks.f5_modules

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

Обзор

Этот модуль импортирует/удаляет SSL-сертификаты на BIG-IP LTM. Сертификаты могут быть импортированы из файлов сертификата и ключа на локальном диске в формате PEM.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

BIG-IP >= v12

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
content строка			Устанавливает содержимое сертификата непосредственно в указанное значение. Используется с плагинами поиска или для всего, что связано с форматированием, или `content` должно быть предоставлено, когда `state` равно `present`. псевдонимы: cert_content
issuer_cert строка			Сертификат издателя, используемый для мониторинга OCSP. Этот параметр действителен только для версий BIG-IP 13.0.0 и выше.
name строка / обязательный			Имя SSL-сертификата. Это имя сертификата, используемое при импорте сертификата в BIG-IP. Оно также определяет имена файлов объектов в LTM.
partition строка		Значение по умолчанию: "Общие"	Раздел устройства для управления ресурсами.
provider словарь добавлен в 1.0.0 of 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 строка	Варианты: rest ←	Настраивает транспортное соединение для использования при подключении к удаленному устройству.
	user строка / обязательный		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, установив переменную среды `F5_USER`.
	validate_certs булево	Варианты: нет да ←	Если `no`, SSL-сертификаты не проверяются. Используйте этот параметр только на контролируемых вами сайтах, использующих самозаверяемые сертификаты. Этот параметр можно опустить, установив переменную среды `F5_VALIDATE_CERTS`.
state строка		Варианты: present ← absent	Состояние сертификата. Это определяет, должен ли предоставленный сертификат и ключ быть `present` на устройстве или `absent`.

Примечания

Примечание

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

Примеры

- name: Use a file lookup to import PEM Certificate
  bigip_ssl_certificate:
    name: certificate-name
    state: present
    content: "{{ lookup('file', '/path/to/cert.crt') }}"
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Use a file lookup to import CA certificate chain
  bigip_ssl_certificate:
    name: ca-chain-name
    state: present
    content: "{{ lookup('file', '/path/to/ca-chain.crt') }}"
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Delete Certificate
  bigip_ssl_certificate:
    name: certificate-name
    state: absent
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
cert_name строка	создано	Имя сертификата. Пример: cert1
checksum строка	изменено и создано	Контрольная сумма SHA1 сертификата. Пример: f7ff9e8b7bb2e09b70935a5d785e0cc5d9d0abf0
filename строка	создано	Имя SSL-сертификата. Пример: cert1.crt
source_path строка	создано	Путь на BIG-IP, где хранится исходный сертификат. Пример: /var/config/rest/downloads/cert1.crt

Авторы

Tim Rupp (@caphrim007)
Wojciech Wypior (@wojtek0806)

© 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_certificate_module.html