f5networks.f5_modules.bigip_device_trust – Управление отношениями доверия между BIG-IP
Примечание
Этот плагин является частью коллекции f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в книге задач укажите: f5networks.f5_modules.bigip_device_trust.
Новое в версии 1.0.0: модуля f5networks.f5_modules
Описание
- Управление отношениями доверия между системами BIG-IP. Устройства, после установления связи, не могут быть обновлены. Если обновление необходимо, то сначала необходимо удалить устройство из списка доверенных, а затем повторно добавить его.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| peer_hostname строка | Имя хоста, которое требуется ассоциировать с устройством. Это значение используется для удобного различения данного устройства в конфигурации BIG-IP. При установлении доверия к новому устройству, если этот параметр не указан, используется значение по умолчанию peer_server. | ||
| peer_password строка | Пароль от учетной записи API удаленного устройства, которому доверяют. Если это значение не указано, используется значение password, или переменная среды F5_PASSWORD. | ||
| peer_server строка / обязательно | Адрес удаленного устройства, к которому необходимо подключиться и установить доверие для синхронизации конфигурации. Обычно это адрес управления удаленного устройства, но может также быть адрес собственного IP. | ||
| peer_user строка | Имя пользователя API удаленного устройства, которому доверяют. Обратите внимание, что пользователь CLI не может быть использован, если у него нет учетной записи API. Если это значение не указано, используется значение user, или переменная среды F5_USER. | ||
| 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, удаляет устройства из списка доверенных. | |
| type строка |
| Определяет, является ли добавляемое устройство Peer или Subordinate. По умолчанию peer.Разница между ними заключается в снижении риска взлома. Подчинённое устройство не может подписать сертификат для другого устройства. В случае взлома устройства-авторитета в домене доверия, риск взлома минимизируется для любого подчинённого устройства. Рекомендуется назначать устройства подчинёнными для групп устройств с большим количеством устройств-членов, где риск взлома высок. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks можно найти на https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 изменяют только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация BIG-IP сохраняется на диске, убедитесь, что в вашей задаче есть хотя бы одна задача, которая использует модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Add trusts for all peer devices to Active device
bigip_device_trust:
peer_server: "{{ item.ansible_host }}"
peer_hostname: "{{ item.inventory_hostname }}"
peer_user: "{{ item.bigip_username }}"
peer_password: "{{ item.bigip_password }}"
provider:
server: lb.mydomain.com
user: admin
password: secret
loop: hostvars
when: inventory_hostname in groups['master']
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| peer_hostname строка | changed | Удаленный хост, используемый для идентификации доверенного устройства. Пример: test-bigip-02.localhost.localdomain |
| peer_server строка | changed | Удаленный IP-адрес доверенного устройства. Пример: 10.0.2.15 |
Авторы
- 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_device_trust_module.html
